Hosted Email 2007::MailEnableFolder

This procedure Mail-enables an existing public folder.

Arguments

Input Arguments Required Description

<organization>

Yes

The Lightweight Directory Access Protocol (LDAP) path of the organization.

<preferredDomainController>

Yes

The domain controller to use for Active Directory actions.

<name>

Yes

This parameter specifies the name of the Public Folder to mail-enable.

<emailAddresses>

Yes

This parameter specifies all the proxy addresses of the public folder. It includes the primary Simple Mail Transfer Protocol (SMTP) address as one of the proxy addresses.

<emailAddresses/ value>

Yes

One or more proxy addresses.

<server>

No

This parameter 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.

Dd251648.note(en-us,TechNet.10).gifNote
parameter server is obsolete in Hosted Messaging and Collaboration version 4.5.

<hiddenFromAddressListsEnabled>

No

This parameter specifies whether this mailbox is hidden from other address lists.

Remarks

Security

The caller must be at least a member of role: UserCreators.

Schema Definition

Input

<executeData>  
<organization>1..1 </organization> 
<preferredDomainController>1..1 </preferredDomainController> 
<name>1..1 </name> 
<emailAddresses>1..1  
<value>1..unbounded </value> 
</emailAddresses> 
<server>0..1 </server> 
<hiddenFromAddressListsEnabled>0..1 </hiddenFromAddressListsEnabled> 
</executeData> 

Output

<executeData>1..1 </executeData>

Sample Code

Example XML Request

<request> 
  <data> 
    <!--The LDAP Path of the organization--> 
    <organization>LDAP://OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com</organization> 
    <!--The domain controller to use for Active Directory actions.--> 
    <preferredDomainController>AD01.Fabrikam.Com</preferredDomainController> 
    <!--Specifies the name of the Public Folder to mail-enable.--> 
    <name>Legal</name> 
    <!--Specifies all the proxy addresses of the public folder. It includes the primary Simple Mail Transfer Protocol (SMTP) address as one of the proxy addresses.--> 
    <emailAddresses> 
      <!--One or more proxy addresses.--> 
      <value>Legal@alpineskihouse.com</value> 
    </emailAddresses> 
    <!--Obsolete. Specifies the server on which the public folder resides.--> 
    <server>EXMBXOAB01</server> 
    <!--Specifies whether this mailbox is hidden from other address lists.--> 
    <hiddenFromAddressListsEnabled>false</hiddenFromAddressListsEnabled> 
  </data> 
  <procedure> 
    <execute namespace="Hosted Email 2007" procedure="MailEnableFolder" impersonate="1"> 
      <before source="data" sourcePath="organization" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="preferredDomainController" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="name" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="emailAddresses" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="server" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="hiddenFromAddressListsEnabled" 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

See also

Tasks

Hosted Email 2007::AddFolderPermission
Hosted Email 2007::DeleteFolder
Hosted Email 2007::MailEnableFolder
Hosted Email 2007::MailDisableFolder
Hosted Email 2007::ModifyFolder
Hosted Email 2007::RemoveFolderPermission