win_domain – Обеспечивает существование домена Windows
Новая версия с 2.3.
Описание
- Убедиться, что домен, указанный по
dns_domain_name, существует и доступен. - Если домен недоступен, домен создается в новом лесу на целевом хосте Windows Server 2012R2+.
- Для внесения изменений в этот модуль может потребоваться последующее использование действия win_reboot.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| create_dns_delegation boolean добавлено в 2.8 |
| Указывает, нужно ли создавать делегирование DNS, которое ссылается на новый DNS-сервер, установленный вместе с контроллером домена. Действительно только для интегрированного в Active Directory DNS. Значение по умолчанию вычисляется автоматически на основе среды. |
| database_path путь добавлено в 2.5 | Путь к каталогу на жёстком диске хоста Windows, где будет создана база данных домена. Если не задано, по умолчанию используется путь %SYSTEMROOT%\NTDS. | |
| dns_domain_name строка / обязательно | DNS-имя домена, которое должно существовать и быть доступным или находиться на целевом хосте Windows. | |
| domain_mode строка добавлено в 2.8 |
| Указывает функциональный уровень домена первого домена при создании нового леса. Функциональный уровень домена не может быть ниже функционального уровня леса, но может быть выше. Значение по умолчанию вычисляется и устанавливается автоматически. |
| domain_netbios_name строка добавлено в 2.6 | Имя NetBIOS для корневого домена в новом лесу. Для того, чтобы имена NetBIOS были действительны для использования с этим параметром, они должны быть именами из одного раздела длиной 15 символов или меньше, в противном случае это приведет к ошибке. Если этот параметр не задан, по умолчанию он вычисляется автоматически из значения параметра domain_name. | |
| forest_mode строка добавлено в 2.8 |
| Указывает функциональный уровень леса для нового леса. По умолчанию функциональный уровень леса в Windows Server обычно совпадает с версией, которую вы используете. |
| safe_mode_password строка / обязательно | Пароль в безопасном режиме для контроллера домена. | |
| sysvol_path путь добавлено в 2.5 | Путь к каталогу на жёстком диске хоста Windows, где будет создан файл Sysvol. Если не задано, по умолчанию используется путь %SYSTEMROOT%\SYSVOL. |
См. также
См. также
- win_domain_controller – Управление состоянием контроллера домена/сервера-члена для хоста Windows
- Официальная документация по модулю win_domain_controller.
- win_domain_computer – Управление компьютерами в Active Directory
- Официальная документация по модулю win_domain_computer.
- win_domain_group – Создание, изменение или удаление групп домена
- Официальная документация по модулю win_domain_group.
- win_domain_membership – Управление членством в домене/рабочей группе для хоста Windows
- Официальная документация по модулю win_domain_membership.
- win_domain_user – Управление учетными записями пользователей Windows Active Directory
- Официальная документация по модулю win_domain_user.
Примеры
- name: Create new domain in a new forest on the target host
win_domain:
dns_domain_name: ansible.vagrant
safe_mode_password: password123!
- name: Create new Windows domain in a new forest with specific parameters
win_domain:
create_dns_delegation: no
database_path: C:\Windows\NTDS
dns_domain_name: ansible.vagrant
domain_mode: Win2012R2
domain_netbios_name: ANSIBLE
forest_mode: Win2012R2
safe_mode_password: password123!
sysvol_path: C:\Windows\SYSVOL
register: domain_install
Возвращаемые значения
Общие возвращаемые значения описаны в этом разделе, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| reboot_required boolean | всегда | Истина, если были внесены изменения, требующие перезагрузки. Пример: Истина |
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается командой Ansible Core. [core]
Поддержка Red Hat
Дополнительную информацию о поддержке данного модуля компанией Red Hat можно найти в этой статье базы знаний 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.8/modules/win_domain_module.html
