win_feature - Установка и удаление функций Windows на Windows Server

Новая версия 1.7.

Описание
Параметры
Примеры
Возвращаемые значения
Состояние
- Автор

Описание

Устанавливает или удаляет роли или функции Windows на Windows Server. Этот модуль использует командлеты Add/Remove-WindowsFeature в Windows 2008 R2 и Install/Uninstall-WindowsFeature в Windows 2012, которые недоступны на клиентских операционных системах.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
include_management_tools	Варианты: нет ← да	Добавляет соответствующие инструменты управления к указанной функции. Не поддерживается в Windows 2008 R2 и будет проигнорировано.
include_sub_features	Варианты: нет ← да	Добавляет все подфункции указанной функции.
name обязательно		Имена ролей или функций для установки как отдельной функции или через запятую.
restart	Варианты: нет ← да	Автоматически перезапускает компьютер после завершения установки, если перезапуск требуется установленными ролями или функциями. УСТЕРЕЛЕНО в Ansible 2.4, так как неконтролируемые перезагрузки вызывают много проблем в Ansible. Проверьте значение `reboot_required` в этом модуле, чтобы определить, необходим ли перезапуск, и если да, используйте действие win_reboot для его выполнения.
source (добавлен в 2.1)		Укажите источник для установки функции. Не поддерживается в Windows 2008 R2 и будет проигнорировано. Может быть `{driveletter}:\sources\sxs` или `\\{IP}\share\sources\sxs`.
state	Варианты: наличие ← отсутствие	Состояние функций или ролей в системе.

Примеры

- name: Install IIS (Web-Server only)
  win_feature:
    name: Web-Server
    state: present

- name: Install IIS (Web-Server and Web-Common-Http)
  win_feature:
    name:
    - Web-Server
    - Web-Common-Http
    state: present

- name: Install NET-Framework-Core from file
  win_feature:
    name: NET-Framework-Core
    source: C:\Temp\iso\sources\sxs
    state: present

- name: Install IIS Web-Server with sub features and management tools
  win_feature:
    name: Web-Server
    state: present
    include_sub_features: True
    include_management_tools: True
  register: win_feature

- name: reboot if installing Web-Server feature requires it
  win_reboot:
  when: win_feature.reboot_required

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ		Возвращаемое значение	Описание
exitcode строка		всегда	Строковое представление кода возврата из команды установки/удаления функции Пример: Успех
feature_result сложное		успех	Список функций, которые были установлены или удалены
	display_name строка	всегда	Имя отображения функции Пример: Клиент Telnet
	restart_needed логическое	всегда	УСТЕРЕЛЕНО в Ansible 2.4 (см. `reboot_required` вместо этого). Истина, когда целевой сервер требует перезагрузки в результате установки или удаления этой функции Пример: Истина
	success логическое	всегда	Если установка или удаление функции прошли успешно Пример: Истина
	skip_reason строка	всегда	Причина пропуска установки или удаления функции Пример: NotSkipped
	message список строк	всегда	Любые сообщения, возвращаемые подсистемой функций, возникшие во время установки или удаления этой функции
	id целое число	всегда	Список идентификаторов статей базы знаний, относящихся к обновлению Пример: 44
	reboot_required логическое	всегда	Истина, если целевой сервер требует перезагрузки в результате установки или удаления этой функции Пример: Истина
reboot_required логическое		успех	Истина, если целевой сервер требует перезагрузки для завершения обновлений (никакие дальнейшие обновления не могут быть установлены до перезагрузки) Пример: Истина
restart_needed логическое		успех	УСТЕРЕЛЕНО в Ansible 2.4 (см. `reboot_required` вместо этого). Истина, если целевой сервер требует перезагрузки для завершения обновлений (никакие дальнейшие обновления не могут быть установлены до перезагрузки) Пример: Истина

Состояние

Этот модуль помечен как превью, что означает, что его интерфейс не гарантированно будет совместим с предыдущими версиями.

Автор

Paul Durivage (@angstwad)
Trond Hindenes (@trondhindenes)

Подсказка

Если вы заметите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.5/modules/win_feature_module.html