Active Directory Provider::Set Properties
Sets one or more properties for an object. Used by Microsoft Provisioning Framework (MPF).
Set Properties is a wrapper for IADs::PutEx.
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: > Children: |
flagSkipAction |
Description: Now that MPF supports try/catch error handling (through Provisioning Schema::try and Provisioning Schema::catch elements), there is little need to specify flagSkipAction. This node was originally introduced to support error handling for Active Directory Provider::Create Object. For example, a Create Object call ordinarily fails if the user already exists. To override this behavior, the request can include a flagIgnoreAlreadyExistsError node, which instructs Create Object to return a flagSkipAction node. Subsequent calls pass this node to prevent further operations on the object. In the case of Set Properties, the presence of flagSkipAction prevents accidental changes to object properties. Parent: |
path |
Description: Parent: |
properties |
Description: Parent: Child: |
property |
Description: Parent: Child: Attributes:
nameLDAP display name for the property.
modeOptional. Control code that indicates how the procedure handles the incoming property value.
|
value |
Description:
Parent: |
Remarks
When Set Properties is executed during rollback, it restores the original values.
Schema Definition
Input
<executeData>1..1
<path>1..1
<properties>1..1
<property name=".." mode="..">1..unbounded
<value></value>0..unbounded
</property>
</properties>
<flagSkipAction>0..1</flagSkipAction>
</executeData>
Example XML Response
Set Properties does not return data.
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
Set Properties does not return data.
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