Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The default Exchange retention policy—named Default MRM Policy—that automatically applied to new mailboxes in Exchange Online contains a retention tag named Recoverable Items 14 days move to archive. This retention tag moves items from the Recoverable Items folder in the user's primary mailbox to the Recoverable Items folder in the user's archive mailbox after the 14-day retention period expires for an item.
Tip
Get started with Microsoft Security Copilot to explore new ways to work smarter and faster using the power of AI. Learn more about Microsoft Security Copilot in Microsoft Purview.
Emails in the Deletions folder retain based on the RetainDeletedItemsFor parameter and move to other folders in recoverable deleted items and then to the archive mailbox. For this process to work, the user's archive mailbox must be enabled. If the archive mailbox isn't enabled, no action is taken, which means that items in the Recoverable Items folder for a mailbox on hold aren't moved to the archive mailbox after the 14-day retention period expires. Because nothing is deleted from a mailbox on hold, it's possible that the storage quota for the Recoverable Items folder might be exceeded, especially if the user's archive mailbox isn't enabled. For information about deleting items from the Recoverable Items folder, see Delete Recoverable Items from mailboxes on hold.
To help reduce the chance of exceeding this limit, the storage quota for the Recoverable Items folder automatically increases from 30 GB to 100 GB when a hold is placed on a mailbox in Exchange Online. If the archive mailbox is enabled, the storage quota for the Recoverable Items folder in the archive mailbox also increases from 30 GB to 100 GB. If archive is enabled on a mailbox that is on hold with auto-expanding archive disabled, the storage quota of the Recoverable Items folder quota increases from 100 GB to 105 GB. If the auto-expanding archiving feature in Exchange Online is enabled, the total storage quota for the user's archive mailbox, including the Recoverable Items folder, is 1.5 TB.
The following table summarizes the storage quota for the Recoverable Items folder.
| Location of Recoverable Items folder | Mailboxes not on hold | Mailboxes on hold |
|---|---|---|
| Primary mailbox | 30 GB | 100 GB |
| Archive mailbox, including Recoverable Items folder * | 1.5 TB | 1.5 TB |
Note
* The initial storage quota for the archive mailbox is 100 GB for users with an Exchange Online (Plan 2) license. However, when auto-expanding archiving is turned on for mailboxes on hold, the storage quota for both the archive mailbox and the Recoverable Items folder increases to 110 GB. Additional archive storage space (which includes the Recoverable Items folder) up to 1.5 TB is provisioned when necessary. For more information about auto-expanding archiving, see Learn about auto-expanding archiving.
Note
When archiving is enabled for a specific user whose mailbox is on hold or assigned to a retention policy, the storage quota for the user's primary mailbox's Recoverable Items folder raises from 100 GB to 105 GB and Recoverable items warning quota raises from 90 GB to 95 GB. This extra space supports an efficient archiving experience for users, even if auto-expanding archive isn't enabled.
When the storage quota for the Recoverable Items folder in the primary mailbox of a mailbox on hold is close to reaching its limit, you can do the following things:
Enable the archive mailbox and turn on auto-expanding archiving. You can enable an extra storage capacity for the Recoverable Items folder by enabling the archive mailbox and then turning on the auto-expanding archiving feature in Exchange Online. This change results in 110 GB for the Recoverable Items folder in the primary mailbox and up to 1.5 TB of combined storage capacity for the archive and Recoverable Items folder. For more information, see Enable archive mailboxes and Enable auto-expanding archiving.
Note
After you enable the archive for a mailbox that's close to exceeding the storage quota for the Recoverable Items folder, you might want to run the Managed Folder Assistant to manually trigger the assistant to process the mailbox so that expired items move to the Recoverable Items folder in the archive mailbox. See Step 4 for instructions. Other items in the user's mailbox might move to the new archive mailbox. Consider telling the user that this change might happen after you enable the archive mailbox.
Create a custom Exchange retention policy for mailboxes on hold. In addition to enabling the archive mailbox and auto-expanding archiving for mailboxes on Litigation Hold, you might also want to create a custom Exchange retention policy for mailboxes on hold. This policy lets you apply a retention policy to mailboxes on hold that's different from the Default MRM Policy that's applied to mailboxes that aren't on hold, and lets you apply retention tags that are designed for mailboxes on hold. This policy includes creating a new retention tag for the Recoverable Items folder.
The rest of this article describes the step-by-step procedures to create a custom Exchange retention policy for mailboxes on hold.
- Step 1: Create a custom retention tag for the Recoverable Items folder
- Step 2: Create a new Exchange retention policy for mailboxes on hold
- Step 3: Apply the new Exchange retention policy to mailboxes on hold
- (Optional) Step 4: Run the Managed Folder Assistant to apply the new retention settings
Step 1: Create a custom retention tag for the Recoverable Items folder
First, create a custom retention tag (called a retention policy tag or RPT) for the Recoverable Items folder. This RPT moves items from the Recoverable Items folder in the user's primary mailbox to the Recoverable Items folder in the user's archive mailbox. Use PowerShell to create an RPT for the Recoverable Items folder. You can't use the Exchange admin center (EAC).
Run the following command to create a new RPT for the Recoverable Items folder:
New-RetentionPolicyTag -Name <Name of RPT> -Type RecoverableItems -AgeLimitForRetention <Number of days> -RetentionAction MoveToArchiveFor example, the following command creates an RPT for the Recoverable Items folder named "Recoverable Items 30 days for mailboxes on hold", with a retention period of 30 days. This means that after an item has been in the Recoverable Items folder for 30 days, it's moved to the Recoverable Items folder in the user's archive mailbox.
New-RetentionPolicyTag -Name "Recoverable Items 30 days for mailboxes on hold" -Type RecoverableItems -AgeLimitForRetention 30 -RetentionAction MoveToArchiveTip
Set the retention period (defined by the AgeLimitForRetention parameter) for the Recoverable Items RPT to match the deleted item retention period for the mailboxes that the RPT applies to. This setup gives users the entire deleted item retention period to recover deleted items before they're moved to the archive mailbox. In the previous example, the retention period was set to 30 days based on the assumption that the deleted item retention period for mailboxes is also 30 days. An Exchange Online mailbox is configured to retain deleted items for 14 days, by default. But you can change this setting to a maximum of 30 days. For more information, see Change the deleted item retention period for a mailbox in Exchange Online.
Step 2: Create a new Exchange retention policy for mailboxes on hold
Next, create a new retention policy and add retention tags to it, including the Recoverable Items RPT that you created in Step 1. In the next step, apply this new policy to mailboxes on hold.
Before you create the new retention policy, determine the additional retention tags that you want to add. For a list of the retention tags that are added to the Default MRM Policy and for information about creating new retention tags, see the following:
- Default Retention Policy in Exchange Online
- Default folders that support Retention Policy Tags
- The "Create a retention tag" section in the Create a Retention Policy article.
You can use the EAC or Exchange Online PowerShell to create a retention policy.
Use the EAC to create a retention policy
- In the EAC, go to Compliance management > Retention policies, and then select Add
. - On New retention policy, under Name, type a name that describes the purpose of the retention policy; for example, MRM Policy for Mailboxes on Hold.
- Under Retention tags, select Add
. - In the list of retention tags, select the Recoverable Items RPT that you created in Step 1, and then select Add.
- Select additional retention tags to add to the retention policy. For example, you might want to add the same tags that are included in the Default MRM Policy.
- When you finish adding retention tags, select OK.
- Select Save to create the new retention policy. The details pane displays the retention tags linked to the retention policy.
Use Exchange Online PowerShell to create a retention policy
Run the following command to create new retention policy for mailboxes on hold.
New-RetentionPolicy <Name of retention policy> -RetentionPolicyTagLinks <list of retention tags>
For example, the following command creates the retention policy and linked retention tags that are displayed in the previous illustration.
New-RetentionPolicy "MRM Policy for Mailboxes on Hold" -RetentionPolicyTagLinks "Recoverable Items 30 days for mailboxes on hold","1 Month Delete","1 Week Delete","1 Year Delete","5 Year Delete","6 Month Delete","Default 2 year move to archive","Junk Email","Never Delete","Personal 1 year move to archive","Personal 5 year move to archive"
Step 3: Apply the new Exchange retention policy to mailboxes on hold
In the last step, apply the new retention policy that you created in Step 2 to mailboxes on hold in your organization. You can use the EAC or Exchange Online PowerShell to apply the retention policy to a single mailbox or to multiple mailboxes.
Use the EAC to apply the new retention policy
- Go to Recipients > Mailboxes.
- In the list view, select the mailbox you want to apply the retention policy to, then select Edit.
- On the User Mailbox page, select Mailbox features.
- Under Retention policy, select the retention policy that you created in Step 2, then select Save.
You can also use the EAC to apply the retention policy to multiple mailboxes.
- Go to Recipients > Mailboxes.
- In the list view, use the Shift or Ctrl keys to select multiple mailboxes.
- In the details pane, select More options.
- Under Retention Policy, select Update.
- On the Bulk assign retention policy page, select the retention policy that you created in Step 2, then select Save.
Use Exchange Online PowerShell to apply the new retention policy
You can use Exchange Online PowerShell to apply a new retention policy to a single mailbox. But the real power of PowerShell is that you can use it to quickly identify all the mailboxes in your organization that are on Litigation Hold, and then apply the new retention policy to all mailboxes on hold in a single command. Here are some examples of using Exchange PowerShell to apply a retention policy to one or more mailboxes. All of the examples apply the retention policy that you created in Step 2.
This example applies the new retention policy to Pilar Pinilla's mailbox.
Set-Mailbox "Pilar Pinilla" -RetentionPolicy "MRM Policy for Mailboxes on Hold"
This example applies the new retention policy to all mailboxes in the organization that are on Litigation Hold.
$LitigationHolds = Get-Mailbox -ResultSize unlimited | Where-Object {$_.LitigationHoldEnabled -eq 'True'}
$LitigationHolds.DistinguishedName | Set-Mailbox -RetentionPolicy "MRM Policy for Mailboxes on Hold"
You can use the Get-Mailbox cmdlet to verify that you applied the new retention policy.
Here are some examples to verify that the commands in the previous examples applied the "MRM Policy for Mailboxes on Hold" retention policy to mailboxes on Litigation Hold.
Get-Mailbox "Pilar Pinilla" | Select RetentionPolicy
Get-Mailbox -ResultSize unlimited | Where-Object {$_.LitigationHoldEnabled -eq 'True'} | FT DisplayName,RetentionPolicy -Auto
(Optional) Step 4: Run the Managed Folder Assistant to apply the new retention settings
After you apply the new Exchange retention policy to mailboxes on hold, it can take up to seven days in Exchange Online for the Managed Folder Assistant to process these mailboxes by using the settings in the new retention policy. Instead of waiting for the Managed Folder Assistant to run, you can use the Start-ManagedFolderAssistant cmdlet to manually trigger the assistant to process the mailboxes that you applied the new retention policy to.
Run the following command to start the Managed Folder Assistant for Pilar Pinilla's mailbox.
Start-ManagedFolderAssistant "Pilar Pinilla"
Run the following commands to start the Managed Folder Assistant for all mailboxes on hold.
$MailboxesOnHold = Get-Mailbox -ResultSize unlimited | Where-Object {($_.InPlaceHolds -ne $null) -or ($_.LitigationHoldEnabled -eq "True")}
$MailboxesOnHold.DistinguishedName | Start-ManagedFolderAssistant
More information
- When you enable a user's archive mailbox, consider telling the user that other items in their mailbox (not just items in the Recoverable Items folder) might move to the archive mailbox. This behavior occurs because the Default MRM Policy that's assigned to Exchange Online mailboxes contains a retention tag (named Default 2 years move to archive) that moves items to the archive mailbox two years after the date the item is delivered to the mailbox or created by the user. For more information, see Default Retention Policy in Exchange Online.
- When you enable a user's archive mailbox, consider telling the user that they can recover deleted items in the Recoverable Items folder in their archive mailbox. They can do this in Outlook by selecting the Deleted Items folder in the archive mailbox, then selecting Recover Deleted Items from Server on the Home tab. For more information about recovering deleted items, see Recover deleted items in Outlook for Windows.