Managed Email 2007::CreateFolder

  • Article

Creates a 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.

<name>

Yes

The name of the Public Folder.

<path>

Yes

Specifies the location of the folder in the folder hierarchy, for example, \ for root level folders.

<server>

No

Specifies the server on which the public folder resides. If a server is not specified, the command checks if the local server is a Microsoft Exchange Server 2007 mailbox server with a public folder store. If it is, the public folder is created locally. If it is not, Exchange finds the closest (by site cost) Exchange 2007 mailbox server with a public folder store on which to create the public folder.

<maxItemSize>

No

Specifies the maximum item size in kilobytes (KB) that is allowed to be posted.

<postStorageQuota>

No

Specifies the size (in KB) when a public folder will prohibit posting.

<storageQuota>

No

Specifies the size (in KB) when the public folder will start issuing warnings.

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 name of the public folder.--> 
    <name>Legal</name> 
    <!--Specifies the location of the folder in the folder hierarchy, for example, \ for root level folders.--> 
    <path>\AlpineSkiHouse</path> 
    <!--Specifies the server on which the public folder resides.  If a server is not specified, the command checks if the local server is a Microsoft Exchange Server 2007 mailbox server with a public folder store. If it is, the public folder is created locally. If it is not, Exchange finds the closest (by site cost) Exchange 2007 mailbox server with a public folder store on which to create the public folder.--> 
    <server>EXMBXOAB01</server> 
    <!--Specifies the maximum item size in kilobytes (KB) that is allowed to be posted.--> 
    <maxItemSize>4000</maxItemSize> 
    <!--Specifies the size (in KB) when a public folder will prohibit posting.--> 
    <postStorageQuota>12000</postStorageQuota> 
    <!--Specifies the size (in KB) when the public folder will start issuing warnings.--> 
    <storageQuota>20000</storageQuota> 
  </data> 
  <procedure> 
    <execute namespace="Managed Email 2007" procedure="CreateFolder" 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="path" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="server" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="maxItemSize" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="postStorageQuota" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="storageQuota" 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]