M365Con 2027 – gratis online conferentie · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Entra Connect heeft een dubbele gebruiker aangemaakt of een attribuut overgeslagen: soft match, hard match en dubbele waarden

By ·

Een nieuwe on-premises gebruiker kreeg een tweede cloudaccount met een onmicrosoft.com-UPN, of het mailadres werd nooit bijgewerkt. Lees hoe matching werkt, hoe je de fouten interpreteert en hoe je veilig opnieuw koppelt.

Automatically translated with AI from the original post. Read the English original

Er zijn twee situaties waarin mensen bij de matchingregels van Entra Connect terechtkomen. In de eerste verschijnt een nieuwe on-premises gebruiker twee keer in de cloud: het account dat je wilde, plus een nieuw gesynchroniseerd account met een aanmeldnaam .onmicrosoft.com. In de tweede verloopt de synchronisatie zonder fouten, maar toont de mail of proxyAddresses van een gebruiker in Entra ID nog steeds het oude adres.

Belangrijkste punten

  • Entra probeert eerst een hard match op sourceAnchor tegen ImmutableId, daarna een soft match op userPrincipalName of het primaire SMTP-adres, en maakt anders een nieuw object aan.
  • Als het on-premises UPN-achtervoegsel niet geverifieerd is in de tenant, bouwt Entra een nieuwe UPN op basis van mailNickName en het initiële onmicrosoft.com-domein.
  • Veerkracht bij dubbele attributen zet een conflicterende waarde van proxyAddresses of UPN in quarantaine in plaats van te laten falen. Daardoor kan de synchronisatie gezond lijken terwijl één waarde ontbreekt.
  • Volgens Learn kan vanaf 1 juli 2026 hard match worden geblokkeerd voor cloudaccounts die al een onPremisesObjectIdentifier hebben, of die een bevoegde rol hebben of daarvoor in aanmerking komen.

Beide situaties kwamen voor in Microsoft Q&A-threads, één uit januari 2025 en één uit oktober 2025. In elke thread meldde de vraagsteller wat het probleem oploste. Ik heb de technische achtergrond gecontroleerd aan de hand van de huidige Microsoft Learn-pagina's. Dit is een handleiding voor probleemoplossing, geen officiële Microsoft-procedure. Test elke wijziging eerst op één gebruiker.

Hoe Entra objecten matcht

Learn beschrijft deze volgorde voor een nieuw object dat uit AD binnenkomt:

  1. Hard match. Entra vergelijkt de sourceAnchor met de ImmutableId van bestaande cloudobjecten. De standaard sourceAnchor is de Base64-vorm van mS-Ds-ConsistencyGUID, of van ObjectGUID, afhankelijk van de configuratie.
  2. Soft match. Als er geen hard match is, vergelijkt Entra userPrincipalName of de primaire SMTP:-waarde van proxyAddresses.
  3. Nieuw object. Als geen van beide overeenkomt, maakt Entra een nieuw object aan.

Learn noemt twee beperkingen. Soft match wordt alleen geëvalueerd voor nieuwe objecten. En bij een soft match neemt Entra het cloudobject over en overschrijft het elk attribuut dat on-premises een waarde heeft. Cloudspecifieke attributen kunnen verloren gaan, en bij wachtwoordhashsynchronisatie wordt de wachtwoordhash in de cloud vervangen door die van on-premises.

Scenario 1: een tweede gebruiker met een onmicrosoft.com-UPN

Wat de thread meldde. Een beheerder maakte een gebruiker aan in on-premises AD. Entra Connect maakte daarop een tweede Entra-gebruiker aan met een .onmicrosoft.com-UPN en de vlag voor on-premises synchronisatie. De bedoelde cloudgebruiker had geen synchronisatievlag. Het geaccepteerde antwoord beschreef zowel soft match als hard match. De vraagsteller schreef later dat de hard match-aanpak het probleem oploste.

Waarom de match mogelijk is mislukt

De thread vermeldde niet waarom. Learn geeft één gedocumenteerde reden voor de onmicrosoft.com-naam: als het UPN-achtervoegsel van on-premises niet is geverifieerd in de tenant, berekent Entra een nieuwe UPN op basis van de MailNickName en het initiële domein. Dat betekent ook dat de UPN niet kan overeenkomen met de cloudgebruiker. Dit is een aanwijzing, geen diagnose. Vergelijk deze punten bij beide accounts:

  • UPN-achtervoegsel en of het een geverifieerd domein is in je tenant
  • primair SMTP-adres (het SMTP:-item in proxyAddresses)
  • of de cloudgebruiker al een on-premises koppeling toont

