Set-ManagedFolder

Článek
09/29/2015

Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

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

Syntax

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

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

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.
Confirm	Optional	System.Management.Automation.SwitchParameter	The Confirm parameter causes the command to pause processing and requires you to acknowledge what the command will do before processing continues. You don't have to specify a value with the Confirm parameter.
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.
BaseFolderOnly	Optional	System.Boolean	The BaseFolderOnly parameter allows you to control the message retention period for individual subfolders by using managed content settings. Setting this flag to True on a root folder prevents the managed folder assistant from applying mailbox policy to the content of subfolders of the root folder.
WhatIf	Optional	System.Management.Automation.SwitchParameter	The WhatIf parameter instructs the command to simulate the actions that it would take on the object. By using the WhatIf parameter, you can view what changes would occur without having to apply any of those changes. You don't have to specify a value with the WhatIf parameter.

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

Sdílet prostřednictvím