Share via

Exchange 2007 Provider::ModifyFolder

  • Article

This method modifies an existing public folder.

Arguments

Input Arguments Required Description

<preferredDomainController>

Yes

The domain controller to use for Active Directory actions.

<name>

Yes

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

Security

Rollback Method: ModifyFolder

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>unlimited</maxItemSize> 
    <!--Specifies the size (in KB) when a public folder will prohibit posting.--> 
    <postStorageQuota>50000</postStorageQuota> 
    <!--Specifies the size (in KB) when the public folder will start issuing warnings.--> 
    <storageQuota>50000</storageQuota> 
  </data> 
  <procedure> 
    <execute namespace="Exchange 2007 Provider" procedure="ModifyFolder" 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::CreateFolder
Hosted Email 2007::RemoveFolderPermission