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, который вы устанавливаете вместе с контроллером домена. Действительно только для DNS, интегрированного в Active Directory. Значение по умолчанию вычисляется автоматически на основе среды. |
| 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/ansible/windows/win_domain_module.html
