Export (0) Print
Expand All

Apply a Retention Policy to Mailboxes

Applies to: Exchange Server 2010

Topic Last Modified: 2011-03-19

Retention policies allow you to group one or more retention tags and apply them to mailboxes to enforce message retention settings. A mailbox can't have more than one retention policy.

Dd298052.Caution(en-us,EXCHG.140).gifCaution:
Messages are expired based on settings defined in the retention tags linked to the policy. These settings include actions such moving messages to the personal archive or permanently deleting them. Before applying a retention policy to one or more mailboxes, we recommended that you test the policy and inspect each retention tag associated with it.

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

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Applying retention policies" entry in the Messaging Policy and Compliance Permissions topic.

Dd298052.note(en-us,EXCHG.140).gifNote:
You can't use the EMC to apply a retention policy to a mailbox.

This example applies the retention policy RP-Finance to Bharat's mailbox:

Set-Mailbox "Bharat" -RetentionPolicy "RP-Finance"

For detailed syntax and parameter information, see Set-Mailbox.

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Applying retention policies" entry in the Messaging Policy and Compliance Permissions topic.

Dd298052.note(en-us,EXCHG.140).gifNote:
You can't use the EMC to apply a retention policy to members of a distribution group.

This example applies the Retention policy RP-Finance to members of the distribution group DG-Finance:

Get-DistributionGroupMember -Identity "DG-Finance" | Set-Mailbox -RetentionPolicy "RP-Finance"
Dd298052.note(en-us,EXCHG.140).gifNote:
This is a one-time operation. When users are added to or removed from the distribution group, their retention policy doesn't change automatically. To make sure the policy is applied to new group members, you can schedule the command to be automatically run at a regular interval.

For detailed syntax and parameter information, see Get-DistributionGroupMember and Set-Mailbox.

You need to be assigned permissions before you can perform this procedure. To see what permissions you need, see the "Applying retention policies" entry in the Messaging Policy and Compliance Permissions topic.

Dd298052.note(en-us,EXCHG.140).gifNote:
You can't use the EMC to change the retention policy of mailboxes.

This example applies the new retention policy New-Retention-Policy to all mailboxes that have the old policy Old-Retention-Policy.

$OldPolicy={Get-RetentionPolicy "Old-Retention-Policy"}.distinguishedName
Get-Mailbox -Filter {RetentionPolicy -eq $OldPolicy} -Resultsize Unlimited | Set-Mailbox -RetentionPolicy "New-Retention-Policy"

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

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft