Hosted Active Directory Import::ImportUser

This procedure imports an existing customer user into the Microsoft Provisioning System (MPS). This includes ensuring that MPS prescribed security settings, group memberships and Plan Manager customer record.

Arguments

Input Arguments Required Description

<user>

Yes

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

<preferredDomainController>

Yes

The domain controller to use for Active Directory actions

<isAdmin>

Yes

A Boolean value. Set this element to True if you want the imported user to be an administrator of the organization; otherwise set to False.

Remarks

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

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

Expected Result

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

Sample Code

Example XML Request

<request>  
   <data>  
      <user>LDAP://CN=jimc@alpineskihouse.com,OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com </user> 
      <preferredDomainController>AD01.Fabrikam.Com </preferredDomainController> 
      <isAdmin>1 </isAdmin> 
   </data> 
   <procedure>  
      <execute namespace="Hosted Active Directory Import" procedure="ImportUser" 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