Optie A: zorg dat soft match werkt

De eerste workaround in de thread was om de on-premises UPN en proxyadressen gelijk te trekken met de cloudgebruiker, het duplicaat te verwijderen en opnieuw te synchroniseren. Learn zegt dat soft match alleen wordt geëvalueerd voor nieuwe objecten, en het beschrijft niet of een object dat al gekoppeld is opnieuw wordt geëvalueerd nadat het duplicaat is verwijderd. De vragensteller heeft uiteindelijk Optie B gebruikt, dus behandel Optie A als niet bewezen.

Optie B: hard match

  1. Ga na welk attribuut je Entra Connect gebruikt als sourceAnchor. Learn noemt mS-Ds-ConsistencyGUID of ObjectGUID.
  2. Zet de on-premises GUID om naar Base64. Het antwoord in de thread gebruikte dit patroon:

``powershell $guid = (Get-ADUser <sam-account-name>).ObjectGuid [System.Convert]::ToBase64String($guid.ToByteArray()) ``

  1. Zet het resultaat als ImmutableId van de cloudgebruiker. Het antwoord in de thread gebruikte Set-MsolUser, dat uit de oudere MSOnline-module komt. Actuele Learn-pagina's gebruiken Microsoft Graph PowerShell. De pagina over Update-MgUser documenteert de parameter -OnPremisesImmutableId en vermeldt dat alleen specifieke geprivilegieerde beheerdersrollen deze kunnen bijwerken. Controleer de parameteropmerkingen daar voordat je het uitvoert.
  2. Voer een delta-synchronisatie uit:

``powershell Start-ADSyncSyncCycle -PolicyType Delta ``

  1. Controleer of de beoogde cloudgebruiker nu de synchronisatievlag toont en ruim daarna het overgebleven duplicaat op.

Learn beschrijft de opruimvolgorde niet voor precies dit geval. Het antwoord in de thread stelde eerst de ImmutableId in, synchroniseerde, controleerde en verwijderde het duplicaat daarna. Controleer voordat je iets verwijdert de licenties en mailboxgegevens van het duplicaat.

Learn documenteert een verwante fout, InvalidSoftMatch. Die treedt op wanneer hard match niets vindt, soft match een cloudobject vindt, maar dat object een andere ImmutableId heeft dan het binnenkomende sourceAnchor. Dit wijst erop dat het cloudobject is gesynchroniseerd vanuit een ander on-premises object. De oplossing van Learn is dezelfde als voor AttributeValueMustBeUnique: bepaal welke waarde dubbel voorkomt en welke objecten erbij betrokken zijn, bepaal welk object de waarde behoudt en verwijder de waarde bij het andere object in de directory waar die vandaan komt.

Nieuwe beschermingen sinds juli 2026

Learn zegt dat vanaf 1 juli 2026 een hard match geblokkeerd kan worden wanneer het doelaccount in de cloud:

  • al onPremisesObjectIdentifier ingesteld heeft,
  • een geprivilegieerde Microsoft Entra-rol toegewezen heeft gekregen, of
  • in aanmerking komt voor een geprivilegieerde Microsoft Entra-rol.

Cloudbeheerde accounts met writeback ingeschakeld vallen hier buiten. Learn zegt dat deze beschermingen hard match voor veilige doelen niet uitschakelen. Het beschrijft ook vlaggen op tenantniveau, BlockSoftMatchEnabled en BlockCloudObjectTakeoverThroughHardMatchEnabled, en een tijdelijke omzeiling, AllowOnPremUpdateOfOnPremisesObjectIdentifierEnabled, die standaard uit staat. Learn waarschuwt dat de omzeiling de bescherming verkleint en dat je hem daarna weer moet uitschakelen. Standaard voert Entra ook geen soft match uit van on-premises gebruikers naar cloudgebruikers die een beheerdersrol hebben, en Microsoft raadt het sterk af om on-premises accounts te synchroniseren met al bestaande beheerdersaccounts.

