Applies to: Exchange Server 2013
Topic Last Modified: 2013-02-19
In Microsoft Exchange Server 2013, messaging records management (MRM) is performed by using retention tags and retention policies. A retention policy is a group of retention tags that can be applied to a mailbox. For more details, see Retention Tags and Retention Policies. Managed folders, the MRM technology introduced in Exchange Server 2007, aren't supported.
A mailbox that has a managed folder mailbox policy applied can be migrated to use a retention policy. To do so, you must create retention tags that are equivalent to the managed folders linked to the user's managed folder mailbox policy.
Important: |
---|
Before you migrate from managed folders to retention policies in your production environment, we recommend that you test the process in a test environment. |
Tip: |
---|
You can place mailboxes on retention hold to halt processing of retention policies or managed folder mailbox policies. Placing mailboxes on retention hold can be helpful in migration scenarios to avoid deleting messages or moving them to archive until new policy settings have been tested on test mailboxes or a small number of production mailboxes. For details, see Place a Mailbox on Retention Hold. |
For other management tasks related to MRM, see Messaging Records Management Procedures.
Comparing retention tags to managed folders
Unlike managed folders, which require users to move items to a managed folder based on retention settings, retention tags can be applied to a folder or an individual item in the mailbox. This process has minimal impact on the user's workflow and email organization methods. When a folder has retention tags applied, all items in that folder inherit the retention settings. Users can further specify retention settings by applying different retention tags to individual items in that folder.
Managed folders support different managed content settings for a folder, each with a different message class (such as email items or calendar items). Retention tags don't require a separate managed content settings object because the retention settings are specified in the tag's properties. It isn't supported to create retention tags for particular message classes, with the exception of a default policy tag (DPT) for voicemail messages. Retention tags also don't allow you to use journaling performed by the Managed Folder Assistant.
Note: |
---|
Journal rules, which are used to send copies of messages with a journal report to a journaling mailbox, are enforced in the transport pipeline by the Journaling agent and are independent of MRM. For more details, see Journaling. |
The following table compares the MRM functionality available when using retention tags or managed folders.
Retention tags vs. managed folders
Functionality | Retention tags | Managed folders |
---|---|---|
Specify retention settings for default folders (such as Inbox) |
Use retention policy tags (RPTs) |
Use managed default folders |
Specify retention settings for entire mailbox |
Use a default policy tag (DPT) |
Use managed default folders |
Use retention settings for custom folders |
Use personal tags |
Using managed custom folders |
Require managed content settings |
No (retention settings included in a retention tag) |
Yes |
Use retention settings for different message classes (such as e-mail messages, voice mail, or calendar items) |
No |
Yes |
Support the Move To Archive action, which moves items to the user's archive mailbox |
Yes |
No |
Support the Move To Managed Folder action |
No |
Yes |
Allow journaling using the Managed Folder Assistant |
No |
Yes |
Policy applied to user |
Retention policy |
Managed folder mailbox policy |
Maximum number of policies that can be applied to a mailbox user |
1 |
1 |
Processed by the Managed Folder Assistant |
Yes |
Yes |
Client support |
Microsoft Outlook 2010 and Office Outlook Web App |
Outlook 2010, Office Outlook 2007, and Outlook Web App |
What do you need to know before you begin?
- Estimated time to complete: 20 minutes.
- Procedures in this topic require specific permissions. See each
procedure for its permissions information.
- You can't use the Exchange admin center (EAC) to create
retention tags based on retention policies.
- For information about keyboard shortcuts that may apply to the
procedures in this topic, see Keyboard Shortcuts in
the Exchange Admin Center.
Having problems? Ask for help in the Exchange forums. Visit the forums at: Exchange Server, Exchange Online, or Exchange Online Protection
Migrate mailbox users from managed folders
The following are general steps for migrating users from this managed folder mailbox policy to a retention policy. Each step is detailed later in this topic:
- Gather information about managed folder mailbox policies
applied to all Exchange 2010 and Exchange 2007 mailboxes, managed
folders in each policy and managed content settings for each
managed folder. You can use the EMC or the Shell on an Exchange
2010 or Exchange 2007 server to obtain this information.
- Create retention tags for the migration.
- Create a retention policy and link the newly created retention
tags to the policy.
- Remove the managed folder mailbox policy and then apply the
retention policy to user mailboxes.
Important: After you apply the retention policy to a user and the Managed Folder Assistant runs, the managed folders in the user's mailbox become unmanaged.
For the following procedures, Contoso mailboxes have a managed folder mailbox policy applied containing the following managed folders.
Managed folders for Contoso
Managed folder | Managed content settings | Retention enabled | Retention age | Retention action |
---|---|---|---|---|
Corp-DeletedItems |
CS-Corp-DeletedItems |
Yes |
30 days |
Delete and Allow Recovery |
Corp-SentItems |
CS-Corp-SentItems |
Yes |
1,825 days |
Move to Deleted Items |
Corp-JunkMail |
CS-Corp-JunkMail |
Yes |
30 days |
Permanently Delete |
Corp-EntireMailbox |
CS-Corp-EntireMailbox |
Yes |
365 days |
Move to Deleted Items |
30 Days |
CS-30Days |
Yes |
30 days |
Move to Deleted Items |
5 Years |
CS-5Years |
Yes |
1,825 days |
Move to Deleted Items |
Never Expire |
CS-NeverExpire |
No |
365 days |
Not applicable |
How do you do this?
Step 1: Create retention tags for the migration
You need to be assigned permissions before you can perform this procedure or procedures. To see what permissions you need, see the "Messaging records management" entry in the Messaging Policy and Compliance Permissions topic.
There are two methods you can use for this step:
- Create retention tags based on the managed folders and their
corresponding managed content settings With
this method, you use the New-RetentionPolicyTag cmdlet with
the ManagedFolderToUpgrade parameter. When you specify this
parameter, the corresponding retention tag is automatically applied
to the managed folder.
Important: If the managed folder you want to port has multiple managed content settings for different message classes, only one retention tag is created, and the highest retention age of all the managed content settings is used as the retention age for the ported tag, irrespective of the message class of the managed content settings.
For example, review the following managed content settings for the managed folder Corp-DeletedItems. - Create retention tags by manually specifying the retention
settings With this method, you use the
New-RetentionPolicyTag cmdlet without the
ManagedFolderToUpgrade parameter. When you don't specify
this parameter, any retention policy tags you add to the policy are
applied to the default folders, and the default policy tag is
applied to the entire mailbox. However, any personal tags you add
to the policy aren't automatically applied to the managed
folders.
Note: |
---|
If you are in a mixed environment with Exchange 2013 and Exchange 2010 servers, you can use the Port Managed Folder wizard in the Exchange Management Console (EMC) on an Exchange 2010 server to easily port managed folder and corresponding managed content setting to retention tags. |
Create retention tags based on managed folders
This example creates retention tags based on the corresponding managed content settings shown in the Contoso managed folder mailbox policy.
Copy Code | |
---|---|
New-RetentionPolicyTag Corp-DeletedItems -ManagedFolderToUpgrade Corp-DeletedItems New-RetentionPolicyTag Corp-SentItems -ManagedFolderToUpgrade Corp-SentItems New-RetentionPolicyTag Corp-JunkMail -ManagedFolderToUpgrade Corp-JunkMail New-RetentionPolicyTag Corp-EntireMailbox -ManagedFolderToUpgrade Corp-EntireMailbox New-RetentionPolicyTag 30Days -ManagedFolderToUpgrade 30Days New-RetentionPolicyTag 5Years -ManagedFolderToUpgrade 5Years New-RetentionPolicyTag NeverExpire -ManagedFolderToUpgrade NeverExpire |
For detailed syntax and parameter information, see New-RetentionPolicyTag.
Create retention tags manually
Note: |
---|
You can also use the EAC to create retention tags manually (not based on settings in managed folders). For details, see Create a Retention Policy. |
This example creates retention tags based on the managed folders and corresponding managed content settings shown in the Contoso managed folder mailbox policy. The retention settings are specified manually without using the ManagedFolderToUpgrade parameter.
Copy Code | |
---|---|
New-RetentionPolicyTag Corp-DeletedItems -Type DeletedItems -RetentionEnabled $true -AgeLimitForRetention 30 -RetentionAction DeleteAndAllowRecovery New-RetentionPolicyTag Corp-SentItems -Type SentItems -RetentionEnabled $true -AgeLimitforRetention 1825 -RetentionAction MoveToDeletedItems New-RetentionPolicyTag Corp-JunkMail -Type JunkMail -RetentionEnabled $true -AgeLimitforRetention 30 -RetentionAction PermanentlyDelete New-RetentionPolicyTag Corp-EntireMailbox -Type All -RetentionEnabled $true -AgeLimitForRetention 365 -RetentionAction MoveToDeletedItems New-RetentionPolicyTag 30Days -Type Personal -RetentionEnabled $true -AgeLimitForRetention 30 -RetentionAction MoveToDeletedItems New-RetentionPolicyTag 5Years -Type Personal -RetentionEnabled $true -AgeLimitForRetention 1825 -RetentionAction MoveToDeletedItems New-RetentionPolicyTag NeverExpire -Type Personal -RetentionEnabled $false |
For detailed syntax and parameter information, see New-RetentionPolicyTag.
Step 2: Create a retention policy
You need to be assigned permissions before you can perform this procedure or procedures. To see what permissions you need, see the "Messaging records management" entry in the Messaging Policy and Compliance Permissions topic.
Note: |
---|
You can also use the EAC to create a retention policy and add retention tags to the policy. For details, see Create a Retention Policy. |
This example creates the retention policy RP-Corp and links the newly created retention tags to the policy.
Copy Code | |
---|---|
New-RetentionPolicy RP-Corp -RetentionPolicyTagLinks Corp-DeletedItems,Corp-SentItems,Corp-JunkMail,Corp-EntireMailbox,30Days,NeverExpire |
For detailed syntax and parameter information, see New-RetentionPolicy.
Step 3: Remove the managed folder mailbox policy from user mailboxes
You need to be assigned permissions before you can perform this procedure or procedures. To see what permissions you need, see the "Applying retention policies" entry in the Messaging Policy and Compliance Permissions topic.
This example removes the managed folder mailbox policy and any managed folders from Ken Kwok's mailbox. Managed folders that have any messages are not removed.
Copy Code | |
---|---|
Set-Mailbox -Identity Kwok -RemovedManagedFolderAndPolicy RP-Corp |
Step 4: Apply the retention policy to user mailboxes
You need to be assigned permissions before you can perform this procedure or procedures. To see what permissions you need, see the "Applying retention policies" entry in the Messaging Policy and Compliance Permissions topic.
Note: |
---|
You can also use the EAC to apply a retention policy to users. For details, see Apply a Retention Policy to Mailboxes. |
This example applies the newly created retention policy RP-Corp to the mailbox user Ken Kwok.
Copy Code | |
---|---|
Set-Mailbox -Identity Kwok -RetentionPolicy RP-Corp |
For detailed syntax and parameter information, see Set-Mailbox.
How do you know this task worked?
To verify that you have migrated from managed folders to retention policies, do the following:
- Generate a report of all user mailboxes and the retention
policy applied to them.
This command retrieves the retention policy applied to all mailboxes in an organization, and their retention hold status.
Copy Code Get-Mailbox -ResultSize unlimited -Filter {Name -NotLike "DiscoverySearch*"} | Format-Table Name,RetentionPolicy,RetentionHoldEnabled -Auto
- After the Managed Folder Assistant has processed a mailbox with
a retention policy, use the Get-RetentionPolicyTag
cmdlet to retrieve the retention tags provisioned in the user
mailbox.
This command retrieves the retention tags actually applied to April Stewart's mailbox.
Copy Code Get-RetentionPolicyTag -Mailbox astewart