ansible.windows.win_domain – Обеспечивает существование домена Windows
Примечание
Этот плагин является частью коллекции ansible.windows (версия 1.3.0).
Для его установки используйте: ansible-galaxy collection install ansible.windows
Для использования в книге задач укажите: ansible.windows.win_domain
Описание
- Обеспечить существование и доступность домена, указанного в
dns_domain_name. - Если домен недоступен, он создается в новом лесу на целевом сервере Windows Server 2012R2+.
- Для внесенных изменений возможно потребуется дальнейшее использование действия ansible.windows.win_reboot.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| create_dns_delegation
boolean
|
|
Создать делегирование DNS, которое ссылается на новый сервер DNS, установленный вместе с контроллером домена.
Применимо только для интегрированного в Active Directory DNS.
Значение по умолчанию вычисляется автоматически в зависимости от среды. |
| database_path
path
|
Путь к каталогу на жестком диске хоста Windows, где будет создана база данных домена.
Если не задано, используется путь по умолчанию %SYSTEMROOT%\NTDS. |
|
| dns_domain_name
string / required
|
Имя домена DNS, которое должно существовать и быть доступным или находиться на целевом хосте Windows. |
|
| domain_mode
string
|
|
Указывает функциональный уровень домена первого домена при создании нового леса.
Функциональный уровень домена не может быть ниже, чем функциональный уровень леса, но может быть выше.
Значение по умолчанию вычисляется и устанавливается автоматически. |
| domain_netbios_name
string
|
Имя NetBIOS для корневого домена в новом лесу.
Для того, чтобы имена NetBIOS были допустимыми для использования с этим параметром, они должны быть именами из одной метки длиной не более 15 символов, в противном случае произойдет ошибка.
Если этот параметр не задан, значение по умолчанию вычисляется автоматически из значения параметра domain_name. |
|
| forest_mode
string
|
|
Указывает функциональный уровень леса для нового леса.
Значение по умолчанию для функционального уровня леса в Windows Server обычно совпадает с используемой версией. |
| install_dns
boolean
|
|
Устанавливать ли службу DNS при создании контроллера домена. |
| log_path
path
|
Указывает полный, не UNC, путь к каталогу на локальном компьютере, где будет записан лог-файл для этой операции.
Если не задано, используется путь по умолчанию %SYSTEMROOT%\NTDS. |
|
| safe_mode_password
string / required
|
Пароль безопасного режима для контроллера домена. |
|
| sysvol_path
path
|
Путь к каталогу на жестком диске хоста Windows, где будет создан файл Sysvol.
Если не задано, используется путь по умолчанию %SYSTEMROOT%\SYSVOL. |
См. также
См. также
- ansible.windows.win_domain_controller
-
Официальная документация модуля ansible.windows.win_domain_controller.
- community.windows.win_domain_computer
-
Официальная документация модуля community.windows.win_domain_computer.
- community.windows.win_domain_group
-
Официальная документация модуля community.windows.win_domain_group.
- ansible.windows.win_domain_membership
-
Официальная документация модуля ansible.windows.win_domain_membership.
- community.windows.win_domain_user
-
Официальная документация модуля community.windows.win_domain_user.
Примеры
- name: Create new domain in a new forest on the target host
ansible.windows.win_domain:
dns_domain_name: ansible.vagrant
safe_mode_password: password123!
- name: Create new Windows domain in a new forest with specific parameters
ansible.windows.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
|
всегда | True, если были внесены изменения, требующие перезагрузки. Пример:
True |
Авторы
- Matt Davis (@nitzmahone)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/windows/win_domain_module.html
