Hosted Email 2007::CreateDistributionList
This procedure creates a distribution list.
Arguments
| Input Arguments | Required | Description |
|---|---|---|
<container> |
Yes |
A valid Lightweight Directory Access Protocol (LDAP) path of the OU where Distribution List will be created. For example LDAP://OU=AlpineSkiHouse,OU=Reseller1,OU=Hosting,DC=fabrikam,DC=Com.) |
<preferredDomainController> |
Yes |
The Fully Qualified Domain Name(FQDN) of a domain controller. |
<managedBy> |
Yes |
The principal name of the user with the managedByrights to the group (user@SMTPDomain -- for example, user1@alpineskihouse.com). |
<Name> |
Yes |
The common name (CN) of the new distribution list. |
Remarks
Security
The caller must be at least a member of role: UserCreators.
Schema Definition
Input
<executeData>
<container>1..1 </container>
<preferredDomainController>1..1 </preferredDomainController>
<managedBy>1..1 </managedBy>
<name>1..1 </name>
</executeData>
Output
<executeData>1..1 </executeData>
Sample Code
Example XML Request
<request>
<data>
<!--A valid LDAP path of the OU where Distribution List will be created. For example LDAP://OU=AlpineSkiHouse,OU=Reseller1,OU=Hosting,DC=fabrikam,DC=Com.)-->
<container>LDAP://OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com</container>
<!--FQDN of a domain controller. -->
<preferredDomainController>AD01.Fabrikam.com</preferredDomainController>
<!--UserPrincipalName of the user with the managedByrights to the group (user@SMTPDomain e.g. johnc@AlpineSkiHouse.com).-->
<managedBy>johnc@AlpineSkiHouse.com</managedBy>
<!--The common name (CN) of the new distribution list.-->
<name>Sales@AlpineSkiHouse.com</name>
</data>
<procedure>
<execute namespace="Hosted Email 2007" procedure="CreateDistributionList" impersonate="1">
<before source="data" sourcePath="container" destination="executeData" mode="move" />
<before source="data" sourcePath="preferredDomainController" destination="executeData" mode="move" />
<before source="data" sourcePath="managedBy" destination="executeData" mode="move" />
<before source="data" sourcePath="name" destination="executeData" mode="move" />
<after source="executeData" destination="data" mode="merge" />
</execute>
</procedure>
</request>
Example XML Response
<response>
<data />
</response>
Applies To
Hosted Email 2007 Namespace for:
Hosted Messaging and Collaboration version 4.5
Hosted Messaging and Collaboration version 4.0