Hosted Email 2007::ModifyFolder

This procedure modifies the attributes of 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.

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

<server>

No

This parameter specifies the server on which the public folder resides.

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

Remarks

Security

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

Schema Definition

Input

<executeData>   <organization>1..1 </organization>  <preferredDomainController>1..1 </preferredDomainController>  <name>1..1 </name>  <maxItemSize>0..1 </maxItemSize>  <postStorageQuota>0..1 </postStorageQuota>  <storageQuota>0..1 </storageQuota>  <server>0..1</server> </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>     <!--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 that is allowed to be posted.-->     <maxItemSize>50000</maxItemSize>     <!--Specifies the size in bytes when a public folder will prohibit posting.-->     <postStorageQuota>50000</postStorageQuota>     <!--Specifies the size in bytes when the public folder will start issuing warnings.-->     <storageQuota>50000</storageQuota>   </data>   <procedure>     <execute namespace="Hosted Email 2007" procedure="ModifyFolder" 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="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 Namespacefor:

  1. Hosted Messaging and Collaboration version 4.5

  2. 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::CreateFolder
Hosted Email 2007::RemoveFolderPermission