win_feature - Установка и удаление функций Windows на сервере Windows
Новое в версии 1.7.
Обзор
- Устанавливает или удаляет роли или функции Windows на сервере Windows. Этот модуль использует командлеты Add/Remove-WindowsFeature в Windows 2008 и Install/Uninstall-WindowsFeature в Windows 2012, которые недоступны на клиентских ОС.
Параметры
| Параметр | Обязательно | По умолчанию | Варианты | Комментарии |
|---|---|---|---|---|
| include_management_tools | нет |
| Добавляет соответствующие инструменты управления к указанной функции. Не поддерживается в Windows 2008. Если параметр присутствует при использовании Windows 2008, он будет проигнорирован. | |
| include_sub_features | нет |
| Добавляет все подфункции указанной функции | |
| name | да | Наименования ролей или функций для установки как одной функции или через запятую | ||
| restart | нет |
| Автоматически перезапускает компьютер после завершения установки, если это требуется установленным ролям или функциям. УСТАРЕЛО в Ansible 2.4, так как неконтролируемые перезагрузки вызывают много проблем в Ansible. Проверьте значение reboot_required из этого модуля, чтобы определить, необходим ли перезапуск, и если да, используйте действие win_reboot для его выполнения. | |
| source (добавлен в 2.1)
| нет |
| Укажите источник для установки функции. Не поддерживается в Windows 2008. Если параметр присутствует при использовании Windows 2008, он будет проигнорирован. | |
| state | нет | present |
| Состояние функций или ролей в системе |
Примеры
- 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: True
include_management_tools: True
register: win_feature
- name: reboot if installing Web-Server feature requires it
win_reboot:
when: win_feature.reboot_required
Значения возврата
Общие значения возврата описаны здесь Значения возврата, следующие поля уникальны для этого модуля:
| Имя | Описание | Возвращается | Тип | Пример | ||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| exitcode | Строковое представление кода завершения из команды установки/удаления функции | всегда | строка | Успех | ||||||||||||||||||||||||||||||||||||||||
| feature_result | Список функций, которые были установлены или удалены | успешно | сложный | None | ||||||||||||||||||||||||||||||||||||||||
| contains: |
| |||||||||||||||||||||||||||||||||||||||||||
| reboot_required | True, если целевой сервер требует перезагрузки для завершения обновлений (дальнейшие обновления не могут быть установлены до перезагрузки) | успешно | логическое значение | True | ||||||||||||||||||||||||||||||||||||||||
| restart_needed | УСТАРЕЛО в Ansible 2.4 (см. вместо этого reboot_required). True, если целевой сервер требует перезагрузки для завершения обновлений (дальнейшие обновления не могут быть установлены до перезагрузки) | успешно | логическое значение | True | ||||||||||||||||||||||||||||||||||||||||
Статус
Этот модуль помечен как предварительный, что означает, что он не гарантирует обратную совместимость интерфейса.
Для получения помощи в разработке модулей, если у вас есть желание, прочтите Информацию о сообществе и содействие, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/win_feature_module.html
