Share via

Managed Email 2007::MailEnableFolder

  • Article

Mail-enables an existing public folder.

Arguments

Input Arguments Required Description

<organization>

Yes

The LDAP Path of the organization.

<preferredDomainController>

Yes

The domain controller to use for Active Directory actions.

<path>

Yes

Specifies the path\Name of the Public Folder to mail-enable.

<emailAddresses>

Yes

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

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.

<hiddenFromAddressListsEnabled>

No

Specifies whether this mailbox is hidden from other address lists.

Remarks

In cases where there are multiple Exchange Servers that home the Public Folder Tree Hierarchy, it will be necessary to always pass the optional <server> parameter.

Security

Caller must be at least a member of role: UserCreators.

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 path\Name of the Public Folder to mail-enable.--> 
    <path>\AlpineSkiHouse\Legal</path> 
    <!--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> 
    <!--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> 
    <!--Specifies whether the e-mail address policy for this mailbox is enabled.  The default value is true.--> 
    <emailAddressPolicyEnabled>false</emailAddressPolicyEnabled> 
  </data> 
  <procedure> 
    <execute namespace="Managed 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="path" 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" /> 
      <before source="data" sourcePath="emailAddressPolicyEnabled" destination="executeData" mode="move" /> 
      <after source="executeData" destination="data" mode="merge" /> 
    </execute> 
  </procedure> 
</request>

Applies To

  • Hosted Messaging and Collaboration version 4.5

  • Hosted Messaging and Collaboration version 4.0

See also

Other Resources

API Name [HMC SDK]
API Name [HMC SDK]
API Name [HMC SDK]
API Name [HMC SDK]
API Name [HMC SDK]
API Name [HMC SDK]