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

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

Описание

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

См. также

win_chocolatey – Управление пакетами с помощью chocolatey: Официальная документация по модулю win_chocolatey.
win_package – Установка/удаление устанавливаемого пакета: Официальная документация по модулю win_package.

Примеры

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

Статус

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