Модуль microsoft.ad.domain_controller — управление состоянием контроллера домена/сервера-члена на узле Windows

Примечание

Этот модуль входит в коллекцию microsoft.ad (версия 1.10.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

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

Чтобы использовать её в плейбуке, укажите: microsoft.ad.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 логическое значение	Устанавливать ли службу DNS при создании контроллера домена. Если параметр не указан, параметр `-InstallDns` не передаётся команде `Install-ADDSDomainController`; см. Install-ADDSDomainController. Варианты: `false` `true`
install_media_path путь	Путь к каталогу на фиксированном диске узла Windows, где будут использоваться данные `IFC` для установки с носителя. Дополнительные сведения см. в руководстве по установке с помощью IFM.
local_admin_password строка	Пароль, назначаемый локальному пользователю `Administrator` (обязателен при state=member_server).
read_only логическое значение	Устанавливать ли контроллер домена как контроллер только для чтения для существующего домена. Варианты: `false` ← (по умолчанию) `true`
reboot логическое значение	Если `true`, узел будет перезагружен, если модулю потребуется перезагрузка. Если `false`, узел не будет перезагружен, даже если перезагрузка необходима; вместо этого возвращаемому значению reboot_required присваивается `true`. Этот параметр нельзя использовать в асинхронном режиме. Варианты: `false` ← (по умолчанию) `true`
reboot_timeout целое число добавлено в microsoft.ad 1.7.0	Максимальное время в секундах ожидания, пока компьютер снова станет доступен после перезагрузки и ответит на тестовую команду. Время ожидания отдельно отсчитывается для проверки перезагрузки и успешного выполнения тестовой команды, поэтому общее время ожидания может вдвое превышать это значение. По умолчанию: `600`
replication_source_dc строка добавлено в microsoft.ad 1.8.0	Указывает имя существующего контроллера домена в лесу, который будет использоваться в качестве источника репликации для нового контроллера домена.
safe_mode_password строка	Пароль для безопасного режима контроллера домена (обязателен при state=domain_controller).
site_name строка	Указывает имя существующего сайта, на котором можно разместить новый контроллер домена. Этот параметр обязателен при read_only=true.
state строка / обязательный	Должен ли целевой узел быть контроллером домена или сервером-членом. Варианты: `"domain_controller"` `"member_server"`
sysvol_path путь	Путь к каталогу на фиксированном диске узла Windows, где будет создана папка Sysvol. Если не задано, используется путь по умолчанию `%SYSTEMROOT%\SYSVOL`.

Атрибуты

Атрибут	Поддержка	Описание
action	Поддержка: полная	Указывает, что этому модулю соответствует плагин действия, поэтому некоторые части параметров могут выполняться на управляющем узле.
async	Поддержка: частичная Поддерживается во всех сценариях, кроме случаев с reboot=True.	Поддерживает использование с ключевым словом `async`.
bypass_host_loop	Поддержка: отсутствует	Принудительно запускает «глобальную» задачу, выполняемую не для каждого узла. При этом пропускаются шаблонизация для каждого узла, а также учитываемые отдельно для каждого узла параметры serial, throttle и другие настройки циклов. Условные выражения работают так, как если бы использовался `run_once`; применяются переменные первого доступного узла. Это действие не будет нормально работать вне стратегий lockstep.
check_mode	Поддержка: полная	Модуль может работать в режиме check_mode и возвращать прогноз изменения состояния без изменения целевого узла; если режим не поддерживается, действие будет пропущено.
diff_mode	Поддержка: отсутствует	В режиме diff возвращает сведения об изменениях (или о возможных изменениях в режиме check_mode).
platform	Платформа: windows	Целевые ОС и семейства ОС, с которыми можно работать.

Примечания

Примечание

Настоятельно рекомендуется установить reboot=true, чтобы Ansible управлял этапом перезагрузки узла: действия этого модуля переводят узел в состояние, при котором Ansible может не удастся подключиться к нему в следующей задаче без перезагрузки.
Этот модуль необходимо запускать на целевом узле Windows.
При использовании reboot=true может произойти несколько перезагрузок, если узлу требовалась перезагрузка до повышения домена. Также убедитесь, что в задаче используется полное имя модуля или что в ключевое слово collections включена эта коллекция.

См. также

microsoft.ad.computer: Управление объектами компьютеров Active Directory.
microsoft.ad.domain: Обеспечивает наличие домена Windows.
microsoft.ad.domain_child: Управление дочерними доменами в существующем лесу Active Directory.
microsoft.ad.group: Управление объектами групп Active Directory.
microsoft.ad.membership: Управление членством узла Windows в домене или рабочей группе.
microsoft.ad.user: Управление пользователями Active Directory.
Руководство по миграции: Этот модуль заменяет ansible.windows.win_domain_controller. Подробности см. в руководстве по миграции.
ansible.windows.win_domain_controller: Официальная документация по модулю ansible.windows.win_domain_controller.

Примеры

- name: Ensure a server is a domain controller
  microsoft.ad.domain_controller:
    dns_domain_name: ansible.vagrant
    domain_admin_user: testguy@ansible.vagrant
    domain_admin_password: password123!
    safe_mode_password: password123!
    state: domain_controller
    reboot: true

- name: Ensure a server is not a domain controller
  microsoft.ad.domain_controller:
    domain_admin_user: testguy@ansible.vagrant
    domain_admin_password: password123!
    local_admin_password: password123!
    state: member_server
    reboot: true

- name: Promote server as a read only domain controller
  microsoft.ad.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: true
    site_name: London
    reboot: true

# This scenario is not recommended, use reboot: true when possible
- name: Promote server with custom paths with manual reboot task
  microsoft.ad.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)
Jordan Borean (@jborean93)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/microsoft/ad/domain_controller_module.html