Compliance Problems

Fix an Exchange Online Retention Policy for a Shared Mailbox

Steven ParkerSteven Parker Nov 14, 2026 868 views

Question details

Determine why an Exchange Online retention policy is not moving older shared mailbox messages to the online archive.

Fix an Exchange Online Retention Policy for a Shared Mailbox
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.
Before you start

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.

Solution 1Recommended

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.

1
Connect to Exchange Online

Open PowerShell with the Exchange Online Management module installed and run Connect-ExchangeOnline. Sign in with an account authorized to manage the mailbox.

2
Inspect mailbox settings

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.

3
Verify the archive and license

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.

4
Review any retention hold

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.

5
Request processing

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.

Check the shared mailbox policy, retention hold, and archive
Processing is not immediate: Start-ManagedFolderAssistant requests processing; it does not guarantee that messages will move immediately. A retention hold is different from a legal or eDiscovery hold, which should not be changed without authorization.
Free Microsoft Office alternative

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.

Document shared mailbox retention checks and troubleshooting resultsOpen and edit Microsoft Word, Excel, and PowerPoint formats, including DOCX, XLSX, and PPTXUse a familiar interface for a smooth transition from Microsoft OfficeWork with a free, lightweight office suite
microsoft office alternative - wps office

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.