win_domain_controller - Управление состоянием контроллера домена/сервера-члена для хоста Windows
Новая версия с 2.3.
Обзор
- Обеспечение конфигурации хоста Windows Server 2012+ как контроллера домена или понижение до сервера-члена. Для внесения изменений в этом модуле может потребоваться последующее использование действия win_reboot.
Параметры
| параметр | обязательно | по умолчанию | значения | примечания |
|---|---|---|---|---|
| dns_domain_name | нет | когда state равно domain_controller, имя домена DNS, для которого целевой хост Windows должен быть контроллером домена | ||
| domain_admin_password | да | пароль для указанного domain_admin_user
| ||
| domain_admin_user | да | имя пользователя доменного администратора для целевого домена (необходимо для повышения или понижения статуса контроллера домена) | ||
| local_admin_password | нет | пароль, который будет назначен локальному пользователю Administrator (необходим, когда state равно member_server) | ||
| safe_mode_password | нет | пароль безопасного режима для контроллера домена (необходим, когда state равно domain_controller) | ||
| state | нет |
| указывает, должен ли целевой хост быть контроллером домена или сервером-членом |
Примеры
# ensure a server is a domain controller
- hosts: winclient
gather_facts: no
tasks:
- win_domain_controller:
dns_domain_name: ansible.vagrant
domain_admin_user: testguy@ansible.vagrant
domain_admin_password: password123!
safe_mode_password: password123!
state: domain_controller
log_path: c:\ansible_win_domain_controller.txt
# ensure a server is not a domain controller
# note that without an action wrapper, in the case where a DC is demoted,
# the task will fail with a 401 Unauthorized, because the domain credential
# becomes invalid to fetch the final output over WinRM. This requires win_async
# with credential switching (or other clever credential-switching
# mechanism to get the output and trigger the required reboot)
- hosts: winclient
gather_facts: no
tasks:
- win_domain_controller:
domain_admin_user: testguy@ansible.vagrant
domain_admin_password: password123!
local_admin_password: password123!
state: member_server
log_path: c:\ansible_win_domain_controller.txt
Возвращаемые значения
Общие значения, возвращаемые модулем, описаны здесь Возвращаемые значения, следующие поля уникальны для данного модуля:
| имя | описание | возвращается | тип | пример |
|---|---|---|---|---|
| reboot_required | True, если внесены изменения, требующие перезагрузки. | всегда | булево | True |
Статус
Этот модуль помечен как предварительная версия, что означает, что он не гарантирует обратную совместимость.
Информация о техническом обслуживании
Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в этом knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>
Для получения помощи в разработке модулей, если у вас есть желание, ознакомьтесь со следующими документами: Информация о сообществе и внесение вклада, Тестирование 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_domain_controller_module.html
