Автоматическое определение партиции

Если флаг --partition не указан, клиент ищет зону во всех партициях в следующем порядке:

domain → forest → legacy → custom

В этом случае возможны следующие сценарии:

Сценарий Результат

Зона найдена в одной партиции

✅ Успех

Зона не найдена

❌ zone not found

Зона найдена в нескольких партициях

❌ Ошибка со списком партиций

Примеры использования:

  • автоопределение зоны и партиции:

    dnscli ZoneInfo --name example.com

  • автоопределение зоны и явное указание партиции:

    dnscli ZoneInfo --name example.com --partition forest

  • явное указание зоны и пользовательской партиции:

    dnscli ZoneInfo --name apps.example.com --partition custom --partitionname MyAppPartition.EXAMPLE.COM
В скриптах всегда указывайте --zonename и --partition явно. Это делает поведение предсказуемым и помогает избежать ошибок при наличии дубликатов зон.

Особенности работы с пользовательской партицией (custom)

При использовании --partition=custom клиент требует указания одного из двух обязательных параметров для идентификации партиции:

  • --partitionname — FQDN пользовательской партиции (например, MyAppPartition.EXAMPLE.COM);

  • --partitiondn — DN пользовательской партиции в службе каталогов (например, DC=MyAppPartition,DC=EXAMPLE,DC=COM).

Без --partitionname или --partitiondn команда завершится ошибкой.

Параметры --partitionname и --partitiondn взаимозаменяемы. Клиент автоматически разрешает имя партиции в DN через LDAP-запрос к контроллеру домена. Это позволяет использовать как простое имя, так и полный путь.

Примеры корректного использования

По имени (рекомендуется):

dnscli ZoneInfo --name apps.example.com --partition custom --partitionname MyAppPartition.EXAMPLE.COM

По DN (для интеграции с LDAP-инструментами):

dnscli ZoneInfo --name apps.example.com --partition custom --partitiondn "DC=MyAppPartition,DC=EXAMPLE,DC=COM"

Создание зоны в пользовательской партиции:

dnscli ZoneCreate --name apps.example.com --partition custom --partitionname MyAppPartition.EXAMPLE.COM --type ds-primary

Проверка доступности пользовательской партиции

Чтобы получить список всех доступных партиций, включая пользовательские, используйте:

dnscli PartitionList

Обратная совместимость

Для обратной совместимости также поддерживаются устаревшие флаги:

Новый вариант флага Устаревший вариант флага

--partition

--directorypartition

--partitionname

--custompartitionname

--partitiondn

--custompartitiondn

Обновлено: