win_dsc - Вызов конфигурации PowerShell DSC
Новая версия с 2.4.
Описание
- Вызывает конфигурацию PowerShell DSC. Требуется версия PowerShell 5 (или более поздняя, февральская версия или новее).
- Большинство параметров данного модуля динамические и будут варьироваться в зависимости от ресурса DSC.
Параметры
| Параметр | Обязательный | Значение по умолчанию | Варианты | Комментарии |
|---|---|---|---|---|
| module_version | нет | последняя | Можно использовать для настройки точной версии вызываемого ресурса dsc. Полезно, если на целевом узле установлено несколько версий модуля, содержащего ресурс DSC. Если не указано, модуль будет следовать стандартной конвенции PowerShell и использовать наивысшую доступную версию. | |
| resource_name | да | Используемый ресурс DSC. Должен быть доступен PowerShell с использованием стандартных путей. |
Примеры
# Playbook example
- name: Extract zip file
win_dsc:
resource_name: archive
ensure: Present
path: "C:\\Temp\\zipfile.zip"
destination: "C:\\Temp\\Temp2"
- name: Invoke DSC with check mode
win_dsc:
resource_name: windowsfeature
name: telnet-client
Значения возврата
Общие значения возврата описаны здесь Значения возврата, следующие поля уникальны для данного модуля:
| Имя | Описание | Возвращается | Тип | Пример | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| attributes | Атрибуты/параметры, переданные ресурсу DSC в виде пар ключ/значение | всегда | сложное | None | |||||||||||||||
| содержит: |
| ||||||||||||||||||
| dsc_attributes | Атрибуты/параметры, возвращенные движком DSC в формате словаря | всегда | сложное | ||||||||||||||||
| содержит: |
| ||||||||||||||||||
| message | любое сообщение об ошибке при вызове ресурса DSC | ошибка | строка | Найдено несколько модулей DSC с именем ресурса xyz | |||||||||||||||
| module_version | Версия используемого ресурса/модуля dsc. | успех | строка | 1.0.1 | |||||||||||||||
| reboot_required | Флаг, возвращенный движком DSC, указывающий, требуется ли перезагрузка машины для вступления изменений, вызванных модулем, в силу | всегда | булево | True | |||||||||||||||
| resource_name | Имя вызванного ресурса | всегда | строка | windowsfeature | |||||||||||||||
Статус
Данный модуль помечен как экспериментальный, что означает, что он не гарантирует обратную совместимость интерфейса.
Для получения помощи в разработке модулей, если вы заинтересованы, прочитайте Информация о сообществе и внесение вклада, Тестирование 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_dsc_module.html
