Exchange Online In-Place Archive Troubleshooting Guide
When an Exchange Online archive does not move mail, the issue is usually policy scope, folder tag behavior, Managed Folder Assistant timing, mailbox size, or a misunderstanding of what “archive enabled” actually means.
1. Connect and verify archive state
Connect-ExchangeOnline
Get-Mailbox user@company.com | Format-List DisplayName,ArchiveStatus,ArchiveState,ArchiveName,RetentionPolicy
Get-MailboxStatistics user@company.com -Archive | Format-List DisplayName,ItemCount,TotalItemSizeIf ArchiveStatus is not active, the mailbox does not have an active archive target. For shared mailboxes, also verify licensing and archive eligibility before assuming policy failure.
2. Check retention policy and tags
$policy = (Get-Mailbox user@company.com).RetentionPolicy
Get-RetentionPolicy $policy | Select-Object -ExpandProperty RetentionPolicyTagLinks
Get-RetentionPolicyTag | Where-Object {$_.RetentionAction -eq 'MoveToArchive'} | Format-Table Name,Type,AgeLimitForRetention,RetentionEnabledA default archive tag can move mailbox content after the age limit. A personal tag can be applied to a folder. A folder with a delete tag will not behave like an archive tag. Confirm the actual tag assigned to the folder or mailbox before changing anything.
3. Start Managed Folder Assistant
Start-ManagedFolderAssistant -Identity user@company.comThis requests processing. It is not an immediate “move everything now” button. Large mailboxes can take time, and Microsoft 365 background processing is not always immediate.
4. Common reasons nothing moved
| Symptom | What to check |
|---|---|
| Archive active but empty | Retention policy has no move-to-archive tag or the item age does not qualify yet. |
| One folder will not move | Folder has no personal archive tag or the wrong tag was applied. |
| Shared mailbox archive stuck | Licensing, quota, or assistant processing delay. |
| Policy recently changed | Wait for policy propagation and assistant processing. |
| Only some items move | Item age, retention hold, litigation hold, or folder-specific tags. |
5. Field notes for operations teams
Do not promise users that archive changes are immediate. Give them a window, record the commands used, and verify with mailbox statistics. For high-volume shared mailboxes, create a simple runbook that captures current item count, archive item count, policy name, archive tag name, and the date you requested Managed Folder Assistant processing.