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

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

Обзор
Параметры
Примеры
Возвращаемые значения
Статус

Обзор

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
include_management_tools boolean	Варианты: нет ← да	Добавляет соответствующие инструменты управления к указанной функции. Не поддерживается в Windows 2008 R2 и будет проигнорировано.
include_sub_features boolean	Варианты: нет ← да	Добавляет все подфункции указанной функции.
name список / обязательно		Имена ролей или функций для установки в виде одной функции или списка функций, разделенных запятыми.
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: 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 boolean	всегда	True, когда целевой сервер требует перезагрузки в результате установки или удаления этой функции. Пример: True
	restart_needed boolean	всегда	УСТЕРЕЖЕН в Ansible 2.4 (см. вместо этого `reboot_required`). True, когда целевой сервер требует перезагрузки в результате установки или удаления этой функции. Пример: True
	skip_reason строка	всегда	Причина пропуска установки или удаления функции. Пример: NotSkipped
	success boolean	всегда	Установка или удаление функции прошло успешно Пример: True
reboot_required boolean		успех	True, когда целевой сервер требует перезагрузки для завершения обновлений (никакие дальнейшие обновления не могут быть установлены до перезагрузки). Пример: True
restart_needed boolean		успех	УСТЕРЕЖЕН в Ansible 2.4 (см. вместо этого `reboot_required`). True, когда целевой сервер требует перезагрузки для завершения обновлений (никакие дальнейшие обновления не могут быть установлены до перезагрузки). Пример: True

Статус

Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
Этот модуль поддерживается сообществом 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.7/modules/win_feature_module.html