win_domain - Обеспечивает существование домена Windows
Новое в версии 2.3.
Обзор
- Убедиться, что домен, указанный в
dns_domain_name, существует и доступен. - Если домен недоступен, он создается в новом лесу на целевом хосте Windows Server 2012R2+.
- Для внесения изменений в этот модуль может потребоваться последующее использование действия win_reboot.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| database_path (добавлено в 2.5) | Путь к каталогу на жёстком диске хоста Windows, где будет создана база данных домена. Если не задано, используется путь по умолчанию %SYSTEMROOT%\NTDS. | |
| dns_domain_name обязательно | Имя домена DNS, которое должно существовать и быть доступным или находиться на целевом хосте Windows. | |
| domain_netbios_name (добавлено в 2.6) | Имя домена NetBIOS. Если не задано, используется значение по умолчанию, равное первой части имени dns_domain_name до первой точки. | |
| safe_mode_password обязательно | Пароль безопасного режима для контроллера домена. | |
| sysvol_path (добавлено в 2.5) | Путь к каталогу на жёстком диске хоста Windows, где будет создан файл Sysvol. Если не задано, используется путь по умолчанию %SYSTEMROOT%\SYSVOL. |
Примеры
- name: Ensure the named domain is reachable from the target host; if not, create the domain in a new forest residing on the target host
win_domain:
dns_domain_name: ansible.vagrant
safe_mode_password: password123!
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| reboot_required булево | всегда | True, если были внесены изменения, требующие перезагрузки. Пример: True |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантированно будет обратной совместимостью.
Техническое обслуживание
Этот модуль помечен как основной, что означает, что он поддерживается командой Ansible Core Team. Дополнительная информация см. в разделе Техническое обслуживание и поддержка модулей.
Список других модулей, которые также поддерживаются командой Ansible Core Team, см. здесь.
Поддержка
Для получения дополнительной информации о поддержке этого модуля Red Hat, пожалуйста, обратитесь к этой статье базы знаний.
Автор
- Matt Davis (@nitzmahone)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/win_domain_module.html