microsoft.ad.dn_escape 过滤器 – 转义 LDAP DistinguishedName 值字符串。

注意

此过滤器插件是 microsoft.ad 集合 (版本 1.7.1) 的一部分。

如果您正在使用 ansible 包,您可能已经安装了此集合。它不包含在 ansible-core 中。要检查它是否已安装,请运行 ansible-galaxy collection list

要安装它,请使用: ansible-galaxy collection install microsoft.ad

要在剧本中使用它,请指定: microsoft.ad.dn_escape

microsoft.ad 1.5.0 中的新增功能

概要

  • 转义用于 LDAP DistinguishedName 的字符串值。

  • 这可以用于在构建 DistinguishedName 值时转义特殊字符。

输入

这描述了过滤器的输入,即 | microsoft.ad.dn_escape 之前的值。

参数

注释

输入

字符串 / 必需

要转义的字符串值。

这应该是 RDN 值,不包括作为值前缀的属性类型,例如 MyValue 而不是 CN=MyValue

另请参阅

另请参阅

microsoft.ad.parse_dn

microsoft.ad.parse_dn 过滤器

microsoft.ad.ldap

microsoft.ad.ldap 清单

示例

# This is an example used in the microsoft.ad.ldap plugin

search_base: OU={{ my_ou_variable | microsoft.ad.dn_escape }},DC=domain,DC=com

# This is an example with the microsoft.ad.user module

- microsoft.ad.user:
    name: MyUser
    password: MyPassword123
    state: present
    path: OU={{ my_ou_variable | microsoft.ad.dn_escape }},DC=domain,DC=com

返回值

描述

返回值

字符串

已转义的 RDN 属性值。

返回:成功

作者

  • Jordan Borean (@jborean93)

提示

每个条目类型的配置条目具有从低到高的优先级顺序。例如,列表中较低的变量将覆盖较高的变量。