Initializing Active Directory for hosting by using XML

You can use the InitializeADforHosting procedure of the Managed Hosting namespace to create a Hosting organizational unit at the top level of the domain and remove the AuthenticatedUsers access control entry (ACE) from every top-level object of the domain.

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

Important

This procedure only needs to be called during initial setup. If you install Delegated Administration Console, Setup Wizard runs the request so you should not run it again. If you do not install Delegated Administration Console, you must run this request manually to set up Active Directory correctly.

Example of a request that calls the InitializeADforHosting procedure

<request>
  <procedure>
	<execute namespace="Managed Hosting" procedure="InitializeADforHosting">
	<executeData>
		<preferredDomainController>myPrimaryDC.contoso.com</preferredDomainController>
		<name>Hosting1</name>
	</executeData>
	</execute>
  </procedure>
</request>

Input for InitializeADforHosting

The following input is valid for this request:

Preferred domain controller (optional)
By using the <preferredDomainController> element, you can specify the domain controller you want to use for this request. Using a single preferred domain controller eliminates replication delays that arise between multiple controllers.

This information is optional. You are not required to include this element in the request.
```
<preferredDomainController>your primary domain controller.domain name extension</preferredDomainController>
```
Organization name (optional)
By using the <name> element, you can specify the name of the hosting organization if it is other than "Hosting".

This information is optional. You are not required to include this element in the request.
```
<name>name of hosting organization</name>
```

Typical response for InitializeADforHosting

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