Фильтр microsoft.ad.split_dn – разделяет LDAP DistinguishedName.

Примечание

Этот плагин фильтра входит в коллекцию microsoft.ad (версия 1.10.0).

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

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

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

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

Краткое описание
Входные данные
Параметры-ключевые слова
См. также
Примеры
Возвращаемое значение

Краткое описание

Разделяет переданное строковое значение LDAP DistinguishedName (DN), возвращая первый/конечный компонент RDN или оставшиеся/родительские компоненты RDN.
Правила разбора определены в RFC 4514.
Каждый DN содержит относительные DistinguishedNames (RDN), разделённые ,.
Возвращаемая строка для каждого DN будет содержать либо первый/конечный компонент RDN, представляющий имя объекта, либо оставшиеся/родительские компоненты, представляющие путь родительского DN. Используйте аргумент kwarg section, чтобы указать, что следует вернуть.
Недопустимый DN вызовет ошибку фильтра.
Поскольку значения приводятся к каноническому виду, возвращаемые значения могут не совпадать с исходной строкой DN, но представляют то же значение LDAP DN.
Начальные и конечные пробелы каждого компонента удаляются из возвращаемого значения.

Входные данные

Здесь описываются входные данные фильтра — значение перед | microsoft.ad.split_dn.

Параметр	Комментарии
Входные данные string / обязательный	Строка LDAP DistinguishedName для разделения.

Параметры-ключевые слова

Здесь описываются параметры-ключевые слова фильтра. Это значения key1=value1, key2=value2 и так далее в следующем примере: input | microsoft.ad.split_dn(key1=value1, key2=value2, ...)

Параметр	Комментарии
section string	Возвращаемая часть DN. По умолчанию используется `leaf`, которое возвращает первый компонент RDN. Укажите `parent`, чтобы вернуть оставшиеся компоненты RDN. Не указывайте `section` в качестве ключевого слова — это значение передаётся как позиционный аргумент. Допустимые значения: `"leaf"` ← (по умолчанию) `"parent"`

Параметр

Комментарии

section

string

Возвращаемая часть DN.

По умолчанию используется leaf, которое возвращает первый компонент RDN.

Укажите parent, чтобы вернуть оставшиеся компоненты RDN.

Не указывайте section в качестве ключевого слова — это значение передаётся как позиционный аргумент.

Допустимые значения:

"leaf" ← (по умолчанию)
"parent"

См. также

microsoft.ad.dn_escape: Фильтр microsoft.ad.dn_escape
microsoft.ad.parse_dn: Фильтр microsoft.ad.parse_dn

Примеры

- name: Gets the leaf RDN of a DN
  set_fact:
    my_dn: '{{ "CN=Foo,DC=domain,DC=com" | microsoft.ad.split_dn }}'

# CN=Foo

- name: Gets the parent RDNs of a DN
  set_fact:
    my_dn: >-
      {{
        "CN=Acme\, Inc.,O=OrgName,C=AU+ST=Queensland" |
          microsoft.ad.split_dn("parent")
      }}

# O=OrgName,C=AU+ST=Queensland,

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

Ключ	Описание
Возвращаемое значение string	Разделённые компоненты RDN в соответствии с запрошенной частью. Возвращается: при успешном выполнении Пример: `"CN=Foo"`

Авторы

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/split_dn_filter.html