Модуль ansible.windows.win_capability — управление возможностями Windows

Примечание

Этот модуль входит в коллекцию ansible.windows (версия 3.6.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install ansible.windows. Дополнительные требования для использования этого модуля см. в разделе Требования.

Чтобы использовать его в плейбуке, укажите: ansible.windows.win_capability.

Добавлено в ansible.windows 3.6.0

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

Краткое описание

Добавляет возможности Windows на целевую систему Windows или удаляет их.
Возможность Windows — это необязательная функция, которую можно добавить в Windows.

Требования

Следующие требования необходимы на узле, на котором выполняется этот модуль.

Windows Server 2019/Windows 10 сборки 1809 или новее для PowerShell 5.1
Windows Server 2022/Windows 10 сборки 1903 или новее для PowerShell 7.x

Параметры

Параметр	Комментарии
disable_windows_update boolean	Если `true`, запрещает DISM обращаться к Центру обновления Windows за исходными файлами. Варианты: `false` ← (по умолчанию) `true`
log_level integer	Задает максимальный уровень вывода для журнала DISM. `0` регистрируются только ошибки `1` регистрируются ошибки и предупреждения `2` регистрируются ошибки, предупреждения и информационные сообщения `3` регистрируются все перечисленные выше события, а также отладочная информация; допустимо только в Windows 11 или Server 2025 и новее. Этот журнал ведется самим DISM; допустимые значения могут различаться в разных версиях Windows.
log_path path	Задает полный путь и имя файла для записи журнала. Если параметр не указан, журнал записывается в расположение файла журнала DISM по умолчанию: `%WINDIR%\Logs\Dism\dism.log`.
name list / elements=string / обязательный	Список имен возможностей для добавления или удаления. Поддерживаются шаблоны с подстановочными знаками: `?` для сопоставления с одним символом и `*` для сопоставления с несколькими символами.
source list / elements=string	Использует указанные расположения в качестве источников возможностей.
state string	Должна ли возможность присутствовать или отсутствовать. Если `present`, возможность будет добавлена, если она еще не присутствует. Если `absent`, возможность будет удалена, если она присутствует. Варианты: `"absent"` `"present"` ← (по умолчанию)

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Модуль может работать в режиме check_mode и возвращать прогнозируемый статус изменений, не изменяя целевую систему; если режим не поддерживается, действие будет пропущено.
diff_mode	Поддержка: нет	В режиме diff возвращает сведения об изменениях (или о возможных изменениях в режиме check_mode).
platform	Платформа: windows	Целевая ОС или семейства ОС, с которыми может работать модуль.

Примечания

Примечание

Для добавления возможности целевой пользователь должен иметь право пользователя SeBatchLogonRight. Для управления этим правом пользователя используйте ansible.windows.win_user_right.
Этот модуль не поддерживает Server 2016.

См. также

ansible.windows.win_capability_info: Получает сведения о возможностях Windows.

Примеры

- name: Install OpenSSH Client capability using short name
  ansible.windows.win_capability:
    name: OpenSSH.Client
    state: present

- name: Install OpenSSH Client capability using full name
  ansible.windows.win_capability:
    name: OpenSSH.Client~~~~0.0.1.0
    state: present

- name: Install both OpenSSH Client and OpenSSH Server capabilities using list
  ansible.windows.win_capability:
    name:
      - OpenSSH.Client
      - OpenSSH.Server
    state: present

- name: Install both OpenSSH Client and OpenSSH Server capabilities using wildcard pattern
  ansible.windows.win_capability:
    name: OpenSSH.*
    state: present

- name: Remove OpenSSH Client capability
  ansible.windows.win_capability:
    name: OpenSSH.Client
    state: absent

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

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

Ключ	Описание
capabilities list / elements=string	Список добавленных или удаленных возможностей. Возвращается: всегда
reboot_required boolean	Требуется ли перезагрузка для завершения операции. Возвращается: всегда

Авторы

Jordan Borean (@jborean93)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/ansible/windows/win_capability_module.html