This section provides the details of the application programming interface (API) for the Hosted Active Directory Import Namespace included with the Microsoft® Provisioning System (MPS) in the Microsoft Solution for Hosted Messaging and Collaboration version 4.0 Migration Kit, which is dedicated for the migration from the Microsoft Solution for Hosted Messaging and Collaboration version 3.5 to Hosted Messaging and Collaboration version 4.0.
Contained herein are descriptions of the procedures of this namespace along with method input parameters and return values. In addition, example Extensible Markup Language (XML) requests are provided along with typical XML responses that the provisioning system returns after a request is submitted to MPS and tasks are completed.
Developers should use this API document as a reference when creating XML requests to import existing Active Directory objects into MPS.
All procedures defined in Hosted Active Directory Import require Domain Admin privilege to execute.
The procedures in this namespace are for migration purpose from Hosted Messaging and Collaboration version 3.5. With earlier versions such as Hosted Messaging and Collaboration version 3.0, you need to do clean deployment.
|Hosted Active Directory Import::ImportBusinessOrganization||Imports an existing business organization into the MPS system.|
|Hosted Active Directory Import::ImportConsumerOrganization||Imports an an existing consumer organization into the MPS system.|
|Hosted Active Directory Import::ImportContact||Imports an existing contact into the MPS system.|
|Hosted Active Directory Import::ImportGroup||Imports an existing group into the MPS system.|
|Hosted Active Directory Import::ImportResellerOrganization||Imports an existing reseller organization into the MPS system.|
|Hosted Active Directory Import::ImportUser||Imports an existing customer user into the MPS system.|
The following table lists common errors that can be raised by the procedures in this namespace.
|0x80070057||The argument '%1' cannot be null.||A required argument was supplied without a value.|
|0x80070057||The required argument %1 was not supplied.||A required argument was not supplied in the request.|
|0x80070057||Insufficient Privilege! Not Domain Administrator.||A procedure was run with credentials not belonging to a user that is a member of domain admins.|
|0x80071392||Customer already exists.||A record matching this object already exists in the Plan Manager database.|
|0x80072030||Customer parent container does not exist.||The container organization specified for the import object was not found in the Plan Manager database.|
|0x80072030||Unable to open object '%1'./There is no such object on the server./ADsGetObject/Unable to create '%2' ./CreateObject" Customer parent container does not exist.||The container for the specified object was not found in Active Directory.|
|0x80131509||The container %1 is not a valid type for this operation. Expected container types: %2||An import was attempted on an object which was in a container of an unexpected type. Such as running ImportResellerOrganization on a Business Organization.|
|0x80131509||The container %1 is not configured with a hosting policy. You must import the container before any children can be imported.||An import was attempted on an object in a container that is not recognized by Hosted Active Directory. The container must be imported before any children can be imported.|
|0x80131509||The object %1 is not of a valid objectClass for this operation. Expected class: %2||An import was attempted on an object of an unexpected class. Such as running ImportGroup on a contact object.|