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

Примечание

Этот плагин входит в состав коллекции ansible.windows (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install ansible.windows.

Для использования в плейбуке укажите: ansible.windows.win_feature.

Обзор
Параметры
См. также
Примеры
Возвращаемые значения

Обзор

Устанавливает или удаляет роли или функции 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 список / элементы=строка / обязательный		Имена ролей или функций для установки, как единой функции или в виде списка функций, разделенных запятыми. Для отображения всех доступных функций используйте команду PowerShell `Get-WindowsFeature`.
source строка		Укажите источник для установки функции. Не поддерживается в Windows 2008 R2 и будет проигнорировано. Может быть `{driveletter}:\sources\sxs` или `\\{IP}\share\sources\sxs`.
state строка	Варианты: отсутствует есть ←	Состояние функций или ролей в системе.

См. также

chocolatey.chocolatey.win_chocolatey: Официальная документация модуля chocolatey.chocolatey.win_chocolatey.
ansible.windows.win_package: Официальная документация модуля ansible.windows.win_package.

Примеры

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

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

- name: Install NET-Framework-Core from file
  ansible.windows.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
  ansible.windows.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
  ansible.windows.win_reboot:
  when: win_feature.reboot_required

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

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

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

Авторы

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.10/collections/ansible/windows/win_feature_module.html