Als de hard match uit de thread van 2025 vandaag mislukt, kan een van deze beschermingen de oorzaak zijn.

Scenario 2: de synchronisatie lijkt rustig, maar het adres verandert nooit

Wat de thread meldde. Contractors hadden hun eigen externe e-mailadressen nodig in plaats van het bedrijfsadres. De on-premises accounts toonden de juiste adressen in ADUC, maar mail en proxyAddresses in Entra bevatten nog steeds het bedrijfsadres. De vragensteller vond de oorzaak zelf: cloud-only gastaccounts, aangemaakt voor SharePoint-toegang, gebruikten dezelfde externe adressen als de nieuwe on-premises accounts. De vragensteller schreef dat dit het conflict was.

Let op: het geaccepteerde antwoord in die thread was algemeen, en de diagnose kwam van de persoon die de vraag stelde.

Wat Learn toevoegt

  • Entra ID vereist unieke waarden voor mail, proxyAddresses, signInName en userPrincipalName. Een waarde toevoegen of bijwerken die al bij een ander object hoort, veroorzaakt AttributeValueMustBeUnique.
  • Veerkracht bij dubbele attributen is het standaardgedrag en kan niet worden uitgeschakeld. Het werkt alleen voor UPN-waarden en SMTP-waarden in proxyAddresses: Entra zet een dubbele waarde in quarantaine in plaats van de export te laten mislukken. Het lost de gegevens niet op, en de Learn-pagina noemt mail niet tussen de attributen die erbij horen.
  • Bij een dubbele UPN wordt een tijdelijke waarde toegekend in de vorm <OorspronkelijkPrefix>+<4-cijferigNummer>@<InitieelTenantdomein>.onmicrosoft.com. Een SMTP-proxyadres in quarantaine wordt tegengehouden terwijl het object wel wordt aangemaakt of bijgewerkt.
  • Omdat de export slaagt, logt de synchronisatieclient geen fout en probeert hij het niet opnieuw.

Dat komt overeen met wat in de thread werd beschreven: geen zichtbare fout, één waarde ontbreekt. Het geaccepteerde antwoord noemde veerkracht bij dubbele attributen alleen in algemene termen, en niemand bevestigde dat die hier van toepassing was. Dit is dus een plausibele verklaring, geen bevestigde.

Zo vind je de conflicten

  1. Open in het Microsoft Entra-beheercentrum het rapport Synchronisatiefouten in Microsoft Entra Connect Health. Volgens Learn wordt het ongeveer elke 30 minuten ververst en toont het fouten van de laatste synchronisatiepoging.
  2. Voor waarden in quarantaine toont Learn:

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

  1. De oplossing van Learn is hetzelfde voor AttributeValueMustBeUnique en InvalidSoftMatch: bepaal welke waarde dubbel is en welke objecten erbij betrokken zijn, beslis welk object de waarde behoudt, verwijder de waarde bij het andere object in de directory waar dat object vandaan komt, en laat daarna Entra Connect synchroniseren. In sommige gevallen moet je een van de conflicterende objecten verwijderen.
  2. Een achtergrondtaak verwijdert quarantaine-attributen zodra het conflict is opgelost. Volgens Learn draait die elk uur.

Bij de gastgebruiker betekent dat: het adres op de cloud-only gast wijzigen of verwijderen en daarna wachten op de volgende synchronisatie.

Controleren

  1. Zoek de gebruiker op in Entra ID en vergelijk mail, proxyAddresses en UPN met AD.
  2. Voer Start-ADSyncSyncCycle -PolicyType Delta uit en controleer daarna opnieuw.
  3. Controleer of het foutenrapport het object niet langer vermeldt.

Voor bulkwijzigingen beschrijft het Learn-artikel over de stagingserver een manier om openstaande exports vooraf te bekijken met csexport en CSExportAnalyzer, voordat je overschakelt naar de actieve modus.

Beperkingen

  • De threads bewijzen niet welke stap jouw probleem heeft opgelost.
  • De hard-match-commando's in de thread gebruiken een oudere module. Volg de huidige Learn-richtlijnen.
  • Learn beschrijft niet de opruimvolgorde na een per ongeluk aangemaakt duplicaat. Test met één gebruiker.

Gerelateerd

Bronnen

Volg de podcastSpotify

Entities in this article

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

Related articles

RSS