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. Возвращаемое значение: успех Пример: |
Ссылки на коллекции
© 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