Фильтр 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 Пример: |
Ссылки на коллекцию
© 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