Active Directory Provider::Path From DN

  • Article

Converts a Active Directory directory service distinguished name (DN) to a lightweight directory access protocol (LDAP) path. Used by Microsoft Provisioning Framework (MPF).

Arguments

The following table describes the XML schema elements and attributes. Unless otherwise indicated, the data type is string.

Element Description, relationships, and attributes

distinguishedName

Description:
Distinguished name of the Active Directory object you want to obtain the LDAP path of. For example:

<distinguishedName>cn=user1,cn=users,dc=domain,dc=com</distinguishedName>

Parent:
executeData

executeData

Description:
Encapsulates the procedure's input and output data.

Children:
distinguishedName (minOccurs="1" maxOccurs="1", input only)
path (minOccurs="1" maxOccurs="1", output only)
referencePath (minOccurs="1" maxOccurs="1", input only)

path

Description:
Returned LDAP path of the object specified using the distinguishedName node. For example:

<path>LDAP://cn=user1,cn=users,dc=domain,dc=com</path>

Parent:
executeData

referencePath

Description:
Reference LDAP path to any object in the same Active Directory domain. For example:

<referencePath>LDAP://dc=domain,dc=com</referencePath>

Parent:
executeData

Remarks

No remarks.

Schema Definition

Input


<executeData>1..1
  <referencePath>1..1</referencePath>
  <distinguishedName>1..1</distinguishedName>
</executeData>

Output

<executeData>1..1
  <path>1..1</path>
</executeData>

Sample Code

Example XML Request

The following code fragment shows the format for sending data to this procedure. For more information on individual elements and attributes, see the Elements and Attributes table.

Example XML Response

The following code fragment shows the format for data this procedure returns. For more information on individual elements and attributes, see the Elements and Attributes table.

Applies To

Active Directory Provider for:

  • Hosted Messaging and Collaboration version 4.5

  • Hosted Messaging and Collaboration version 4.0

  • Hosted Messaging and Collaboration version 3.5

  • Hosted Messaging and Collaboration version 3.0

  • Windows-based Hosting version 4.5

  • Windows-based Hosting version 4.0

  • Windows-based Hosting version 3.5

  • Windows-based Hosting for Applications version 1.0

See also

Tasks

Active Directory Provider::Path To DN