Active Directory Provider::Get Properties

Returns one or more properties for an Active Directory directory service object. Used by Microsoft Provisioning Framework (MPF).

Get Properties is a wrapper for IADS::GetEx.

Arguments

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

Element Description, relationships, and attributes

executeData

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

Children:
path (minOccurs="1" maxOccurs="1", input only)
properties (minOccurs="1" maxOccurs="1", output only)
propertyList (minOccurs="0" maxOccurs="1", input only)

path

Description:
Lightweight directory access protocol (LDAP) path of the object to retrieve properties from.

Parent:
executeData

properties

Description:
Returned list of properties with their values. Multi-valued properties will return multiple value nodes. Some properties that ADSI does not accept as input in string format will be returned using an XML data type. A similar format must be used when passing values back to the Set Properties action.

If a property type was not implemented to be returned, no property node is returned. Note that IADs::GetEx returns the same thing for an invalid property name as for a valid property name with no value, so in both cases this action will generate an empty property node.

Parent:
executeData

Child:
property (minOccurs="1" maxOccurs="*", output)

property

Description:
Name of the property, used for both input and output XML. Output property nodes can be followed by value nodes.

Child:
value (minOccurs="1" maxOccurs="*", output only)

Attributes:

nameName of the property.

propertyList

Description:
A list of Active Directory properties to retrieve. Use the LDAP attribute display name for the name attribute of the each property element. If the propertyList element is not provided or is empty, all properties are returned.

Parent:
executeData

Child:
property (minOccurs="0" maxOccurs="*", input)

Attributes:

nameRequired. Name of the property to retrieve.

value

Description:
A value of a property. Example (for a VT_BOOL property type):

<property name='showInAdvancedViewOnly'> 
  <value xmlns:dt='urn:schemas-microsoft-com:datatypes' dt:dt='boolean'>1</value> 
</property>

Parent:
Property

Remarks

Active Directory Provider supports the following property types (based on what IADs::GetEx returns):

  • VT_BOOL

  • VT_DATE

  • VT_ARRAY or VT_UI1

  • Any types used by IXMLDOMText::put_nodeTypedValue (basically, whatever VariantChangeType can convert to VT_BSTR)

Schema Definition

Input

<executeData>1..1
  <path>1..1
  <propertyList>0..1
    <property name="..">0..unbounded</property>
  </propertyList>
</executeData>

Output

<executeData>1..1
  <properties>1..1
    <property name="..">1..unbounded
      <value>0..unbounded</value>
    </property>
  </properties>
</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

Other Resources

Active Directory Provider::Set Properties [HMC SDK1]