Hosted Active Directory Import Namespace

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.

Public Methods
Public Method Description
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.
Exceptions

The following table lists common errors that can be raised by the procedures in this namespace.

Error Code Message Conditions
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.
 Applies To