модуль microsoft.ad.domain — обеспечивает существование домена Windows

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install microsoft.ad.

Чтобы использовать её в плейбуке, укажите: microsoft.ad.domain.

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

Обзор

Убедиться, что домен с именем dns_domain_name существует и доступен.
Если домен недоступен, он создаётся в новом лесу на целевом узле Windows Server 2012+.
Если были внесены изменения, после этого может потребоваться выполнить действие ansible.windows.win_reboot.

Примечание

Этому модулю соответствует плагин действия.

Параметры

Параметр	Комментарии
create_dns_delegation boolean	Создавать ли делегирование DNS, указывающее на новый DNS-сервер, который устанавливается вместе с контроллером домена. Применимо только для интегрированной с Active Directory службы DNS. Значение по умолчанию вычисляется автоматически на основе среды. Варианты: `false` `true`
database_path path	Путь к каталогу на фиксированном диске узла Windows, в котором будет создана база данных домена. Если параметр не задан, используется путь по умолчанию `%SYSTEMROOT%\NTDS`.
dns_domain_name string / обязательный	DNS-имя домена, который должен существовать и быть доступным либо находиться на целевом узле Windows.
domain_mode string	Задаёт функциональный уровень домена для первого домена при создании нового леса. Функциональный уровень домена не может быть ниже функционального уровня леса, но может быть выше. Значение по умолчанию вычисляется и задаётся автоматически. Известные на данный момент режимы: `Win2003`, `Win2008`, `Win2008R2`, `Win2012`, `Win2012R2`, `WinThreshold` или `Win2025`.
domain_netbios_name string	Имя NetBIOS корневого домена в новом лесу. Для использования с этим параметром имена NetBIOS должны состоять из одной метки длиной не более 15 символов; в противном случае произойдёт ошибка. Если параметр не задан, значение по умолчанию автоматически вычисляется на основе значения параметра domain_name.
forest_mode string	Задаёт функциональный уровень нового леса. Функциональный уровень леса по умолчанию в Windows Server обычно соответствует используемой версии. Известные на данный момент режимы: `Win2003`, `Win2008`, `Win2008R2`, `Win2012`, `Win2012R2`, `WinThreshold` или `Win2025`.
install_dns boolean	Устанавливать ли службу DNS при создании контроллера домена. Варианты: `false` `true` ← (по умолчанию)
log_path path	Задаёт полный путь, не являющийся UNC-путём, к каталогу на фиксированном диске локального компьютера, в который записывается файл журнала этой операции. Если параметр не задан, используется путь по умолчанию `%SYSTEMROOT%\NTDS`.
reboot boolean	Если `true`, узел будет перезагружен, если модулю потребовалась перезагрузка. Если `false`, узел не будет перезагружен, даже если перезагрузка потребовалась; вместо этого возвращаемое значение reboot_required будет установлено в `true`. Этот параметр нельзя использовать в асинхронном режиме. Варианты: `false` ← (по умолчанию) `true`
reboot_timeout integer добавлено в microsoft.ad 1.7.0	Максимальное время ожидания (в секундах) повторного появления компьютера после перезагрузки и ответа на тестовую команду. Это время ожидания отдельно применяется при проверке перезагрузки и успешного выполнения тестовой команды, поэтому общее время ожидания может вдвое превышать это значение. По умолчанию: `600`
safe_mode_password string / обязательный	Пароль безопасного режима для контроллера домена.
sysvol_path path	Путь к каталогу на фиксированном диске узла Windows, в котором будет создан файл Sysvol. Если параметр не задан, используется путь по умолчанию `%SYSTEMROOT%\SYSVOL`.

Атрибуты

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

Примечания

Примечание

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

См. также

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

Примеры

- name: Create new domain in a new forest on the target host and reboot
  microsoft.ad.domain:
    dns_domain_name: ansible.vagrant
    safe_mode_password: password123!
    reboot: true

- name: Create new Windows domain in a new forest with specific parameters and reboot in post task
  microsoft.ad.domain:
    create_dns_delegation: false
    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

- name: Reboot host if install requires it
  ansible.windows.win_reboot:
  when: domain_install.reboot_required

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

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

Ключ	Описание
reboot_required boolean	Значение 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_module.html