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 строка | Укажите источник для установки функции. Не поддерживается в 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 целое число | всегда | Список идентификаторов статей базы знаний, которые относятся к обновлению. Пример: 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.9/modules/win_feature_module.html
