Hosted Exchange::CreateBusinessOrganization2

This procedure creates a business organization and Exchange enables the organization.

Input Arguments	Required	Description
container	Yes	The LDAP path of the reseller.
name	Yes	Name of the organization.
smtpDomain	Yes	The business organization's smtp domain name (e.g., fabrikam.Com).
preferredDomainController	Yes
The mailstoreXmlString	No	Can include the following: <mailStore><megabytes> This is the amount of storage available for mail storage. This parameter is ignored if the <sourceMailStores> parameter is supplied. This property is passed in as an XML fragment string in the following format: `<mailStore> <megabytes>1000</megabytes> <shared>1</shared> </mailStore>` <mailStore algorithm="minStoreCount"> Only used when <sourceMailStores> is not supplied. Possible values of the "algorithm" attribute are "tightPack" and "minStoreCount", with "tightPack" as default. TightPack attempts to use the smallest number of mail stores for the system as a whole, with the tradeoff that each individual org may span more mail stores. MinStoreCount attempts to minimize the number of stores allocated to each org, with the tradeoff that the system as a whole may require more stores. MinStoreCount uses stores with the largest available space first, and tightPack uses stores with the smallest available space first. If the <shared> parameter is 0, then this parameter has relatively little effect, since every share considered is completely empty. <mailStore><shared> If this parameter is 0, the organization is given one or more mail stores which will not be shared with other organizations. (Unshared mail stores are those which were added using AddExchangeResources with their <shared> parameter as 0.) If the <mailStore><shared> parameter is 1, mail storage will be allocated from one or more shared mail stores. Shared mail stores may or may not be shared with other organizations. <mailStore><sourceMailStores> If this parameter is supplied, then the automatic allocation behavior is overridden, and the <mailStore><megabytes> parameter is ignored. The <sourceMailStores> parameter specifies a set of mail stores to be allocated to this org. If any of the specifed stores is unavailable or has insufficient storage, then the entire call will fail. The total mail storage allocation for the org will be the total of the <megabytes> parameters in all of the supplied <sourceMailStore> parameters. <sourceMailStore><serverName> The name of the explicitly allocated store's server. <sourceMailStore><mailStoreName> The name of the mail store on the server. <sourceMailStore><megabytes> The storage to allocate on this mail store. This property is passed in as an XML fragment string in the following format: <mailStore> <sourceMailStores> <sourceMailStore> <serverName>EXBE02</serverName> <mailStoreName>BusinessMailstore1</mailStoreName> <megabytes>200</megabytes> </sourceMailStore> <sourceMailStore> <serverName>EXBE01</serverName> <mailStoreName>BusinessMailstore3</mailStoreName> <megabytes>200</megabytes> </sourceMailStore> <sourceMailStore> <serverName>EXBE02</serverName> <mailStoreName>BusinessMailstore2</mailStoreName> <megabytes>200</megabytes> </sourceMailStore> </sourceMailStores> </mailStore>
publicstoreXmlString	No	Can include the following: <publicStore><megabytes> This is the amount of storage available for public folders. <publicStore><sourcePublicStoreServer> If this parameter is supplied, it specifies the public store to put the organization's public folder storage on. description: the description of the business. propertiesXmlString: Valid AD attributes for an object of class OU. This property is passed in as an XML fragment string in the following format: `<properties> <property name="l">Some City</property> <property name="st">Washington</property> </properties>`
availablePlansXmlString	No	Defines which specific Exchange Mailbox Plans are available to the users of this organization. This property is passed in as an XML fragment string in the following format: `<availablPlans> <planName>BasicMail</planName> </availablePlans>`

Remarks

Method Syntax

public string CreateBusinessOrganization(
string container, 
string name, 
string mailstoreXmlString, 
string publicstoreXmlString, 
string smtpDomain, 
string description,
string propertiesXmlString,
string availablePlansXmlString, 
string preferredDomainController,
bool sendCredentials)

Sample Code

Example XML Response

MPS XML Response in string format (some output replaced with . for brevity):

<response>
  <data>
	<container>LDAP://OU=WH,OU=Hosting,DC=fabrikam,DC=Com</container>
	<name>MindsEyeGraphics</name>
	<description>Freelance design</description>
	<mailStore>
	<megabytes>1000</megabytes>
	<shared>1</shared>
	</mailStore>
	<publicStore>
	<megabytes>1000</megabytes>
	</publicStore>
	<SMTPDomain>MindsEyeGraphics.Com</SMTPDomain>
	<createSMTPDomain/>
	<properties>
	<property name="street">
		<value>1703 NE 91st</value>
	</property>
	</properties>
	<preferredDomainController>AD01.fabrikam.com</preferredDomainController>
<.>
		<ace>
		<permission>ADS_RIGHT_DS_WRITE_PROP</permission>
		<permission>ADS_RIGHT_READ_CONTROL</permission>
		<permission>ADS_RIGHT_WRITE_DAC</permission>
		<permission>ADS_RIGHT_DS_SELF</permission>
		<permission>ADS_RIGHT_DS_CONTROL_ACCESS</permission>
		<permission>ADS_RIGHT_DS_CREATE_CHILD</permission>
		<permission>ADS_RIGHT_DS_DELETE_CHILD</permission>
		<permission>ADS_RIGHT_DS_DELETE_TREE</permission>
		<inheritance>SUB_CONTAINERS_AND_OBJECTS_INHERIT</inheritance>
		<trustee>LDAP://cn=Admins@MindsEyeGraphics,ou=MindsEyeGraphics,OU=WH,OU=Hosting,DC=fabrikam,DC=com</trustee>
		<trusteeType>TRUSTEE_IS_GROUP</trusteeType>
		<trusteeForm>TRUSTEE_IS_SID</trusteeForm>
		<mode>GRANT_ACCESS</mode>
		</ace>
		<ace>
		<permission>ADS_RIGHT_GENERIC_ALL</permission>
		<inheritance>11</inheritance>
		<inheritedObjectTypeName>{BF967ABA-0DE6-11D0-A285-00AA003049E2}</inheritedObjectTypeName>
		<trustee>LDAP://cn=CSRAdmins@MindsEyeGraphics,ou=MindsEyeGraphics,OU=WH,OU=Hosting,DC=fabrikam,DC=com</trustee>
		<trusteeType>TRUSTEE_IS_GROUP</trusteeType>
		<trusteeForm>TRUSTEE_IS_OBJECTS_AND_SID</trusteeForm>
		<mode>GRANT_ACCESS</mode>
		</ace>
	</dacl>
	</org>
  </data>
</response>

Typical C# Usage

//Get user name and password.						 
		string userName = this.Request.ServerVariables.Get("AUTH_USER");
		string pass = this.Request.ServerVariables.Get("AUTH_PASSWORD");

		//Set credentials.
		hostedExch.PreAuthenticate = true;
		hostedExch.Credentials = new NetworkCredential(userName,pass);
		lblMsg.InnerHtml = mpsResponseHeaderLabel;

		//Display response.
		this.mpsResponse.DocumentSource = "";
		response = hostedExch.CreateBusinessOrganization(container, 
name, mailstoreXmlString, publicstoreXmlString, 
smtpDomain, description, propertiesXmlString, availablePlansXmlString, 
preferredDomainController,sendCredentials);

		// set the response XML to match the return from MPF	responseXml.LoadXml(response);
this.mpsResponse.Document = responseXml;

Applies To