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	Варианты: нет ← да	Включить родительскую функцию и зависимости родительской функции.
name список / элементы=строка / обязательный		Имя(а) функции для установки. Относится к `FeatureName` в командлете PowerShell. Для перечисления всех доступных функций используйте команду PowerShell `Get-WindowsOptionalFeature`.
source строка		Укажите источник для установки функции. Может быть `{driveletter}:\sources\sxs` или `\\{IP}\share\sources\sxs`.
state строка	Варианты: отсутствует присутствует ←	Установить функцию как отсутствующую или присутствующую в системе.

См. также

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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/windows/win_optional_feature_module.html