W3cubDocs

/Ansible

microsoft.ad.as_guid filter – Converts an LDAP value to a GUID string

Note

This filter plugin is part of the microsoft.ad collection (version 1.9.2).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install microsoft.ad.

To use it in a playbook, specify: microsoft.ad.as_guid.

New in microsoft.ad 1.1.0

Synopsis

  • Converts an LDAP string or raw value to a guid string.
  • Should be used with the microsoft.ad.ldap plugin to convert attribute values to a guid string.

Input

This describes the input of the filter, the value before | microsoft.ad.as_guid.

Parameter

Comments

Input

any / required

The LDAP attribute bytes or string value representing a GUID stored in LDAP.

If using a string as input, it must be a base64 string representing the GUIDs bytes.

See Also

See also

microsoft.ad.as_datetime

microsoft.ad.as_datetime filter

microsoft.ad.as_sid

microsoft.ad.as_sid filter

microsoft.ad.ldap

microsoft.ad.ldap inventory

Examples

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

attributes:
  objectGuid: raw | microsoft.ad.as_guid

Return Value

Key

Description

Return value

string

The guid string value(s).

Returned: success

Authors

  • 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/ansible/latest/collections/microsoft/ad/as_guid_filter.html