Hosted Email 2007::CreateFolder

  • Article

This procedure creates a 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

The name of the public folder.

<domainName>

Yes

This parameter specifies a unique SMTP domain owned by the organization. This domain will be used by the procedure to auto generate an e-mail addresses for the autogenerated mail-enabled security groups. These security groups are used to grant access to the public folder.

<server>

No

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

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

<maxItemSize>

No

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

<postStorageQuota>

No

This parameter specifies the size (KB) when a public folder will prohibit posting.

<storageQuota>

No

This parameter specifies the size (KB) when the public folder will start issuing warnings.

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> 
<domainName>1..1</domainName> 
<server>0..1 </server> 
<maxItemSize>0..1 </maxItemSize> 
<postStorageQuota>0..1 </postStorageQuota> 
<storageQuota>0..1 </storageQuota> 
</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.--> 
    <name>Legal</name> 
    <!--An accepted domain name that is owned by this organization. This is used to generate email addresses 
                  for the mail enabled security groups that are granted access to the new folder--> 
    <domainName>AlpineSkiHouse.com</domainName> 
    <!--Obsolete. 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 bytes (bytes) that is allowed to be posted.--> 
    <maxItemSize>2000</maxItemSize> 
    <!--Specifies the size (in bytes) when a public folder will prohibit posting.--> 
    <postStorageQuota>10000</postStorageQuota> 
    <!--Specifies the size (in bytes) when the public folder will start issuing warnings. Note: supplying this value will override the publicStore/megabytes value of the organizationâ?Ts Email Hosting plan.--> 
    <storageQuota>10000</storageQuota> 
  </data> 
  <procedure> 
    <execute namespace="Hosted 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="domainName" 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>

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