Exchange Online Gets New Tool to Simplify Retention Hold Removal for Inactive Mailboxes

Microsoft is simplifying inactive mailbox management in Exchange Online with a new ExcludeFromAllHolds capability. This feature lets administrators efficiently remove unnecessary retention holds while preserving essential compliance protections.

Microsoft has added the ExcludeFromAllHolds parameter to the Set-Mailbox cmdlet in Exchange Online. This new option allows administrators to remove most retention-related holds from inactive mailboxes in a single operation. It supports the removal of holds applied through organization-wide retention policies, user-specific retention policies, compliance tags, delay holds, and delay-release holds.

“When managing inactive mailboxes in Microsoft Exchange Online, administrators often need to remove holds to allow for permanent deletion while maintaining compliance requirements,” the Exchange team explained. “This parameter is intended for scenarios where unnecessary retention holds need to be removed so that mailboxes can be permanently deleted, provided no legal holds or restrictive retention holds are applied as the cmdlet continues to respect legal holds required for regulatory compliance.”

Which retention holds are removed—and which remain

However, this parameter does not remove compliance-critical holds such as eDiscovery holds, litigation hold, or restrictive retention policies. These safeguards remain in place to protect legal and regulatory obligations.

For more targeted scenarios, Microsoft continues to support the RemoveComplianceTagHold switch, which removes only compliance tag holds without affecting other retention mechanisms. This gives administrators more granular control when adjusting retention enforcement.

How do mailbox-level hold exclusions work?

Microsoft clarified that the new parameter does not delete retention policies themselves. Instead, it applies mailbox-level exclusions so the Managed Folder Assistant skips those rules. These exclusions appear in the mailbox’s InPlaceHolds property and are identified by -mbx prefixes.

This feature is designed to simplify lifecycle management for inactive mailboxes that no longer require most retention holds. Administrators can clean up mailboxes in bulk and permanently delete them once they reach a soft-deleted state. This helps reduce licensing usage, lowers administrative overhead, and improves compliance hygiene by eliminating outdated holds.

PowerShell requirements and RBAC permissions

The ExcludeFromAllHolds parameter is available only through Exchange Online PowerShell and applies exclusively to mailboxes that are already soft-deleted and inactive. It cannot be used on active mailboxes, public folders, room mailboxes, or fully deleted accounts. Administrators must also have the appropriate RBAC roles, including Mailbox Import Export, Retention Management, and eDiscovery Manager.

Microsoft advises organizations to carefully assess compliance risks and test this feature before large-scale use. Common issues include insufficient permissions and mailboxes that are not properly marked as inactive. For bulk operations, Microsoft recommends running commands in batches to avoid throttling. Once applied, changes typically propagate within minutes, and the cmdlet also clears orphaned hold entries to further streamline cleanup.