Renaming a group by using XML

Use the RenameGroup procedure of the Managed Active Directory namespace to rename a group in Active Directory.

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

Example of a request that calls the RenameGroup procedure

<request>
  <procedure>
	<execute namespace="Managed Active Directory" procedure="RenameGroup">
	<executeData>
		<group>LDAP:// CN=myGroup1,DC=contoso,DC=com</group>
		<newName>myGroup1NewName</newName>
		<preferredDomainController>myPrimaryDC.contoso.com</preferredDomainController>
	</executeData>
	<after source="executeData" sourcePath="path" 
		destination="data" mode="insert" /> </execute>
	</execute>
  </procedure>
</request>

Input for RenameGroup

The following input is valid for this request:

LDAP path of the group
Use the <group> element to specify the Lightweight Directory Access Protocol (LDAP) path of the group.
```
<group>LDAP://LDAP path of the group</group>
```
New group name
Use the <newName> element to specify the new name for the group.
```
<newName>new group name</newName>
```
Preferred domain controller (optional)
By using the <preferredDomainController> element, you can specify the domain controller that you want to use for this request. This information is optional.
```
<preferredDomainController>your domain controller</preferredDomainController>
```

Typical response for RenameGroup

<response>
  <data>
	<path>LDAP://cn=myGroup1NewName,OU=Reseller1,OU=Hosting,DC=contoso,DC=com</path>
  </data>
</response>

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