Hosted Active Directory Import::ImportContact

This procedure imports an existing contact into the Microsoft Provisioning System (MPS). This includes adding a record for the contact to the Plan Manager customer table.

Arguments

Input Arguments Required Description

<contact>

Yes

The Lightweight Directory Access Protocol (LDAP) path of the contact

<preferredDomainController>

Yes

The domain controller to use for Active Directory actions

Remarks

If an existing Plan Manager customer record is found for the specified contact an exception will be raised aborting execution of the procedure.

The contact must be a child of a valid Hosted Messaging and Collaboration version 4.0 organization.

Expected Result

The contact imported by this procedure should have the same state as a contact that was created with Hosted Active Directory::CreateContact.

Sample Code

Example XML Request

<request>  
   <data>  
      <contact>LDAP://CN=jimc_external@alpineskihouse.com,OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com </contact> 
      <preferredDomainController>AD01.Fabrikam.Com </preferredDomainController> 
   </data> 
   <procedure>  
      <execute namespace="Hosted Active Directory Import" procedure="ImportContact" impersonate="1" >  
         <before source="data" destination="executeData" mode="merge" /> 
         <after source="executeData" destination="data" mode="merge" /> 
      </execute> 
   </procedure> 
</request>

Applies To

Hosted Active Directory Import Namespace for:

  • Hosted Messaging and Collaboration version 4.0 Migration Kit