Input argument	Required	Description
<org>	Yes	The Lightweight Directory Access Protocol (LDAP) path of the owning organization.
<databaseName>	Yes	The name of the database to be modified.
<preferredDomainController>	Yes	The name of the preferred domain controller.
<filePath>	Yes	The full file path to the file to retrieve the backup from.
<serverName>	Yes	The name of the server where the database should be restored.
<dataRootShare>	Yes	The share where the data and log files will be created.
<position>	No	The instance (if necessary) of the backup within the backup file. This is necessary if a particular file contains multiple backups.
<sqlUserName>	No	The user name for connecting to the SQL server via SQL Authentication. If this node is present, the connection will be made via SQL Authentication rather than Windows Authentication. The existence of this node also requires that the <sqlUserPass/> node exist.
<sqlUserPass>	No	The password for connecting to the SQL server via SQL Authentication, using the username indicated by <sqlUserName/>. If the <sqlUserName/> node is not present, this node is ignored.

The following steps occur when restoring a customer database from disk with the RestoreCustomerDbFromDisk method:

1. Restore the specified database from disk.
2. Restore directories.

The RestoreCustomerDbFromDisk method has the following security requirements:

• The caller is impersonated.
• The caller is tested for OrgCreator permissions by checking for membership in the domain admins group.

The following is an example of an XML request for the RestoreCustomerDbFromDisk method.

<?xml version="1.0" encoding="iso-8859-1" ?>

<request>

	<procedure>

			 <execute namespace="Managed Data Hosting" 

			procedure="RestoreCustomerDbFromDisk" impersonate="1">

					<executeData>

					 <org>LDAP://OU=northwindtraders,OU=consolidatedmessenger,

				OU=Hosting,DC=fabrikam,DC=Com

				<preferredDomainController>AD01-WH.fabrikam.Com

				 </preferredDomainController>

					<serverName>MPS01-wh</serverName>

				 <databaseName>North1</databaseName>

				 <filePath>c:\temp\North1.bak</filePath>

					 <dataRootShare serviceAcct='fabrikam\MPSSQLService'>

					\\mps01-wh\temp</dataRootShare>

				 </executeData>

					<after source="executeData" destination="data" mode="merge"/>

			 </execute>  

	</procedure>

</request>

No example XML response.

Managed Customer Directory Integration Namespace API for:

• Hosted Messaging and Collaboration version 4.5
• Hosted Messaging and Collaboration version 4.0
• Hosted Messaging and Collaboration version 3.5
• Hosted Messaging and Collaboration version 3.0
• Windows-based Hosting version 4.5
• Windows-based Hosting version 4.0
• Windows-based Hosting version 3.5
• Windows-based Hosting for Applications version 1.0

Managed Data Hosting::BackupCustomerDbToDisk