ansible.windows.win_optional_feature – Управление дополнительными функциями Windows

Примечание

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

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

Для использования в книге задач, укажите: ansible.windows.win_optional_feature.

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

Обзор

Установка или удаление дополнительных функций Windows на системах Windows, не являющихся серверными.
Этот модуль использует командлеты Enable-WindowsOptionalFeature и Disable-WindowsOptionalFeature.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
include_parent boolean	Варианты: no ← yes	Включать родительскую функцию и зависимости родительской функции.
name list / elements=string / required		Имя(а) функции для установки. Относится к `FeatureName` в командлете Powershell. Для вывода списка всех доступных функций используйте команду PowerShell `Get-WindowsOptionalFeature`.
source string		Укажите источник для установки функции. Может быть `{driveletter}:\sources\sxs` или `\\{IP}\share\sources\sxs`.
state string	Варианты: absent present ←	Определить, требуется ли функция присутствовать или отсутствовать в системе.

См. также

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

Примеры

- name: Install .Net 3.5
  ansible.windows.win_optional_feature:
    name: NetFx3
    state: present

- name: Install .Net 3.5 from source
  ansible.windows.win_optional_feature:
    name: NetFx3
    source: \\share01\win10\sources\sxs
    state: present

- name: Install Microsoft Subsystem for Linux
  ansible.windows.win_optional_feature:
    name: Microsoft-Windows-Subsystem-Linux
    state: present
  register: wsl_status

- name: Reboot if installing Linux Subsytem as feature requires it
  ansible.windows.win_reboot:
  when: wsl_status.reboot_required

- name: Install multiple features in one task
  ansible.windows.win_optional_feature:
    name:
    - NetFx3
    - Microsoft-Windows-Subsystem-Linux
    state: present

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

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

Ключ	Возвращаемое значение	Описание
reboot_required boolean	success	True, когда целевой сервер требует перезагрузки для завершения обновлений Пример: True

Авторы

Carson Anderson (@rcanderson23)

© 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_optional_feature_module.html