ansible.windows.win_domain_controller – Управление состоянием контроллера домена/сервера-члена для хоста Windows

Примечание

Этот плагин входит в сборку ansible.windows (версия 1.3.0).

Для его установки используйте: ansible-galaxy collection install ansible.windows.

Для использования в книге задач укажите: ansible.windows.win_domain_controller.

Описание
Параметры
См. также
Примеры
Возвращаемые значения

Описание

Обеспечение настройки хоста Windows Server 2012+ в качестве контроллера домена или понижение до сервера-члена.
Этот модуль может потребовать последующего использования действия ansible.windows.win_reboot, если были внесены изменения.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
database_path путь		Путь к каталогу на жестком диске хоста Windows, где будет создана база данных домена. Если не задано, используется путь по умолчанию `%SYSTEMROOT%\NTDS`.
dns_domain_name строка		Когда `state` равно `domain_controller`, имя домена DNS, для которого целевой хост Windows должен быть контроллером домена.
domain_admin_password строка / обязательно		Пароль для указанного `domain_admin_user`.
domain_admin_user строка / обязательно		Имя пользователя администратора домена для целевого домена (необходимо для повышения или понижения статуса контроллера домена).
domain_log_path путь		Указывает полный, не UNC, путь к каталогу на локальном компьютере, который будет содержать журналы домена.
install_dns логическое значение	Варианты: no yes	Устанавливать ли службу DNS при создании контроллера домена. Если не указано, параметр `-InstallDns` не передается в команду `Install-ADDSDomainController`, см. https://docs.microsoft.com/en-us/powershell/module/addsdeployment/install-addsdomaincontroller.
install_media_path путь		Путь к каталогу на жестком диске хоста Windows, где будут использованы данные для установки с носителя `IFC`. См. руководство по установке с IFM для получения дополнительной информации.
local_admin_password строка		Пароль, который будет назначен локальному пользователю `Administrator` (требуется, когда `state` равен `member_server`).
log_path строка		Путь к журналу отладки при выполнении модуля. Этот параметр устарел и не следует использовать. Он будет удален в следующей основной версии после `2022-07-01`. Он не относится к параметру `-LogPath` командлета установки контроллера.
read_only логическое значение	Варианты: no ← yes	Устанавливать ли контроллер домена как только что читаемую реплику для существующего домена.
safe_mode_password строка		Пароль режима восстановления для контроллера домена (требуется, когда `state` равен `domain_controller`).
site_name строка		Указывает имя существующего сайта, где можно разместить новый контроллер домена. Этот параметр необходим, когда read_only равен `yes`.
state строка / обязательно	Варианты: контроллер_домена сервер_член	Должен ли целевой хост быть контроллером домена или сервером-членом.
sysvol_path путь		Путь к каталогу на жестком диске хоста Windows, где будет создан каталог Sysvol. Если не задано, используется путь по умолчанию `%SYSTEMROOT%\SYSVOL`.

См. также

ansible.windows.win_domain: Официальная документация по модулю ansible.windows.win_domain.
ansible.windows.win_domain_computer: Официальная документация по модулю ansible.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: Ensure a server is a domain controller
  ansible.windows.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

# 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)
- name: Ensure a server is not a domain controller
  ansible.windows.win_domain_controller:
    domain_admin_user: testguy@ansible.vagrant
    domain_admin_password: password123!
    local_admin_password: password123!
    state: member_server

- name: Promote server as a read only domain controller
  ansible.windows.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
    read_only: yes
    site_name: London

- name: Promote server with custom paths
  ansible.windows.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
    sysvol_path: D:\SYSVOL
    database_path: D:\NTDS
    domain_log_path: D:\NTDS
  register: dc_promotion

- name: Reboot after promotion
  ansible.windows.win_reboot:
  when: dc_promotion.reboot_required

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ	Возвращаемое значение	Описание
reboot_required логическое значение	всегда	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_controller_module.html