Entra Connect hat einen doppelten Benutzer erstellt oder ein Attribut übersprungen: Soft Match, Hard Match und doppelte Werte
Von Mirko Peters ·
Ein neuer lokaler Benutzer hat ein zweites Cloudkonto mit einem onmicrosoft.com-UPN erzeugt, oder die E-Mail-Adresse wurde nie aktualisiert. Erfahren Sie, wie das Matching funktioniert, wie Sie die Fehler lesen und wie Sie die Verknüpfung sicher wiederherstellen.
Automatisch mit KI aus dem Originalbeitrag übersetzt. Englisches Original lesen
Zwei Situationen führen Administratoren zu den Matching-Regeln von Entra Connect. Im ersten Fall erscheint ein neuer lokaler Benutzer zweimal in der Cloud: das gewünschte Konto und ein neu synchronisiertes Konto mit einem Anmeldenamen auf .onmicrosoft.com. Im zweiten Fall läuft die Synchronisierung ohne Fehler, aber das Attribut mail oder proxyAddresses zeigt in Entra ID weiterhin die alte Adresse an.
Das Wichtigste in Kürze
- Entra versucht zuerst einen Hard Match über sourceAnchor gegen ImmutableId, danach einen Soft Match über userPrincipalName oder die primäre SMTP-Adresse, und erstellt andernfalls ein neues Objekt.
- Wenn das lokale UPN-Suffix im Mandanten nicht verifiziert ist, erstellt Entra einen neuen UPN aus mailNickName und der initialen onmicrosoft.com-Domäne.
- Die Resilienz bei doppelten Attributen stellt einen widersprüchlichen Wert von proxyAddresses oder UPN in Quarantäne, statt die Synchronisierung fehlschlagen zu lassen. Dadurch kann die Synchronisierung gesund wirken, obwohl ein Wert fehlt.
- Laut Microsoft Learn kann der Hard Match ab dem 1. Juli 2026 für Cloudkonten blockiert werden, bei denen onPremisesObjectIdentifier bereits gesetzt ist, die eine privilegierte Rolle innehaben oder für eine solche Rolle berechtigt sind.
Beide Fälle kamen in Microsoft-Q&A-Threads vor, einer aus Januar 2025 und einer aus Oktober 2025. In beiden berichtete die fragende Person, was das Problem gelöst hat. Ich habe die technischen Hintergründe mit den aktuellen Seiten von Microsoft Learn abgeglichen. Dies ist eine Anleitung zur Fehlerbehebung, kein offizielles Microsoft-Verfahren. Testen Sie jede Änderung zuerst an einem einzelnen Benutzer.
So ordnet Entra Objekte zu
Microsoft Learn beschreibt für ein neues Objekt aus AD diese Reihenfolge:
- Hard Match. Entra vergleicht das
sourceAnchormit derImmutableIdvorhandener Cloudobjekte. Das Standard-sourceAnchorist je nach Konfiguration die Base64-Form vonmS-Ds-ConsistencyGUIDoder vonObjectGUID. - Soft Match. Wenn es keinen Hard Match gibt, vergleicht Entra
userPrincipalNameoder den primärenSMTP:-Wert ausproxyAddresses. - Neues Objekt. Wenn nichts passt, erstellt Entra ein neues Objekt.
Microsoft Learn nennt zwei Einschränkungen. Der Soft Match wird nur für neue Objekte ausgewertet. Bei einem Soft Match übernimmt Entra das Cloudobjekt und überschreibt jedes Attribut, das lokal einen Wert hat. Cloud-only-Attribute können dabei verloren gehen, und bei Password Hash Sync wird der Cloud-Passworthash durch den lokalen ersetzt.
Szenario 1: ein zweiter Benutzer mit onmicrosoft.com-UPN
Was der Thread berichtet. Ein Administrator hat einen Benutzer im lokalen AD angelegt. Entra Connect erstellte daraufhin einen zweiten Entra-Benutzer mit einem .onmicrosoft.com-UPN und dem Synchronisierungskennzeichen für lokale Objekte. Der eigentlich gewünschte Cloudbenutzer hatte kein Synchronisierungskennzeichen. Die akzeptierte Antwort beschrieb sowohl Soft Match als auch Hard Match. Die fragende Person schrieb später, dass der Hard-Match-Ansatz das Problem gelöst habe.
Warum die Zuordnung fehlgeschlagen sein könnte
Der Thread nannte keinen Grund. Learn beschreibt einen dokumentierten Grund für den Namen onmicrosoft.com: Wenn das lokale UPN-Suffix im Mandanten nicht verifiziert ist, berechnet Entra einen neuen UPN aus dem MailNickName und der Initialdomäne. Das bedeutet auch, dass der UPN nicht mit dem Cloudbenutzer übereinstimmen kann. Das ist ein Ansatzpunkt, keine Diagnose. Vergleichen Sie diese Punkte bei beiden Konten:
- UPN-Suffix und ob es sich um eine verifizierte Domäne in Ihrem Mandanten handelt
- primäre SMTP-Adresse (der Eintrag
SMTP:inproxyAddresses) - ob der Cloudbenutzer bereits eine lokale Verknüpfung anzeigt
Option A: Soft Match zum Laufen bringen
Der erste Workaround im Thread bestand darin, den lokalen UPN und die Proxy-Adressen an den Cloudbenutzer anzupassen, das Duplikat zu löschen und erneut zu synchronisieren. Learn zufolge wird Soft Match nur für neue Objekte ausgewertet. Nicht abgedeckt ist, ob ein bereits verknüpftes Objekt nach dem Löschen des Duplikats erneut ausgewertet wird. Die fragende Person hat schließlich Option B verwendet. Behandeln Sie Option A daher als nicht bestätigt.
Option B: Hard Match
- Ermitteln Sie, welches Attribut Ihre Entra Connect als
sourceAnchorverwendet. Learn nenntmS-Ds-ConsistencyGUIDoderObjectGUID. - Konvertieren Sie die lokale GUID in Base64. Die Antwort im Thread verwendete dieses Muster:
``powershell $guid = (Get-ADUser <sam-account-name>).ObjectGuid [System.Convert]::ToBase64String($guid.ToByteArray()) ``
- Setzen Sie das Ergebnis als
ImmutableIddes Cloudbenutzers. Die Antwort im Thread verwendeteSet-MsolUseraus dem älteren MSOnline-Modul. Aktuelle Learn-Seiten verwenden Microsoft Graph PowerShell. Die Seite zuUpdate-MgUserdokumentiert den Parameter-OnPremisesImmutableIdund nennt, dass nur bestimmte privilegierte Administratorrollen ihn aktualisieren können. Prüfen Sie dort die Hinweise zum Parameter, bevor Sie den Befehl ausführen. - Starten Sie eine Delta-Synchronisierung:
``powershell Start-ADSyncSyncCycle -PolicyType Delta ``
- Bestätigen Sie, dass der vorgesehene Cloudbenutzer nun das Synchronisierungskennzeichen anzeigt, und kümmern Sie sich danach um das verbleibende Duplikat.
Learn beschreibt die Reihenfolge der Bereinigung für genau diesen Fall nicht. Die Antwort im Thread hat zuerst die ImmutableId gesetzt, synchronisiert, geprüft und danach das Duplikat entfernt. Prüfen Sie vor dem Löschen die Lizenzen und die Postfachdaten des Duplikats.
Learn dokumentiert einen verwandten Fehler, InvalidSoftMatch. Er tritt auf, wenn Hard Match nichts findet, Soft Match ein Cloudobjekt findet, dieses Objekt aber eine andere ImmutableId hat als das eingehende sourceAnchor. Das deutet darauf hin, dass das Cloudobjekt aus einem anderen lokalen Objekt synchronisiert wurde. Learns Lösung entspricht der für AttributeValueMustBeUnique: Ermitteln Sie den doppelten Wert und die beteiligten Objekte, entscheiden Sie, welches Objekt ihn behält, und entfernen Sie den Wert am anderen Objekt in dem Verzeichnis, in dem er stammt.
Neue Schutzmechanismen seit Juli 2026
Learn zufolge kann ein Hard Match ab dem 1. Juli 2026 blockiert werden, wenn das Zielkonto in der Cloud:
- bereits
onPremisesObjectIdentifiergesetzt hat, - eine privilegierte Microsoft-Entra-Rolle zugewiesen hat oder
- für eine privilegierte Microsoft-Entra-Rolle berechtigt ist.
Cloudverwaltete Konten mit aktiviertem Writeback sind ausgenommen. Learn zufolge heben diese Schutzmechanismen Hard Match für sichere Ziele nicht auf. Beschrieben werden außerdem mandantenweite Kennzeichen, BlockSoftMatchEnabled und BlockCloudObjectTakeoverThroughHardMatchEnabled, sowie eine temporäre Umgehung, AllowOnPremUpdateOfOnPremisesObjectIdentifierEnabled, die standardmäßig deaktiviert ist. Learn warnt, dass die Umgehung den Schutz verringert und danach wieder deaktiviert werden sollte. Standardmäßig führt Entra außerdem kein Soft Match von lokalen Benutzern zu Cloudbenutzern durch, die eine Administratorrolle innehaben. Microsoft rät zudem dringend davon ab, lokale Konten mit bereits vorhandenen Administratorkonten zu synchronisieren.
Wenn der Hard Match aus dem Thread von 2025 heute fehlschlägt, könnte also einer dieser Schutzmechanismen der Grund sein.
Szenario 2: Die Synchronisierung läuft unauffällig, aber die Adresse ändert sich nie
Was der Thread berichtete. Externe Dienstleister benötigten eigene externe E-Mail-Adressen statt der Unternehmensadresse. Die lokalen Konten zeigten in ADUC die richtigen Adressen, mail und proxyAddresses in Entra enthielten aber weiterhin die Unternehmensadresse. Die fragende Person fand die Ursache allein: Reine Cloud-Gastkonten, die für den SharePoint-Zugriff angelegt worden waren, verwendeten dieselben externen Adressen wie die neuen lokalen Konten. Die Person schrieb, genau das sei der Konflikt.
Beachten Sie, dass die akzeptierte Antwort in diesem Thread allgemein gehalten war und die Diagnose von der fragenden Person stammte.
Was Learn ergänzt
- Entra ID benötigt eindeutige Werte für
mail,proxyAddresses,signInNameunduserPrincipalName. Wenn Sie einen Wert hinzufügen oder aktualisieren, den bereits ein anderes Objekt besitzt, trittAttributeValueMustBeUniqueauf. - Die Resilienz bei doppelten Attributen ist das Standardverhalten und lässt sich nicht deaktivieren. Sie behandelt nur UPN- und SMTP-
proxyAddresses-Werte: Entra stellt einen doppelten Wert unter Quarantäne, statt den Export fehlschlagen zu lassen. Die Daten werden dadurch nicht korrigiert, und die Learn-Seite führtmailnicht unter den abgedeckten Attributen auf. - Bei einem doppelten UPN wird ein Platzhalter vergeben, und zwar in der Form
<OriginalPrefix>+<4DigitNumber>@<InitialTenantDomain>.onmicrosoft.com. Ein unter Quarantäne gestellter SMTP-Proxy-Adresswert wird zurückgehalten, während das Objekt weiterhin erstellt oder aktualisiert wird. - Da der Export erfolgreich ist, protokolliert der Synchronisierungsclient keinen Fehler und wiederholt den Vorgang nicht.
Das passt zu dem, was im Thread beschrieben wurde: kein sichtbarer Fehler, ein Wert fehlt. Die akzeptierte Antwort erwähnte die Resilienz bei doppelten Attributen nur allgemein, und niemand hat bestätigt, dass sie hier gegriffen hat. Das ist also eine plausible, aber keine bestätigte Erklärung.
So finden Sie die Konflikte
- Öffnen Sie im Microsoft Entra Admin Center den Bericht „Synchronisierungsfehler“ in Microsoft Entra Connect Health. Laut Learn wird er etwa alle 30 Minuten aktualisiert und zeigt Fehler aus dem letzten Synchronisierungsversuch an.
- Bei Werten unter Quarantäne zeigt Learn Folgendes:
``powershell Connect-Entra Get-EntraDirectoryObjectOnPremisesProvisioningError | Where-Object PropertyCausingError -eq 'ProxyAddresses' ``
- Learns Lösung ist für
AttributeValueMustBeUniqueundInvalidSoftMatchdieselbe: Ermitteln Sie den doppelten Wert und die beteiligten Objekte, entscheiden Sie, welches Objekt ihn behält, entfernen Sie ihn beim anderen Objekt in dem Verzeichnis, aus dem dieses Objekt stammt, und lassen Sie dann Entra Connect synchronisieren. In manchen Fällen müssen Sie eines der kollidierenden Objekte löschen. - Ein Hintergrundauftrag entfernt die Attribute unter Quarantäne, sobald der Konflikt behoben ist. Laut Learn läuft er stündlich.
Im Gastfall bedeutet das, die Adresse am reinen Cloud-Gast zu ändern oder zu entfernen und dann auf die nächste Synchronisierung zu warten.
Überprüfen
- Suchen Sie den Benutzer in Entra ID und vergleichen Sie
mail,proxyAddressesund den UPN mit AD. - Führen Sie
Start-ADSyncSyncCycle -PolicyType Deltaaus und prüfen Sie danach erneut. - Prüfen Sie, ob der Fehlerbericht das Objekt nicht mehr auflistet.
Bei Massenänderungen beschreibt der Learn-Artikel zu Staging-Servern eine Möglichkeit, ausstehende Exporte mit csexport und CSExportAnalyzer vorab zu prüfen, bevor Sie in den aktiven Modus wechseln.
Grenzen
- Die Threads belegen nicht, welcher Schritt Ihren Fall behoben hat.
- Die Hard-Match-Befehle im Thread verwenden ein älteres Modul. Halten Sie sich an die aktuellen Learn-Hinweise.
- Learn dokumentiert die Bereinigungsreihenfolge nach einem fälschlicherweise erstellten Duplikat nicht. Testen Sie dies mit einem Benutzer.
Verwandte Inhalte
Quellen
- Microsoft Learn: Soft Match vs. Hard Match, Entra Connect für einen bestehenden Mandanten
- Microsoft Learn: Fehlerbehebung bei Fehlern während der Synchronisierung
- Microsoft Learn: Identitätssynchronisierung und Resilienz bei doppelten Attributen
- Microsoft Learn: Planung für UserPrincipalName und alternative Anmelde-ID
- Microsoft Learn: Staging-Server
- Microsoft Learn: Update-MgUser
- Microsoft Q&A: Entra Connect Sync hat einen zweiten Benutzer mit einer onmicrosoft.com-Domäne erstellt (Oktober 2025)
- Microsoft Q&A: AD Connect Sync, mail und proxyAddresses werden nicht aktualisiert (Januar 2025)