dlm-diagnostics

Diagnose Microsoft Purview DLM issues in Exchange Online with PowerShell commands.

9|6|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/microsoft/purview-dlm-mcp --skill dlm-diagnostics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dlm-diagnostics
Source: https://github.com/microsoft/purview-dlm-mcp/tree/main/.claude/skills/dlm-diagnostics
Command: npx skills add https://github.com/microsoft/purview-dlm-mcp --skill dlm-diagnostics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps diagnose and resolve complex issues related to Microsoft Purview Data Lifecycle Management (DLM) within Exchange Online, ensuring your retention policies function as expected.

Core Features & Use Cases

  • Symptom-based troubleshooting: Guides you through a decision tree to pinpoint the exact DLM issue based on user-reported symptoms.
  • Automated diagnostics: Executes pre-defined PowerShell commands to gather relevant data and identify root causes.
  • Reference-driven solutions: Loads specific diagnostic guides and remediation steps based on the identified symptom.
  • Use Case: A user reports that a retention policy isn't applying to their mailbox. This Skill can help you quickly identify the cause, whether it's a policy configuration error, scope issue, or distribution problem, and provide steps to fix it.

Quick Start

Use the dlm-diagnostics skill to troubleshoot why a retention policy is not applying to a user's mailbox.

Frequently Asked Questions about dlm-diagnostics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot a Purview retention policy not applying to an Exchange Online mailbox?

To troubleshoot a Purview retention policy not applying, this Skill executes targeted PowerShell commands to gather mailbox data, identifies if the root cause is a configuration error or scope issue, and loads specific diagnostic guides with remediation steps to fix the policy application.

Why is my Microsoft Purview DLM retention policy stuck in an error state?

When a Microsoft Purview DLM retention policy is stuck in an error state, this Skill runs automated PowerShell diagnostics against your Exchange Online environment to pinpoint the exact root cause and loads reference-driven solutions to clear the error and restore policy function.

Do I need Exchange Online and Security & Compliance PowerShell sessions to diagnose DLM issues?

Yes, diagnosing DLM issues requires active Exchange Online and Security & Compliance PowerShell sessions, because this Skill executes targeted PowerShell commands across both environments to gather the data required for identifying retention policy root causes.

How does symptom-based troubleshooting work for Data Lifecycle Management issues in Exchange Online?

Symptom-based troubleshooting for Data Lifecycle Management issues works by guiding you through a decision tree based on user-reported symptoms, which pinpoints the exact DLM issue and loads detailed diagnostic guides with specific remediation steps to resolve the problem.

Can this Skill help diagnose auto-expanding archives and inactive mailboxes in Exchange Online?

Yes, this Skill can diagnose auto-expanding archives and inactive mailboxes in Exchange Online, addressing these specific symptoms alongside retention policy failures by executing pre-defined PowerShell commands to gather relevant data and identify root causes.