Модуль microsoft.ad.domain_child — управление дочерними доменами в существующем лесу Active Directory.

create_dns_delegation

boolean

Создавать ли делегирование DNS, указывающее на установленный новый DNS-сервер.

Применимо только к DNS, интегрированной с Active Directory.

Значение по умолчанию вычисляется автоматически с учётом среды.

Варианты:

• false
• true

database_path

path

Путь к каталогу на фиксированном диске узла Windows, где будет создана база данных домена.

Если параметр не задан, используется путь по умолчанию %SYSTEMROOT%\NTDS.

dns_domain_name

string

Полное DNS-имя создаваемого домена.

Если domain_type=child, имя родительского домена DNS определяется на основе этого значения.

domain_admin_password

string / обязательный

Пароль для указанного пользователя domain_admin_user.

domain_admin_user

string / обязательный

Имя пользователя администратора родительского домена.

domain_mode

string

Указывает функциональный уровень дочернего домена или дерева.

Функциональный уровень домена не может быть ниже функционального уровня леса, но может быть выше.

Значение по умолчанию вычисляется и устанавливается автоматически.

В настоящее время известны следующие режимы: Win2003, Win2008, Win2008R2, Win2012, Win2012R2, WinThreshold или Win2025.

domain_type

string

Указывает тип создаваемого домена.

Задайте значение child, чтобы создать дочерний домен существующего домена, указанного в dns_domain_name.

Задайте значение tree, чтобы создать новое дерево доменов в существующем лесу, указанном в parent_domain_name. Параметр dns_domain_name должен содержать полное имя создаваемого нового дерева доменов.

Варианты:

• "child" ← (по умолчанию)
• "tree"

install_dns

boolean

Устанавливать ли службу DNS при создании контроллера домена.

Если значение не указано, параметр -InstallDns не передаётся команде Install-ADDSDomain. Дополнительные сведения см. в документации Install-ADDSDomain.

Варианты:

• false
• true

log_path

path

Полный путь, не являющийся UNC-путём, к каталогу на фиксированном диске локального компьютера, в котором будут храниться файлы журнала домена.

parent_domain_name

string

Полное доменное имя существующего родительского домена, в котором создаётся новое дерево доменов.

Этот параметр можно задать только при domain_type=tree.

reboot

boolean

Если задано true, узел будет перезагружен, если модулю потребуется перезагрузка.

Если задано false, узел не будет перезагружен, даже если перезагрузка необходима; вместо этого возвращаемое значение reboot_required будет равно true.

Этот параметр нельзя использовать в асинхронном режиме.

Варианты:

• false ← (по умолчанию)
• true

reboot_timeout

integer

добавлено в microsoft.ad 1.7.0

Максимальное время ожидания в секундах, в течение которого компьютер должен снова стать доступным после перезагрузки и ответить на тестовую команду.

Это время ожидания применяется отдельно для проверки перезагрузки и успешного выполнения тестовой команды, поэтому общее время ожидания может вдвое превышать это значение.

По умолчанию: 600

replication_source_dc

string

добавлено в microsoft.ad 1.8.0

Указывает имя существующего контроллера домена в лесу, который будет использоваться в качестве источника репликации для нового домена.

safe_mode_password

string / обязательный

Пароль безопасного режима для контроллера домена.

site_name

string

Указывает имя существующего сайта, на котором можно разместить новый контроллер домена.

sysvol_path

path

Путь к каталогу на фиксированном диске узла Windows, где будет создана папка Sysvol.

Если параметр не задан, используется путь по умолчанию %SYSTEMROOT%\SYSVOL.

action

Поддержка: полная

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

async

Поддержка: частичная

Поддерживается во всех сценариях, кроме reboot=True.

Поддерживает использование с ключевым словом async

bypass_host_loop

Поддержка: отсутствует

Принудительно запускает «глобальную» задачу, которая выполняется не для каждого узла; при этом пропускаются обработка шаблонов для отдельных узлов, а также учёт serial, throttle и других параметров циклов

Условия работают так, как если бы использовался run_once; используются переменные первого доступного узла

Это действие обычно не работает вне стратегий пошагового выполнения

check_mode

Поддержка: полная

Может выполняться в режиме проверки и возвращать прогноз изменения состояния без изменения целевого узла; если режим не поддерживается, действие будет пропущено.

diff_mode

Поддержка: отсутствует

В режиме diff возвращает сведения об изменениях (или о возможных изменениях в режиме check_mode)

platform

Платформа: windows

Целевые ОС и семейства ОС, с которыми можно работать

reboot_required

boolean

Истина, если были внесены изменения, требующие перезагрузки.

Возвращается: всегда

Пример: true