Add or Remove Retention Tags from a Retention Policy

  • Article

 

Applies to: Exchange Server 2010 SP3, Exchange Server 2010 SP2

You can add retention tags to a retention policy when the policy is created or any time thereafter. For details about how to create a retention policy, including how to simultaneously add retention tags, see Create a Retention Policy.

A retention policy can contain the following retention tags:

  • One or more retention policy tags (RPTs) for supported default folders

  • One default policy tag (DPT) with the Move to Archive action.

  • One DPT with the Delete and Allow Recovery or the Permanently Delete action

  • One DPT for voice mail

  • Any number of personal tags

Note

Retention tags aren't applied to a mailbox until they're linked to a retention policy and the Managed Folder Assistant processes the mailbox. To learn more about the Managed Folder Assistant, see Configure the Managed Folder Assistant.

Looking for other management tasks related to messaging records management (MRM)? Check out Deploying Messaging Records Management.

Use the EMC to add retention tags to or remove retention tags from a retention policy

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Messaging records management" entry in the Mailbox Permissions topic.

  1. In the console tree, navigate to Organization Configuration > Mailbox.

  2. In the result pane, on the Retention Policies tab, select the retention policy to which you want to add retention tags.

  3. In the action pane, click Properties.

  4. In <Retention policy name> Properties, on the General tab, use the following settings:

    • Add   Click this button to add a retention tag to the policy.

    • Remove icon   Select a tag from the list, and then click this button to remove the tag from the policy.

Use the Shell to add retention tags to or remove retention tags from a retention policy

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Messaging records management" entry in the Mailbox Permissions topic.

This example adds the retention tags VPs-Default, VPs-Inbox, and VPs-DeletedItems to the retention policy RetPolicy-VPs, which doesn't already have retention tags linked to it.

Warning

If the policy has retention tags linked to it, this command replaces the existing tags.

Set-RetentionPolicy -Identity "RetPolicy-VPs" -RetentionPolicyTagLinks "VPs-Default","VPs-Inbox","VPs-DeletedItems"

This example adds the retention tag VPs-DeletedItems to the retention policy RetPolicy-VPs, which already has other retention tags linked to it.

$TagList = (Get-RetentionPolicy "RetPolicy-VPs").RetentionPolicyTagLinks
$TagList.Add((Get-RetentionPolicyTag 'VPs-DeletedItems').DistinguishedName)
Set-RetentionPolicy "RetPolicy-VPs" -RetentionPolicyTagLinks $TagList

This example removes the retention tag VPs-Inbox from the retention policy RetPolicy-VPs.

$TagList = (Get-RetentionPolicy "RetPolicy-VPs").RetentionPolicyTagLinks
$TagList.Remove((Get-RetentionPolicyTag 'VPs-Inbox').DistinguishedName)
Set-RetentionPolicy "RetPolicy-VPs" -RetentionPolicyTagLinks $TagList

For detailed syntax and parameter information, see the following topics:

Other Tasks

After you link retention tags to a retention policy, you may also want to:

 © 2010 Microsoft Corporation. All rights reserved.