Spec-Zone.ru › Ansible

Фильтр microsoft.ad.parse_dn — разбирает строку LDAP DistinguishedName и преобразует её в объект.

Примечание

Этот фильтр является частью коллекции microsoft.ad (версия 1.10.0).

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

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

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

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

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

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

  • Преобразует переданное строковое значение LDAP DistinguishedName (DN) в структурированный объект.
  • Правила разбора определены в документе RFC 4514.
  • Каждое DN содержит относительные DistinguishedNames (RDN), разделённые ,, а каждое RDN может содержать несколько значений типов атрибутов, также известных как AVA. Хотя DN Microsoft Active Directory могут содержать только один AVA в RDN, этот анализатор поддерживает несколько AVA.
  • Возвращаемый объект для каждого DN представлен в виде списка списков: внешний список содержит компоненты RDN, разделённые ,, а внутренний список — значения AVA, разделённые = и +. Каждая запись RDN гарантированно содержит два строковых значения — тип и значение AVA, но может содержать и больше, если RDN включает несколько AVA, разделённых +.
  • Экранирование значений атрибутов разобранного RDN снимается, чтобы они представляли фактическое значение, а не исходную строку в DN.
  • Если DN некорректно, будет вызвана ошибка фильтра.

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

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

Параметр

Комментарии

Input

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

Строка LDAP DistinguishedName для разбора.

См. также

См. также

microsoft.ad.dn_escape

Фильтр microsoft.ad.dn_escape

microsoft.ad.split_dn

Фильтр microsoft.ad.split_dn

microsoft.ad.ldap

Инвентаризация microsoft.ad.ldap

Примеры

- name: Parses a simple DN
  set_fact:
    my_dn: '{{ "CN=Foo,DC=domain,DC=com" | microsoft.ad.parse_dn }}'

# [
#   ["CN", "Foo"],
#   ["DC", "domain"],
#   ["DC", "com"],
# ]

- name: Parses a DN with an escaped and multi attribute values
  set_fact:
    my_dn: '{{ "CN=CA,O=Acme\, Inc.,C=AU+ST=Queensland" | microsoft.ad.parse_dn }}'

# [
#   ["CN", "CA"],
#   ["O", "Acme, Inc."],
#   ["C", "AU", "ST", "Queensland"]
# ]

# Extract the group names the computer is a member of in the ldap inventory
# plugin, for example gets the first RDN value inside the parsed DN.
attributes:
  memberOf:
    computer_membership: this | microsoft.ad.parse_dn | map(attribute="0.1")

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

Ключ

Описание

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

list / elements=list

Разобранные значения LDAP DN.

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

Пример: [["CN", "Foo"], ["DC", "domain"], ["DC", "com"]]

Авторы

  • 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/parse_dn_filter.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API