Modifying a contact by using XML

Use the ModifyContact procedure of the Managed Active Directory namespace to modify a contact in Active Directory.

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

Example of a request that calls the ModifyContact procedure

<request>
  <procedure>
	<execute namespace="Managed Active Directory" procedure="ModifyContact">
	<executeData>
		<contact>LDAP://CN=Suzan Fine,OU=Hosting,DC=contoso,DC=com</contact>
		<properties>
		<property name="description">Senior Flight Instructor</property>
		</properties>
	</executeDataa>
	</execute>
  </procedure>
</request>

Input for ModifyContact

The following input is valid for this request:

• LDAP path of the contact

  Use the <contact> element to specify the Lightweight Directory Access Protocol (LDAP) path of the contact.

  <contact>LDAP://LDAP path of the contact</contact>
  

• Properties to modify

  In the <properties> element, specify the properties you want to modify, or add new properties that you want to set for the contact.

  <properties>
     <property name="displayName">New name to display</property>
     <property name="givenName">Contact's modified first name</property>
     <property name="middleName">Contact's modified middle name</property>
     <property name="sn">Contact's modified last name</property>
     <property name="initials">Contact's initials</property>
     <property name="description">Contact's new description </property>
  </properties>
  

Typical response for ModifyContact

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