Fix an Exchange Online Retention Policy for a Shared Mailbox
Question details
Determine why an Exchange Online retention policy is not moving older shared mailbox messages to the online archive.

- Product
- Microsoft Exchange Online
- Device & OS
- not provided
- Scenario
- An administrator wants a shared mailbox retention policy to move eligible older messages to its enabled online archive.
- Observed behavior
- The mailbox has an Exchange Online Plan 2 license and an enabled archive, but the policy does not appear to process messages even after Start-ManagedFolderAssistant runs.
Have the shared mailbox address and access to the Exchange admin center and Exchange Online PowerShell ready. Confirm that the policy you are investigating is an Exchange mailbox retention policy with a Move to Archive tag, not only a Microsoft Purview retention policy.
Check the shared mailbox policy, retention hold, and archive
Use Exchange Online PowerShell to identify mailbox settings that can prevent the Managed Folder Assistant from moving messages.
Open PowerShell with the Exchange Online Management module installed and run Connect-ExchangeOnline. Sign in with an account authorized to manage the mailbox.
Run Get-Mailbox -Identity shared@contoso.com | Format-List RetentionPolicy,RetentionHoldEnabled,ArchiveStatus,ArchiveName, replacing the example address with the shared mailbox address. Note the assigned policy, hold status, and archive status.
In the Exchange admin center, open Recipients > Mailboxes, select the shared mailbox, and check its archive status. In the Microsoft 365 admin center, check the mailbox account's license; verify that it supports the archive features and capacity in use.
If RetentionHoldEnabled is True, ask the appropriate administrator whether it can be removed. Only if organizational policy permits it, run Set-Mailbox -Identity shared@contoso.com -RetentionHoldEnabled $false.
After correcting any settings, run Start-ManagedFolderAssistant -Identity shared@contoso.com. Allow time for background processing, then check whether eligible messages have moved to the online archive.

Verify the archive tag and affected folders
Use this check when the mailbox settings look correct but messages still remain in the primary mailbox, or only certain folders are affected.
Use WPS Office for Mailbox Policy Documentation
WPS Office is a free, lightweight alternative for documenting mailbox settings and troubleshooting results. Its familiar interface and Microsoft Office format support make it easy to move existing files into your workflow. It does not manage Exchange Online retention policies.

Frequently Asked Questions
Why did Start-ManagedFolderAssistant not move messages immediately?
The command requests background processing rather than an immediate move. Check the assigned policy, retention hold, archive status, and tag eligibility, then allow time before checking the mailbox again.
How do I find the retention policy assigned to a shared mailbox?
In Exchange Online PowerShell, run Get-Mailbox -Identity shared@contoso.com | Format-List RetentionPolicy, replacing the address with the shared mailbox address.
Does every retention tag move messages to the archive?
No. Inspect the tag with Get-RetentionPolicyTag and check RetentionAction, RetentionEnabled, and AgeLimitForRetention. The relevant enabled tag must use MoveToArchive and apply to the messages or folder.
Should I remove a retention hold to make the policy work?
First confirm why the hold is in place and obtain authorization under your organization's policy. If removal is permitted, an authorized administrator can use Set-Mailbox -Identity shared@contoso.com -RetentionHoldEnabled $false.
Can a Microsoft Purview retention policy move messages to the online archive?
A Purview retention policy is used for retention and deletion, not for the Exchange mailbox Move to Archive action. Check the mailbox's Exchange retention policy and its linked archive tags instead.




