Spec-Zone.ru › Ansible

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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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. Хотя DNs Microsoft Active Directory могут содержать только 1 AVA в RDN, этот парсер поддерживает несколько AVA.
  • Возвращаемый объект для каждого DN будет представлен как список списков, где внешний список — это каждый компонент RDN, разделенный ,, а внутренний список — это каждый AVA, разделенный = и +. Каждая запись RDN гарантированно имеет 2 строковых значения для типа AVA и значения, но может содержать больше, если RDN содержит несколько AVA, разделенных +.
  • Разбираемые значения атрибутов RDN будут раскомментированы, чтобы представлять фактическое значение, а не исходную строку в DN.
  • Некорректный DN вызовет ошибку фильтра.

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

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

Параметр

Комментарии

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

строка / обязательно

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

См. также

См. также

microsoft.ad.dn_escape

фильтр microsoft.ad.dn_escape

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")

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

Ключ

Описание

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

список / элементы=список

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

Возвращаемое значение: успех

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

Авторы

  • Jordan Borean (@jborean93)

Подсказка

Параметры конфигурации для каждого типа записи имеют порядок приоритета от низкого к высокому. Например, переменная, расположенная ниже в списке, переопределит переменную, расположенную выше.

Ссылки на коллекции

  • Отслеживание ошибок
  • Репозиторий (источники)
  • Сообщить об ошибке
  • Общение

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/microsoft/ad/parse_dn_filter.html

Spec-Zone.ru

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