This browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Note
To proactively retain or delete mailbox content for data lifecycle management in Microsoft 365, we recommend that you use retention policies and retention labels from the Microsoft Purview portal, instead of messaging records management that's described on this page. However, you should continue using messaging records management to move messages to archive mailboxes.
If you currently use messaging records management, this older feature will continue to work side-by-side with retention policies and retention labels. However, we recommend that going forward, you use retention policies and retention labels instead. They provide you with a single mechanism to centrally manage both retention and deletion of content across Microsoft 365.
You can use retention policies 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.
Caution
Messages are expired based on settings defined in the retention tags linked to the policy. These settings include actions such moving messages to the 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.
For additional management tasks related to messaging records management (MRM), see Messaging Records Management Procedures.
Estimated time to complete: 5 minutes.
You need to be assigned permissions before you can perform this procedure or procedures. To see what permissions you need, see the "Retention policies" entry in the Feature permissions in Exchange Online topic.
Tip
Having problems? Ask for help in the Exchange forums. Visit the forums at Exchange Online or Exchange Online Protection.
Sign in to the new Exchange admin center and navigate to Recipients > Mailboxes.
In the list view, select the mailbox to which you want to apply the retention policy.
In the details panes for that mailbox, select Mailbox, and then for the Retention policy section, select Manage mailbox policies.
In the Mailbox policies pane, use the dropdown list box for Retention policy to select the policy you want to apply to the mailbox, and then select Save.
Sign in to the new Exchange admin center and navigate to Recipients > Mailboxes.
In the list view, select the multiple mailboxes to apply the same retention policy.
Above the list view, select ... for more options, and select Mailbox policies.
In the Mailbox policies pane, use the dropdown list box for Retention policy to select the policy you want to apply to the multiple mailboxes, and then select Save.
The following example applies the retention policy RP-Finance to Morris's mailbox:
Set-Mailbox "Morris" -RetentionPolicy "RP-Finance"
For detailed syntax and parameter information, see Set-Mailbox.
The following 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"
The following example applies the retention policy RetentionPolicy-Corp to all mailboxes in the Exchange organization:
Get-Mailbox -ResultSize unlimited | Set-Mailbox -RetentionPolicy "RetentionPolicy-Corp"
The following example applies the retention policy RetentionPolicy-Finance to all mailboxes in the Finance organizational unit:
Get-Mailbox -OrganizationalUnit "Finance" -ResultSize Unlimited | Set-Mailbox -RetentionPolicy "RetentionPolicy-Finance"
For detailed syntax and parameter information, see Get-Mailbox and Set-Mailbox.
To verify that you have applied the retention policy, run the Get-Mailbox cmdlet to retrieve the retention policy for the mailbox or mailboxes.
The following example retrieves the retention policy for Morris's mailbox:
Get-Mailbox Morris | Select RetentionPolicy
The following command retrieves all mailboxes that have the retention policy RP-Finance applied:
Get-Mailbox -ResultSize unlimited | Where-Object {$_.RetentionPolicy -eq "RP-Finance"} | Format-Table Name,RetentionPolicy -Auto
Training
Module
Manage data retention and deletion in Microsoft 365 workloads - Training
Manage data retention and deletion in Microsoft 365 workloads
Certification
Microsoft Certified: Information Protection and Compliance Administrator Associate - Certifications
Demonstrate the fundamentals of data security, lifecycle management, information security, and compliance to protect a Microsoft 365 deployment.
Documentation
Default Retention Policy in Exchange Online
Exchange creates the retention policy Default MRM Policy in your Exchange Online and on-premises Exchange organization. The policy is automatically applied to new users in Exchange Online. In on-premises organizations, the policy is applied when you create an archive for the mailbox. You can change the retention policy applied to a user at any time.
Create a Retention Policy in Exchange Online
In Exchange Online, you can use retention policies to manage email lifecycle. Retention policies are applied by creating retention tags, adding them to a retention policy, and applying the policy to mailbox users.
Retention tags and retention policies in Exchange Online
In Microsoft Exchange Server and Exchange Online, Messaging records management (MRM) helps organizations to manage email lifecycle and reduce legal risks associated with e-mail and other communications. MRM makes it easier to keep messages needed to comply with company policy, government regulations, or legal needs, and to remove content that has no legal or business value.