dlm-diagnostics

name

dlm-diagnostics

description

Diagnose Microsoft Purview Data Lifecycle Management (DLM) issues in Exchange Online. Use this skill when a user reports: retention policy not applying to workloads, retention policy stuck in Error or PendingDeletion, items not moving from primary mailbox to archive, auto-expanding archive not provisioning additional storage, inactive mailbox not created after user deletion, Recoverable Items or SubstrateHolds folder growing uncontrollably, Teams messages not being deleted after retention period expires, MRM and Purview retention conflicting causing unexpected deletion or retention, adaptive scope including wrong members or not populating, or auto-apply retention labels not labeling content or showing Off Error status. Requires Exchange Online and Security & Compliance PowerShell sessions.

DLM Diagnostics

Investigate and resolve Microsoft Purview Data Lifecycle Management issues in Exchange Online. Follow the decision tree below to identify the correct troubleshooting guide, then load the matching reference file for step-by-step diagnostic instructions.

Prerequisites

Before running any diagnostic commands, ensure both PowerShell sessions are connected:

Connect-ExchangeOnline -UserPrincipalName '<[e-mail]>' -ShowBanner:$false
Connect-IPPSSession -UserPrincipalName '<[e-mail]>' -ShowBanner:$false

Safety Rules

Only execute read-only commands. Allowed cmdlet verbs: Get-*, Test-*, Export-*.

Never execute mutating commands — Set-*, New-*, Remove-*, Enable-*, Start-*, Invoke-* cmdlets must only be returned as text recommendations for the admin to review and run manually.

Decision Tree

Identify the reported symptom and load the matching reference: