Hosted Email 2007::MailEnableContact
This procedure Mail-enables an existing contact.
Arguments
| Input Arguments | Required | Description |
|---|---|---|
<preferredDomainController> |
Yes |
The domain controller to use for Active Directory actions. |
<contact> |
Yes |
The Lightweight Directory Access Protocol (LDAP) path of the contact object. |
<externalEmailAddress> |
Yes |
Specifies the target e-mail address. |
<primarySmtpAddress> |
Yes |
Specifies the primary SMTP e-mail address. |
<owningOrganization> |
No |
Specifies the path of the hosted organization that contains the AL, GAL, and OAB as well-known-objects. By default, it is the LDAP parent container of the object. |
Remarks
Security
The caller must be at least a member of role: UserCreators.
Schema Definition
Input
<executeData>
<preferredDomainController>1..1 </preferredDomainController>
<contact>1..1 </contact>
<externalEmailAddress>1..1 </externalEmailAddress>
<primarySmtpAddress>1..1 </primarySmtpAddress>
<owningOrganization>0..1 </owningOrganization>
</executeData>
Output
<executeData>1..1 </executeData>
Sample Code
Example XML Request
<request>
<data>
<!--The domain controller to use for Active Directory actions.-->
<preferredDomainController>AD01.Fabrikam.Com</preferredDomainController>
<!--The LDAP path of the contact object.-->
<contact>LDAP://CN=debrag@AlpineSkiHouse.com,OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=fabrikam,DC=com</contact>
<!--Specifies the target e-mail address.-->
<externalEmailAddress>DebraGarciaExt@msn.com</externalEmailAddress>
<!--Specifies the primary SMTP e-mail address.-->
<primarySmtpAddress>debrag@alpineskihouse.com</primarySmtpAddress>
<!--Specifies the path of the hosted organization that contains the AL, GAL, and OAB as well-known-objects. By default it is the LDAP parent container of the object.-->
<owningOrganization>LDAP://OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=fabrikam,DC=com</owningOrganization>
</data>
<procedure>
<execute namespace="Hosted Email 2007" procedure="MailEnableContact" impersonate="1">
<before source="data" sourcePath="preferredDomainController" destination="executeData" mode="move" />
<before source="data" sourcePath="contact" destination="executeData" mode="move" />
<before source="data" sourcePath="externalEmailAddress" destination="executeData" mode="move" />
<before source="data" sourcePath="primarySmtpAddress" destination="executeData" mode="move" />
<before source="data" sourcePath="owningOrganization" destination="executeData" mode="move" />
<after source="executeData" destination="data" mode="merge" />
</execute>
</procedure>
</request>
Applies To
Hosted Email 2007 Namespace for:
Hosted Messaging and Collaboration version 4.5
Hosted Messaging and Collaboration version 4.0