Modifying an organization by using XML

Use the ModifyOrganizationalUnit procedure of the Managed Active Directory namespace to modify an organization.

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

Example of a request that calls the ModifyOrganizationalUnit procedure

<request>
  <procedure>
	<execute namespace="Managed Active Directory" procedure="ModifyOrganization">
	<executeData>
		<org>LDAP://OU=Reseller1,OU=Hosting,DC=contoso,DC=com</org>
		<properties>
		<property name="description">The reseller of too much stuff
			@contoso.com</property>
		</properties>
		<preferredDomainController>myPrimaryDC.contoso.com</preferredDomainController>
	</executeData>
	</execute>
  </procedure>
</request>

Input for ModifyOrganizationalUnit

The following input is valid for this request:

LDAP path of the organization unit
Use the <org> element to specify the Lightweight Directory Access Protocol (LDAP) path of the organizational unit you want to rename.
```
<org>LDAP://LDAP path of the organization</org>
```
Properties to modify
Use the <properties> element to specify any valid Active Directory properties for an organizational unit that you want to add or modify.
```
<properties>
  <property="=description">the description of the reseller<property>
</properties>
```
Preferred domain controller (optional)
By using the <preferredDomainController> element, you can specify or change the domain controller you want to use for this request. Using a single preferred domain controller eliminates replication delays that arise between multiple controllers.

This information is optional.
```
<preferredDomainController>your domain controller</preferredDomainController>
```

Typical response for ModifyOrganizationalUnit

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/).