New-ManagedFolder: Exchange 2007 Help

New-ManagedFolder: Exchange 2007 He...

Collapse All

New-ManagedFolder

Applies to: Exchange Server 2007 SP2, Exchange Server 2007 SP1 Topic Last Modified: 2009-05-14

Use the New-ManagedFolder cmdlet to create new managed folders for messaging records management (MRM). A managed folder is a folder in a user's mailbox to which MRM has been applied. The following are the managed folder types:

Managed default folders (such as the Inbox) appear, by default, in a user's Microsoft Office Outlook 2007 mailbox. Managed default folders require only an Exchange Server Standard client access license (CAL).
Managed custom folders are created by Exchange administrators specifically for MRM. Managed custom folders are a premium feature of MRM. Each mailbox that has managed custom folders requires an Exchange Server Enterprise CAL.

The retention and journaling of messages in managed folders are controlled by managed content settings that are applied to the managed folders.

Syntax


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


New-ManagedFolder -Name <String> -DefaultFolderType <Nullable> [-BaseFolderOnly <$true | $false>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-LocalizedComment <MultiValuedProperty>] [-MustDisplayCommentEnabled <$true | $false>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

Parameters

Parameter	Required	Type	Description
DefaultFolderType	Required	System.Nullable	The DefaultFolderType parameter specifies which type of default folder to create (for example, an additional Inbox folder). When you have multiple copies of a default folder, you can assign different content settings to each one. For example, you could have two Inbox folders, one for which the contents are retained for one month, and a second for which the contents are retained for one year. You must assign a unique name (using the Name parameter) to each of the multiple managed default folders. If a value in not entered for the DefaultFolderType parameter, a managed custom folder is created. The folder types that you can specify are: Calendar Contacts DeletedItems Drafts Inbox JunkEmail Journal Notes Outbox SentItems Tasks All ManagedCustomFolder RssSubscriptions SyncIssues ConversationHistory
FolderName	Required	System.String	The FolderName parameter specifies the name of the folder as it will appear in users' mailboxes. You cannot set the FolderName value for managed default folders. This string can be up to 255 characters long. Note: The FolderName parameter should not be confused with the Name parameter.
Name	Required	System.String	The Name parameter specifies a unique name for the folder. This value is used by the administrator as a handle for the folder. It does not appear in users' mailboxes. This string can be up to 65 characters long. Note: The Name parameter should not be confused with the FolderName parameter.
BaseFolderOnly	Optional	System.Boolean	The BaseFolderOnly parameter is used to prevent managed folder assistant from applying mailbox policy to the content of subfolders of the managed folder.
Comment	Optional	System.String	The Comment parameter specifies the default administrator comment to be displayed with the folder in Microsoft Outlook 2007 and Outlook Web Access. This string can be up to 255 characters long.
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 Active Directory, include the DomainController parameter in 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 Outlook 2007 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 Outlook 2007 to prevent users from minimizing a folder comment (that is visible in Outlook 2007 and Outlook Web Access). If the parameter is not present or is set to $false, users can minimize the comment.
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).
TemplateInstance	Optional	System.Management.Automation.PSObject	When an existing object is supplied to the TemplateInstance parameter, the command uses the configuration of that object to create an exact duplicate of the object on a local or target server.
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.

Detailed Description

Use the New-ManagedFolder cmdlet to create a new managed folder in the Active Directory directory service. Then, to use the new managed folder for messaging records management:

Apply managed content settings to the folder.
Link the folder to a managed folder mailbox policy.
Link the mailbox policy to a user's mailbox.
Run the managed folder assistant, which places the new managed folder in the user's mailbox with the settings that you have specified.
For more information about the steps to take to implement messaging records management in Microsoft Exchange Server 2007, see Deploying Messaging Records Management.

By default, managed custom folders are created with this cmdlet. However, you can also create additional copies of managed default folders by using the DefaultFolderType parameter to specify which type of default folder to create (for example, an additional Inbox folder). When you create multiple copies of a managed default folder, you can assign different content settings to each one. For example, you could have two Inbox folders, one named InboxSixMonths and another named InboxOneYear. Then, you could assign a retention time of six months to the first folder and one year to the second folder with the New-ManagedContentSettings cmdlet (or by using the New Managed Content Settings wizard in the Exchange Management Console). You must assign a unique name (using the Name parameter) to each of the managed default folders that you create. Users, however, always see the unaltered default folder name. In the example, whether users are assigned an InboxSixMonths folder or an InboxOneYear folder, the Inbox that they see in their mailbox will be labeled Inbox. Although the folder names that users see in their mailboxes can be reassigned for managed custom folders (using the Set-ManagedFolder command FolderName parameter), the folder names seen by users for managed default folders cannot be changed.

Before You Begin

To run the New-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.

This command does not accept pipelined input.

Input Types

Return Types

Errors

Error	Description

Exceptions

Exceptions	Description

Example

In the first example, the New-ManagedFolder command is used to create a new managed folder that has a maximum capacity of 1 MB.

In the second example, the New-ManagedFolder command is used to create a new managed folder that has a default folder name and comment in English, localized folder names in Spanish and French, and localized comment in Spanish.

In the third example, a new instance of the Inbox default folder is created.

New-ManagedFolder -Name NewFolder -FolderName "New Folder" -StorageQuota "1 MB"
New-ManagedFolder -Name MyFolder -FolderName "My Folder" -LocalizedFolderName Spanish:"Mi Carpeta", French:"Mon Dossier" -Comment "My comment" -LocalizedComment Spanish:"Mi comentario", French:"Mon annotation"
New-ManagedFolder -Name AnotherInbox -DefaultFolderType Inbox