M365Con 2027 – die kostenlose Online-Konferenz · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Entra Connect hat einen doppelten Benutzer erstellt oder ein Attribut übersprungen: Soft Match, Hard Match und doppelte Werte

Von ·

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:

  1. Hard Match. Entra vergleicht das sourceAnchor mit der ImmutableId vorhandener Cloudobjekte. Das Standard-sourceAnchor ist je nach Konfiguration die Base64-Form von mS-Ds-ConsistencyGUID oder von ObjectGUID.
  2. Soft Match. Wenn es keinen Hard Match gibt, vergleicht Entra userPrincipalName oder den primären SMTP:-Wert aus proxyAddresses.
  3. 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: in proxyAddresses)
  • 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

  1. Ermitteln Sie, welches Attribut Ihre Entra Connect als sourceAnchor verwendet. Learn nennt mS-Ds-ConsistencyGUID oder ObjectGUID.
  2. 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()) ``

  1. Setzen Sie das Ergebnis als ImmutableId des Cloudbenutzers. Die Antwort im Thread verwendete Set-MsolUser aus dem älteren MSOnline-Modul. Aktuelle Learn-Seiten verwenden Microsoft Graph PowerShell. Die Seite zu Update-MgUser dokumentiert den Parameter -OnPremisesImmutableId und nennt, dass nur bestimmte privilegierte Administratorrollen ihn aktualisieren können. Prüfen Sie dort die Hinweise zum Parameter, bevor Sie den Befehl ausführen.
  2. Starten Sie eine Delta-Synchronisierung:

``powershell Start-ADSyncSyncCycle -PolicyType Delta ``

  1. 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 onPremisesObjectIdentifier gesetzt 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, signInName und userPrincipalName. Wenn Sie einen Wert hinzufügen oder aktualisieren, den bereits ein anderes Objekt besitzt, tritt AttributeValueMustBeUnique auf.
  • 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ührt mail nicht 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

  1. Ö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.
  2. Bei Werten unter Quarantäne zeigt Learn Folgendes:

``powershell Connect-Entra Get-EntraDirectoryObjectOnPremisesProvisioningError | Where-Object PropertyCausingError -eq 'ProxyAddresses' ``

  1. Learns Lösung ist für AttributeValueMustBeUnique und InvalidSoftMatch dieselbe: 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.
  2. 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

  1. Suchen Sie den Benutzer in Entra ID und vergleichen Sie mail, proxyAddresses und den UPN mit AD.
  2. Führen Sie Start-ADSyncSyncCycle -PolicyType Delta aus und prüfen Sie danach erneut.
  3. 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

Show folgenSpotify

Entitäten in diesem Artikel

Microsoft Entra Connect Microsoft Entra ID Microsoft Entra Connect Health Microsoft Graph PowerShell

Verwandte Artikel

RSS