Exchange 2007 Provider::CreateFolder
This method creates a folder within a MAPI TLH and assigns permissions.
Arguments
Input Arguments | Required | Description |
---|---|---|
<preferredDomainController> |
Yes |
This parameter specifies the domain controller to use for Active Directory actions. |
<name> |
Yes |
This parameter specifies the name of the Public Folder. |
<path> |
Yes |
This parameter specifies the location of the folder in the folder hierarchy, for example, \ for root level folders. |
<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. |
<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 (in KB) when a public folder will prohibit posting. |
<storageQuota> |
No |
This parameter specifies the size (in KB) when the public folder will start issuing warnings. |
Remarks
Rollback Method: DeleteFolder
Security
The caller must be at least a member of role: UserCreators.
Sample Code
Example XML Request
<request>
<data>
<!--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>unlimited</storageQuota>
</data>
<procedure>
<execute namespace="Exchange 2007 Provider" procedure="CreateFolder" impersonate="1">
<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
Exchange 2007 Provider 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