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

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

Описание
Параметры
Примеры
Возвращаемые значения
Статус
Техническое обслуживание
- Автор

Описание

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
include_management_tools bool	Варианты: нет ← да	Добавляет соответствующие инструменты управления к указанной функции. Не поддерживается в Windows 2008 R2 и будет проигнорировано.
include_sub_features bool	Варианты: нет ← да	Добавляет все подфункции указанной функции.
name обязательный		Имена ролей или функций для установки, как одной функции, так и через запятую.
source (добавлено в 2.1)		Укажите источник для установки функции. Не поддерживается в Windows 2008 R2 и будет проигнорировано. Может быть `{driveletter}:\sources\sxs` или `\\{IP}\share\sources\sxs`.
state	Варианты: absent present ←	Состояние функций или ролей в системе.

Примеры

- 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: yes
    include_management_tools: yes
  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
	id целое число	всегда	Список идентификаторов статей базы знаний, относящихся к обновлению Пример: 44
	message список строк	всегда	Любые сообщения, возвращенные от подсистемы функций, которые возникли во время установки или удаления этой функции
	reboot_required булево	всегда	True, если целевой сервер требует перезагрузки в результате установки или удаления этой функции Пример: True
	restart_needed булево	всегда	УСТЕРЕЖЕН в Ansible 2.4 (обратитесь к `reboot_required` вместо этого). True, если целевой сервер требует перезагрузки в результате установки или удаления этой функции Пример: True
	skip_reason строка	всегда	Причина пропуска установки или удаления функции Пример: NotSkipped
	success булево	всегда	Если установка или удаление функции выполнилось успешно Пример: True
reboot_required булево		успех	True, если целевой сервер требует перезагрузки для завершения обновлений (дальнейшие обновления не могут быть установлены до перезагрузки) Пример: True
restart_needed булево		успех	УСТЕРЕЖЕН в Ansible 2.4 (обратитесь к `reboot_required` вместо этого). True, если целевой сервер требует перезагрузки для завершения обновлений (дальнейшие обновления не могут быть установлены до перезагрузки) Пример: True

Статус

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

Техническое обслуживание

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

Список других модулей, которые также поддерживаются сообществом Ansible, см. здесь.

Автор

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.6/modules/win_feature_module.html