Set-ManagedFolder (RTM)

Article
01/23/2017

Microsoft Exchange Server 2007 will reach end of support on April 11, 2017. To stay supported, you will need to upgrade. For more information, see Resources to help you upgrade your Office 2007 servers and clients.

Applies to: Exchange Server 2007

Use the Set-ManagedFolder cmdlet to modify the settings of managed folders.

Syntax

Set-ManagedFolder -Identity <ELCFolderIdParameter> [-Comment <String>] [-DomainController <Fqdn>] [-FolderName <String>] [-LocalizedComment <MultiValuedProperty>] [-LocalizedFolderName <MultiValuedProperty>] [-MustDisplayCommentEnabled <$true | $false>] [-Name <String>] [-StorageQuota <Unlimited>]

Set-ManagedFolder [-Comment <String>] [-DomainController <Fqdn>] [-FolderName <String>] [-Instance <ELCFolder>] [-LocalizedComment <MultiValuedProperty>] [-LocalizedFolderName <MultiValuedProperty>] [-MustDisplayCommentEnabled <$true | $false>] [-Name <String>] [-StorageQuota <Unlimited>]

Detailed Description

Use the Set-ManagedFolder cmdlet to modify the specified parameters of a managed folder.

The Set-ManagedFolder cmdlet accepts a managed custom folder or an identity string as pipelined input.

To run the Set-ManagedFolder cmdlet, the account you use must be delegated the following:

Exchange Organization Administrator role

For more information about permissions, delegating roles, and the rights that are required to administer Exchange Server 2007, see Permission Considerations.

Parameters

Parameter	Required	Type	Description
Identity	Required	Microsoft.Exchange.Configuration.Tasks.ELCFolderIdParameter	The Identity parameter specifies the name, distinguished name, or GUID of the managed folder.
Comment	Optional	System.String	The Comment parameter specifies the default administrator comment to be displayed with the folder in Microsoft Office Outlook 2007.
DomainController	Optional	Microsoft.Exchange.Data.Fqdn	To specify the fully qualified domain name (FQDN) of the domain controller that retrieves data from the Active Directory directory service, include the DomainController parameter in the command.
FolderName	Optional	System.String	The FolderName parameter specifies the name of the folder object as it will appear in users' mailboxes.
Instance	Optional	Microsoft.Exchange.Data.Directory.SystemConfiguration.ELCFolder	The Instance parameter enables you to pass an object to the command to be processed. It is mainly used in scripts where an entire object must be passed to the command.
LocalizedComment	Optional	Microsoft.Exchange.Data.MultiValuedProperty	The LocalizedComment parameter specifies localized administrator comments and their languages. Localized comments are displayed instead of the default comment when the language setting of any client that displays comments matches a language specified for this parameter value. Comments must be in the form ISOLanguageCode:Comment. For example, -LocalizedComment EN-US:"This is a localized comment in US English."
LocalizedFolderName	Optional	Microsoft.Exchange.Data.MultiValuedProperty	The LocalizedFolderName parameter specifies localized folder names and their languages. Localized folder names are displayed instead of the default folder name when the language setting of Outlook 2007 matches a language specified for this parameter value. Comments must be in the form ISOLanguageCode:Comment. For example, -LocalizedFolderName EN-US:"This is a localized folder name in US English."
MustDisplayCommentEnabled	Optional	System.Boolean	If the MustDisplayCommentEnabled parameter is present and is set to $true, the parameter sets a flag that is used by any client that displays comments and accepts this setting. This prevents users from minimizing a folder comment, which is visible in Outlook 2007 only. If the parameter is not present or is set to $false, users can minimize the comment.
Name	Optional	System.String	The Name parameter specifies a unique name for the content settings. The Name parameter does not appear in users' mailboxes.
StorageQuota	Optional	Microsoft.Exchange.Data.Unlimited	The StorageQuota parameter specifies the storage size limit for the mailbox folder. When the folder size exceeds this limit, no additional items may be added. Mailbox sizes can be specified in kilobytes (KB) or megabytes (MB), for example, as 100 KB or 5 MB. The StorageQuota parameter is valid for managed custom folders in Outlook 2007.

Input Types

Return Types

Errors

Error	Description

Exceptions

Exceptions	Description

Example

In the first example, the Set-ManagedFolder command is used to set the storage quota for the managed folder named MyManagedFolder to 100 KB.

In the second example, which is three lines, the use of the Instance parameter is demonstrated by passing an instance of a managed folder, which is named My Managed Folder, to the Set-ManagedFolder command to set a new comment.

Set-ManagedFolder MyManagedFolder -StorageQuota 100KB

$a = Get-ManagedFolder "My Managed Folder"
$a.Comment = "This is a comment."
Set-ManagedFolder -Instance $a

Share via