Moving an object by using XML

Use the MoveObject procedure of the Managed Active Directory namespace to move an organization or another object in Active Directory. Microsoft Provisioning Framework checks the credentials of the person submitting the request to ensure that moves are allowed only within organizations for which the requester has permissions.

This procedure expects to be called with impersonate="1". The procedure impersonates the caller.

Example of a request that calls the MoveObject procedure

<request>
  <procedure>
	<execute namespace="Managed Active Directory" procedure="MoveObject">
	<executeData>
		<object>LDAP://CN=myUser1,CN=Users,DC=contoso,DC=com
		</object>
		<destinationContainer>LDAP://OU=Hosting,DC=contoso,DC=com
		</destinationContainer >
		<preferredDomainController>myPrimaryDC.contoso.com
		</preferredDomainController>
	</executeData>
	</execute>
  </procedure>
</request>

Input for MoveObject

The following input is valid for this request:

LDAP path of the source object
Use the <object> element to specify the Lightweight Directory Access Protocol (LDAP) path of the object that you want to move.
```
<object>LDAP://LDAP path of the source object</object>
```
LDAP path of the destination container
Use the <destinationContainer> element to specify the Lightweight Directory Access Protocol (LDAP) path of the container where you want to move the object.
```
<destinationContainer>LDAP:// LDAP path of the destination container</destinationContainer>
```
Preferred domain controller (optional)
By using the <preferredDomainController> element, you can specify the domain controller that you want to use for this request. Using a single preferred domain controller eliminates replication delays that arise between multiple controllers.
```
<preferredDomainController>your domain controller</preferredDomainController>
```

Typical response for MoveObject

The response to this procedure does not contain significant data.

Important

Although Active Directory is not case sensitive for elements such as the Lightweight Directory Access Protocol (LDAP) path, XML is case sensitive. To ensure that the procedure executes appropriately, specify all tags, elements, and data using uppercase and lowercase letters exactly as shown in the XML examples. For additional guidelines on how to use XML, see the Microsoft Web site (http://www.microsoft.com/).