An enterprise troubleshooting guide for Exchange Online, SharePoint Online, OneDrive, Microsoft Teams and Endpoint DLP.
Introduction
One of the most common challenges during a Microsoft Purview Data Loss Prevention (DLP) deployment is a policy that appears correctly configured but does not behave as expected.
An administrator creates a DLP policy, selects the required Microsoft 365 locations, configures sensitive information types or sensitivity labels, and enables the policy.
Yet during testing:
- An email containing sensitive information is delivered without a warning.
- A confidential document can still be shared externally.
- A Teams message is not blocked.
- A user copies sensitive information to a USB drive.
- Activity Explorer does not display the expected event.
- No DLP alert is generated.
Does this mean Microsoft Purview DLP is not working?
Not necessarily.
The root cause may involve policy scope, simulation mode, sensitive information detection, rule conditions, policy distribution, endpoint onboarding, unsupported workload behavior or insufficient investigation permissions.
The most effective troubleshooting approach is to separate four questions:
Did the policy apply? Did the content match? Was the expected action enforced? Was the result recorded?
This article explains how to investigate each stage systematically.
1. Understand the Microsoft Purview DLP Evaluation Process
Before changing a DLP configuration, understand how the policy is evaluated.
A simplified evaluation flow is:
Sensitive content or activity → Policy scope → Rule conditions → Detection → Configured action → Reporting
Each stage represents a potential failure point.
| Stage | Diagnostic question |
|---|---|
| Policy scope | Is the affected user, mailbox, site or device included? |
| Policy status | Is the policy off, in simulation or enforcing? |
| Rule conditions | Does the content satisfy the configured conditions? |
| Detection | Can Microsoft Purview recognize the sensitive information? |
| Enforcement | Is the rule configured to audit, notify, restrict or block? |
| Reporting | Was an event recorded, and can the administrator view it? |
A missing alert does not automatically mean a policy failed to evaluate.
Similarly, a policy match does not necessarily mean the activity should be blocked.
For example, a rule configured to audit an activity can match successfully while still allowing the user to complete the action.
Best practice: Determine whether the problem concerns policy applicability, detection, enforcement or reporting before making configuration changes.
2. Verify the DLP Policy Mode
In the Microsoft Purview portal, navigate to:
Data loss prevention → Policies
Open the affected policy and inspect its deployment mode.
| Policy mode | Expected behavior |
|---|---|
| Off | The policy does not enforce protection |
| Simulation | Evaluates supported policy matches without enforcing restrictions |
| Simulation with policy tips | Evaluates matches and displays supported user notifications |
| On | Applies the configured actions when policy conditions match |
Simulation is intended for testing and tuning policies before production enforcement.
If a policy is in simulation mode, users may still complete activities that would otherwise be blocked after enforcement.
Simulation behavior differs by workload
Microsoft Purview does not evaluate every workload in exactly the same way.
| Workload | What simulation evaluates |
|---|---|
| SharePoint Online | Existing content and new or modified content |
| OneDrive | Existing content and new or modified content |
| Exchange Online | New messages during the simulation period |
| Microsoft Teams | New supported messages during simulation |
| Endpoint devices | New supported device activities during simulation |
For SharePoint and OneDrive, Microsoft Purview can evaluate content already stored in the service.
For Exchange, Teams and devices, simulation generally evaluates new activities occurring after the simulation begins.
Microsoft documents simulation runs of up to 15 days, with simulation results retained for 30 days.
Simulation alerts are separate from production DLP alerts.
For SharePoint and OneDrive, the first 100 matched items displayed for review may be fewer than the total number of matches.
Troubleshooting recommendation
Define a controlled test window and generate new activities after starting the simulation.
Do not expect an Exchange simulation to identify every historical email sent before the simulation began.
Microsoft Learn: DLP simulation mode
3. Check Policy Scope, Locations and Exclusions
A DLP policy can be technically correct but ineffective because the affected user or content location is outside its scope.
Microsoft Purview DLP supports different workloads, including:
- Exchange Online
- SharePoint Online
- OneDrive
- Microsoft Teams chat and channel messages
- Endpoint devices
- Supported cloud applications
- Supported on-premises repositories
Not every condition or enforcement action is available across all these locations.
Example: Incorrect workload targeting
An administrator creates a policy to protect confidential documents in SharePoint and OneDrive.
The administrator then sends sensitive information through Exchange Online and expects the message to be blocked.
The message is delivered.
This does not demonstrate a failure in the SharePoint or OneDrive policy. Exchange was not included in the policy scope.
What to verify
Check the following:
- The correct workload is selected.
- The affected user or location is included.
- No unexpected exclusion applies.
- The correct SharePoint site or OneDrive account is targeted.
- Administrative unit restrictions are understood.
- Policy changes have had sufficient time to synchronize.
For Endpoint DLP, device onboarding and supported client configuration introduce additional dependencies.
4. Validate Sensitive Information Types and Rule Conditions
A document that appears sensitive to a human reader may not satisfy the configured detection conditions.
For example, a DLP rule may require:
Sensitive information type: Credit Card Number
Minimum instance count: 10
A document containing only one matching credit card number will not satisfy that threshold.
Common detection problems
| Symptom | Possible cause |
|---|---|
| One identifier does not trigger | Minimum instance count exceeds one |
| Custom SIT never matches | Regex, keywords or supporting evidence are incorrect |
| Only some documents trigger | Confidence level, file support or content extraction differs |
| Labeled document is ignored | Incorrect label condition or unsupported workload |
| No match despite sensitive content | Rule exception or additional condition prevents matching |
Recommended troubleshooting methodology
Start with a controlled test document containing synthetic information known to match the selected sensitive information type.
Validate the detection condition separately from the enforcement action.
Only after confirming detection should you investigate why a block, notification or alert is missing.
This separation significantly reduces troubleshooting time.
5. Sensitivity Labels and DLP Conditions
Microsoft Purview DLP can use sensitivity labels as conditions in supported workloads.
Consider this example:
Condition: Content has sensitivity label Confidential.
Action: Restrict external sharing.
The policy may fail to match if the document does not actually have the expected sensitivity label.
What to verify
- Open the document in a supported application.
- Confirm the sensitivity label applied to the file.
- Verify that the label was saved successfully.
- Review the DLP rule’s selected label.
- Confirm the workload supports the condition and action.
- Perform the intended sharing activity.
Important distinction: Container labels vs file labels
A SharePoint site may have a Confidential container sensitivity label.
That does not automatically mean every document inside the site has the Confidential file sensitivity label.
Container labels and file labels are separate concepts.
This distinction is particularly important when troubleshooting SharePoint and OneDrive DLP policies.
Workload limitation
Sensitivity-label conditions are supported in specific DLP locations, including Exchange, SharePoint, OneDrive and devices.
However, Teams chat and channel message text does not support sensitivity labels as DLP conditions.
Teams file attachments are evaluated through their underlying SharePoint or OneDrive storage when those locations are protected.
Microsoft Learn: Use sensitivity labels as conditions in DLP policies
6. Exchange Online DLP: Email Not Blocked
A common scenario is an email containing sensitive information that reaches an external recipient despite an active DLP policy.
Possible causes
| Cause | Investigation |
|---|---|
| Exchange not selected | Check policy locations |
| Sender or recipient outside scope | Review targeting and conditions |
| Detection threshold not reached | Inspect SIT and instance count |
| Exception matched | Review rule exceptions |
| Audit-only action | Confirm the configured restriction |
| Simulation mode | Review simulation results |
| Policy propagation | Verify distribution and retest |
Practical Exchange test
Create a controlled DLP policy using synthetic sensitive information.
Send a test message from an included account to an authorized test recipient.
Compare the expected and actual outcomes:
- Was a policy tip displayed?
- Was the message delivered?
- Was the action audited?
- Did the policy match appear in the available investigation tools?
- Was an alert configured?
Do not treat the absence of a policy tip as proof that Exchange DLP enforcement failed.
Policy tips have their own configuration and client requirements.
7. Outlook Policy Tips Not Appearing
Policy tips inform users about sensitive-content handling.
However, policy-tip display is not identical to DLP enforcement.
A rule may detect sensitive information while a policy tip fails to appear in the expected Outlook client.
Troubleshooting steps
- Verify that the DLP rule is configured to display policy tips.
- Confirm the policy is enabled in the intended mode.
- Check the sender, recipient and content conditions.
- Confirm that the Outlook client supports the scenario.
- Verify Outlook MailTips configuration where applicable.
- Reproduce the behavior in Outlook on the web.
- Use Microsoft’s DLP policy-tip diagnostic where appropriate.
Microsoft documents scenarios where policy-tip evaluation may not be retriggered by certain sensitivity-label interactions, even though the DLP action can still be enforced.
Important: Validate policy enforcement, policy-tip display and alert generation independently.
8. SharePoint and OneDrive DLP Not Triggering
SharePoint and OneDrive DLP policies can protect sensitive content and restrict supported sharing scenarios.
However, administrators must distinguish detection, sharing restrictions and existing permissions.
Example
A document contains confidential information and is stored in SharePoint.
The administrator expects DLP to prevent external access.
The document is already shared externally.
Before concluding that DLP failed, investigate:
- Whether the document was scanned and classified.
- Whether the policy includes the SharePoint site.
- Whether the rule conditions match.
- Whether the configured action restricts access.
- Whether external access existed before the policy took effect.
- Whether the service completed processing the content.
- Whether the test uses a supported file type and activity.
Recommended approach
Test with a new controlled document and a clearly defined external-sharing scenario.
Then separately evaluate existing files and historical sharing permissions.
DLP is not a replacement for SharePoint permissions governance.
SharePoint Advanced Management and Microsoft Purview data security posture management provide complementary capabilities for identifying and reducing oversharing.
9. Microsoft Teams DLP: Understand Messages vs Files
Teams DLP supports protection of supported chat and channel messages.
However, files shared through Teams are typically stored in SharePoint or OneDrive.
| Teams activity | Primary DLP location to investigate |
|---|---|
| Sensitive text in a Teams chat | Teams |
| Sensitive text in a channel message | Teams |
| File shared in a Teams channel | SharePoint |
| File shared in a Teams chat | OneDrive |
Troubleshooting example
An administrator configures Teams DLP to detect sensitive information in messages.
A user uploads a confidential Excel workbook through Teams.
The file is not blocked as expected.
The investigation should determine whether the file resides in SharePoint or OneDrive and whether an applicable policy protects that storage location.
Protecting Teams collaboration requires understanding both messages and file storage.
10. Endpoint DLP: USB, Clipboard, Printing and Browser Upload
Endpoint DLP introduces additional dependencies beyond Microsoft 365 cloud workloads.
A policy may be correctly configured in the portal but fail to enforce a restriction on a device because the endpoint is not ready.
Endpoint troubleshooting matrix
| Symptom | What to verify |
|---|---|
| USB copy not blocked | Device onboarding, rule action and file classification |
| Clipboard action allowed | Supported application and configured clipboard restriction |
| Printing not blocked | Print activity settings and supported scenario |
| Browser upload not blocked | Supported browser, domain configuration and service restrictions |
| No endpoint activity | Device health, policy scope and telemetry |
| No user notification | Enforcement action and notification settings |
Step-by-step validation
- Open the Microsoft Purview portal.
- Navigate to the device onboarding and management experience.
- Confirm that the test device is onboarded and reporting.
- Verify the supported operating system and endpoint prerequisites.
- Confirm that the policy targets the intended device or user.
- Inspect the specific endpoint activity restriction.
- Use a synthetic file with a known matching classification.
- Perform the test activity.
- Review Activity Explorer.
- Compare the recorded activity with the configured action.
Example: USB test
Create a document containing synthetic sensitive information.
Save it to the test endpoint.
Attempt to copy it to an approved test USB drive.
Record whether the result is:
- Allowed
- Audited
- Blocked
- Blocked with override
Do not confuse an audited activity with an enforcement failure when the rule is intentionally configured for audit only.
11. Activity Explorer vs DLP Alerts vs Simulation Results
These investigation tools serve different purposes.
| Tool | Main purpose |
|---|---|
| Activity Explorer | Investigate supported user and file activities |
| DLP Alerts dashboard | Investigate configured production DLP alerts |
| Simulation results | Review matches before enforcement |
| Simulation Alerts tab | Review alerts generated during simulation |
| Audit | Search supported recorded operations |
| Content Explorer | Review classified content, subject to permissions |
Important observation
Not every DLP event generates an alert.
Alert generation depends on rule configuration and supported behavior.
A user may trigger an audited activity without generating an alert.
Similarly, an administrator may have permission to manage policies but lack the additional roles needed to preview sensitive content.
An empty Activity Explorer result does not necessarily prove that no DLP activity occurred.
12. Permissions Required for DLP Troubleshooting
Troubleshooting requires appropriate access to policies, events and alerts.
| Responsibility | Relevant access |
|---|---|
| Create and manage DLP policies | DLP Compliance Management or suitable administrative role |
| Read policy configuration | View-Only DLP Compliance Management or suitable reader role |
| Investigate DLP alerts | Relevant DLP alert and investigation permissions |
| View sensitive content previews | Data Classification Content Viewer |
| Manage simulation | Information Protection admin role |
| Investigate activities | Appropriate Activity Explorer permissions and scope |
Administrative unit assignments can restrict the events and alerts an administrator can see.
Best practice: Grant only the permissions needed for each investigation role, particularly where content preview exposes sensitive information.
13. PowerShell Troubleshooting: Verify Configuration and Policy Distribution
Security & Compliance PowerShell can help validate DLP policy configuration and distribution.
An enabled DLP policy is not necessarily fully distributed to every intended workload.
Step 1 — Connect to Security & Compliance PowerShell
Import-Module ExchangeOnlineManagementConnect-IPPSSession ` -UserPrincipalName admin@contoso.com
Step 2 — List existing DLP policies
Get-DlpCompliancePolicy | Format-Table Name,Mode,Enabled
This helps identify policies and their configured modes.
Step 3 — Inspect an individual policy
Get-DlpCompliancePolicy ` -Identity "Protect Confidential Data" | Format-List *
Review the returned configuration, including supported workload settings, policy mode and scope.
Step 4 — Verify policy distribution
Get-DlpCompliancePolicy ` -Identity "Protect Confidential Data" ` -DistributionDetail | Format-List Name,DistributionStatus
The -DistributionDetail parameter requests additional distribution information.
Microsoft warns that the DistributionResults property may contain unreliable information. Do not rely on that property alone when diagnosing deployment failures.
Step 5 — Check distribution across all policies
$policies = Get-DlpCompliancePolicyforeach ($policy in $policies) { Get-DlpCompliancePolicy ` -Identity $policy.Name ` -DistributionDetail | Select-Object Name,DistributionStatus}
Investigate incomplete distribution alongside the workload’s actual behavior.
Step 6 — Inspect DLP rules
Get-DlpComplianceRule | Format-List Name,Policy,Mode
Inspect an individual rule:
Get-DlpComplianceRule ` -Identity "Block External Sharing" | Format-List *
Depending on the policy type and management interface, not every DLP configuration is represented through the same PowerShell cmdlets.
Microsoft Learn: Get-DlpCompliancePolicy
14. Test-DlpPolicies: Supported Scenarios and Limitations
Microsoft provides the Test-DlpPolicies PowerShell cmdlet for supported SharePoint and OneDrive item evaluation.
However, it is not a universal DLP testing tool.
| Capability | Supported |
|---|---|
| SharePoint file evaluation | Yes, supported scenarios |
| OneDrive file evaluation | Yes, supported scenarios |
| Exchange email testing | No |
| Teams message testing | No |
| Endpoint USB or clipboard testing | No |
The cmdlet requires specific parameters and prerequisites, including a valid file URL and site identifier.
Before running it, review the current Microsoft documentation for supported conditions and syntax.
For Exchange, Teams and endpoint scenarios, use controlled workload-specific tests, simulation results, Activity Explorer and supported diagnostics.
Microsoft Learn: Test your DLP policies
15. Real-World Troubleshooting Scenario: DLP Configured but Not Blocking
Consider an organization deploying Microsoft Purview DLP to protect confidential customer information across Exchange, SharePoint, OneDrive and Teams.
The initial pilot includes a small group of users.
The administrator creates several DLP rules and selects the required workloads.
During testing, some sensitive documents can still be shared.
Investigation findings
Issue 1 — Incorrect test expectations
Some rules were in simulation mode.
The policy detected matches but did not enforce blocking.
Issue 2 — Incomplete workload coverage
The organization tested files shared through Teams but had configured only the Teams messages location.
The relevant SharePoint and OneDrive file locations were not covered.
Issue 3 — Detection thresholds
One sensitive information type required more matching instances than the test file contained.
Remediation
The architect corrects the workload scope, updates the test data, validates simulation results and then moves the approved policy into enforcement.
The result is a repeatable testing process rather than an uncontrolled series of configuration changes.
This is an illustrative, anonymized troubleshooting scenario, not a claim about a specific customer incident.
16. Enterprise DLP Troubleshooting Checklist
Before declaring a DLP policy defective, validate the following:
- Correct DLP policy selected
- Policy mode verified
- Required workload included
- User, site or device in scope
- No unexpected exclusions
- Rule conditions reviewed
- Sensitive information type validated
- Confidence and instance thresholds checked
- Sensitivity label condition confirmed
- Enforcement action verified
- Policy-tip configuration checked
- Alert configuration checked
- Endpoint onboarding verified, if applicable
- Policy distribution status reviewed
- Simulation results reviewed
- Activity Explorer reviewed
- Administrative permissions confirmed
- Policy synchronization considered
- Test evidence documented
- Final behavior validated
Conclusion
Microsoft Purview DLP troubleshooting requires understanding how policies are evaluated across different workloads.
A policy that does not block an activity is not necessarily broken.
The cause may be simulation mode, incorrect targeting, unmatched conditions, missing workload coverage, endpoint prerequisites, distribution issues or a misunderstanding of reporting behavior.
The most effective troubleshooting approach is to separate four questions:
Did the policy apply? Did the content match? Was the expected action enforced? Was the result recorded?
By investigating these questions independently, organizations can reduce false positives, improve enforcement reliability and deploy Microsoft Purview DLP with greater confidence.