Study guide
8.4 Troubleshooting Synchronization
Microsoft 365 Administrator Expert MS-102
Track your progress as you read
Finished sections get a check mark.
1 Introduction & Exam Overview
1.1 MS-102 Exam Facts & Blueprint 1.2 Registration, Retake & Renewal 1.3 Study Strategy & Using This Guide
2 Tenant Setup, Domains & Org Settings
2.1 Creating a Microsoft 365 Tenant 2.2 Implementing and Managing Domains 2.3 Configuring Org Settings: Security, Privacy & Profile
3 Service Health, Network & Software Updates
3.1 Monitoring Service Health & Notifications 3.2 Network Connectivity Insights 3.3 Configuring & Monitoring Software Updates
4 Adoption, Usage & Microsoft 365 Backup
4.1 Monitoring Adoption & Usage 4.2 Configuring & Managing Microsoft 365 Backup
5 Users, Contacts, Groups & Shared Mailboxes
5.1 Creating & Managing Users Including External Users 5.2 Creating & Managing Contacts 5.3 Managing Microsoft 365 Groups & Shared Mailboxes
6 Licensing & Bulk User Management
6.1 Managing & Monitoring Microsoft 365 Licenses 6.2 Bulk User Management with Graph & Entra PowerShell
7 Roles, Admin Units & Privileged Identity Management
7.1 Implementing & Managing Roles in M365 & Entra ID 7.2 Managing Permissions for Defender XDR, Purview & Workloads 7.3 Managing Delegation with Administrative Units 7.4 Managing Entra ID Roles in PIM
8 Identity Synchronization with Entra Connect
8.1 Preparing for Identity Synchronization & IdFix 8.2 Directory Sync with Entra Connect Sync & Cloud Sync 8.3 Monitoring Sync with Entra Connect Health 8.4 Troubleshooting Synchronization
9 Authentication, SSPR & Password Protection
9.1 Implementing & Managing Authentication Methods 9.2 Self-Service Password Reset (SSPR) 9.3 Microsoft Entra Password Protection 9.4 Investigating & Resolving Authentication Issues
10 Identity Protection, Conditional Access & MFA
10.1 Planning for Identity Protection 10.2 Implementing Entra Identity Protection 10.3 Planning & Implementing Conditional Access Policies 10.4 Managing MFA with Conditional Access
11 Defender XDR Posture, Incidents & Threat Intelligence
11.1 Security Exposure Management & Secure Score 11.2 Incidents, Alerts & Advanced Hunting 11.3 Reviewing Defender XDR Reports 11.4 Defender Threat Intelligence
12 Defender for Office 365: Policies, Alerts & Investigation
12.1 Threat Policies & Rules in Defender for Office 365 12.2 Configuring Alert Policies 12.3 Investigating & Responding to Email Threats
13 Attack Simulation & Restricted Entities
13.1 Managing Attack Simulations & Training 13.2 Managing Restricted Entities & Blocked Users
14 Defender for Endpoint
14.1 Onboarding Devices to Defender for Endpoint 14.2 Configuring Endpoint Settings 14.3 Defender Vulnerability Management Dashboard
15 Defender for Cloud Apps
15.1 Configuring the App Connector for Microsoft 365 15.2 Defender for Cloud Apps Policies & Alerts 15.3 Interpreting the Activity Log 15.4 Cloud App Discovery
16 Purview Information Protection & Data Lifecycle
16.1 Sensitive Information Types 16.2 Retention Labels & Policies 16.3 Sensitivity Labels & Policies 16.4 Monitoring Label Usage: Content & Activity Explorer
17 Purview Data Loss Prevention
17.1 DLP Policies for Microsoft 365 Workloads 17.2 Configuring Endpoint DLP 17.3 Reviewing & Responding to DLP Alerts, Events & Reports
18 Final Review & Exam Strategy
18.1 Exam-Day Strategy & Question Handling 18.2 Final Review Checklist & Next Steps
8.4 Troubleshooting Synchronization
Key Takeaways Explain This Topic AI
Duplicate attribute resiliency quarantines conflicting objects in Entra ID rather than dropping them, but the source conflict still has to be fixed in on-prem AD
Soft-match uses mail/UPN to relink a deleted user to a restored cloud object; hard-match uses immutableId when the cloud object already exists
An OU removed from sync scope does not delete the already-synced cloud objects — they become orphaned and require manual deletion or a scoping change
Cloud Sync places a configuration into quarantine after repeated errors; clearing quarantine requires fixing the root cause and then restarting provisioning
The Synchronization Service Manager (Connect Sync) and the Entra provisioning logs (Cloud Sync) are the primary diagnostic surfaces for object-level failures
Last updated: August 2026
Troubleshooting Synchronization
Quick Answer: Most sync failures resolve to a small set of causes: duplicate attribute conflicts, invalid attribute values, filtering mistakes, accidental deletes, and provisioning/quarantine states. Use duplicate attribute resiliency and the fix sync errors tasks in the Entra admin center to remediate conflicts, and use the Synchronization Service Manager (Connect Sync) or the provisioning logs (Cloud Sync) to diagnose object-level failures.
Duplicate Attribute Conflicts
The most common sync error is a duplicate attribute conflict — two on-prem objects claim the same value for an attribute that Entra ID requires to be unique, usually userPrincipalName or proxyAddresses .
Duplicate attribute resiliency is a Microsoft Entra ID feature that quarantines the conflicting attribute on the duplicate object instead of dropping the object. The first object keeps the value; the second object is provisioned with the conflicting value blanked or quarantined, and a sync error is raised. Resiliency prevents data loss but does not resolve the conflict — you must fix the source.
Resolution:
- Identify the conflict from the Connect Health object-level error or the Cloud Sync provisioning log
- Edit one of the two on-prem objects so it has a unique value
- Run a delta sync (Connect Sync) or wait for the next Cloud Sync cycle
- The sync engine retries the quarantined attribute and clears the error once the values are unique
- Large-Object and Invalid-Attribute Errors
Large-object errors ( LargeObject ) occur when an attribute exceeds the sync engine's limit — for example, a userCertificate or thumbnailPhoto larger than the allowed size. Fix by trimming the offending attribute on the source object.
Invalid attribute values ( InvalidAttribute ) occur when a value fails validation — a malformed UPN, an unsupported character, or a value that violates the Entra schema. Fix the value in AD, then re-sync.
Filtering Mistakes
A common operational mistake is removing an OU from sync scope and expecting the previously synchronized objects to disappear from Entra ID. They do not — once an object has been synced, removing its container from scope stops updates but does not delete the cloud copy. The cloud object is now orphaned : it will not receive attribute updates, and the source-of-truth link is effectively broken.
Resolution options:
Re-add the OU to scope and then properly deprovision the users (for example, by disabling and letting the next cycle flow the disable state)
- Manually delete the orphaned cloud objects in the Entra admin center if they should not exist
- Use the fix sync errors task in the Entra admin center, which can guide removal of orphaned objects
- Restoring Accidentally Deleted Users: Soft-Match vs Hard-Match
When an on-prem user is accidentally deleted and recreated, or when a cloud-only user needs to be relinked to a new on-prem identity, you use matching to re-establish the link:
Soft-match — the sync engine matches on mail or userPrincipalName . If a deleted on-prem user is recreated with the same UPN and mail, the sync engine soft-matches the new on-prem object to the existing cloud object and resumes updates.
Hard-match — the sync engine matches on immutableId (the sourceAnchor). Use hard-match when the cloud object already exists and you have the original sourceAnchor value; set the sourceAnchor on the new on-prem object to the original and the engine hard-matches.
Soft-match is the easier path when the original anchor is unavailable; hard-match is the deterministic path when you can recover the anchor.
Provisioning and Quarantine States (Cloud Sync)
Cloud Sync places a configuration into quarantine after repeated errors. Common triggers:
- Invalid provisioning agent credentials
- A sustained burst of duplicate-attribute conflicts
- Loss of connectivity to the on-prem AD
- A bad scoping filter that produces no valid objects
While in quarantine, Cloud Sync pauses provisioning. Clearing quarantine requires fixing the root cause and then restarting provisioning on the configuration from the Entra admin center. The provisioning page shows the quarantine reason; the provisioning logs show the failing objects.
Diagnostic Surfaces
Engine Primary diagnostic surface What it shows
Connect Sync Synchronization Service Manager ( miisclient.exe ) Connector space objects, sync steps, flow errors, join/disconnect status
- Connect Sync Connect Health portal Sync statistics, object-level errors, alert history
- Cloud Sync Entra admin center Provisioning page Configuration status, quarantine state, last cycle time
- Cloud Sync Provisioning logs Per-object create/update/disable/fail events with reason
- Troubleshooting Table
- Symptom Likely cause Fix
- DuplicateUPN sync error Two on-prem objects share a UPN Reassign a unique UPN to one object; run delta sync
DuplicateProxyAddress sync error Two mailboxes share an SMTP address Remove the duplicate proxyAddresses value from the object that should not own it
LargeObject error on a user An attribute (often userCertificate or thumbnailPhoto ) exceeds the size limit Trim the oversized attribute on the source object
Orphaned cloud objects after OU removal Removing a synced OU from scope stops updates but does not delete cloud copies Re-add the OU and deprovision properly, or manually delete the orphaned cloud objects
Deleted user reappeared without attributes Source object was deleted and recreated; link not re-established Soft-match on UPN/mail, or hard-match on immutableId, then re-sync
Cloud Sync configuration quarantined Repeated errors (bad credentials, conflict storm, lost connectivity) Fix the root cause shown on the Provisioning page, then restart provisioning
InvalidAttribute validation error Malformed UPN, unsupported character, or schema violation Correct the value in AD; run a delta sync
No objects syncing after a change Filtering or scoping change removed all valid objects Verify domain/OU/group scoping; restore the intended scope
Using the Fix Sync Errors Tasks
The Entra admin center exposes fix sync errors tasks that operationalize the most common remediations:
Duplicate attribute resiliency — surfaces quarantined attributes so you can review and release them once the source is fixed
- Orphaned object cleanup — helps identify cloud objects whose source link is broken
- Group-based filtering review — verifies that pilot scoping still includes the intended users
Use these tasks as a first stop before drilling into Connect Health or the provisioning logs — they often localize the problem in one click.