M365Con 2027 – conferenza online gratuita · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Entra Connect ha creato un utente duplicato o ignorato un attributo: soft match, hard match e valori duplicati

By ·

Un nuovo utente on-premises ha creato un secondo account cloud con UPN onmicrosoft.com, oppure l'indirizzo e-mail non si è mai aggiornato. Scopri come funziona la corrispondenza, come leggere gli errori e come ricollegare gli oggetti in sicurezza.

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

Due situazioni portano alle regole di corrispondenza di Entra Connect. Nella prima, un nuovo utente on-premises compare due volte nel cloud: l'account che volevi, più un nuovo account sincronizzato con un nome di accesso .onmicrosoft.com. Nella seconda, la sincronizzazione viene eseguita senza errori, ma il valore mail o proxyAddresses di un utente in Entra ID mostra ancora il vecchio indirizzo.

Punti chiave

  • Entra prova prima un hard match su sourceAnchor rispetto a ImmutableId, poi un soft match su userPrincipalName o sull'indirizzo SMTP primario, e in caso contrario crea un nuovo oggetto.
  • Se il suffisso UPN on-premises non è verificato nel tenant, Entra costruisce un nuovo UPN a partire da mailNickName e dal dominio iniziale onmicrosoft.com.
  • La resilienza agli attributi duplicati mette in quarantena un valore proxyAddresses o UPN in conflitto invece di far fallire la sincronizzazione, quindi la sincronizzazione può sembrare regolare mentre un valore manca.
  • Dal 1° luglio 2026, secondo Learn, l'hard match può essere bloccato per gli account cloud che hanno già impostato onPremisesObjectIdentifier, che detengono un ruolo privilegiato o che sono idonei a ricoprirlo.

Entrambi i casi sono emersi in discussioni di Microsoft Q&A, una di gennaio 2025 e una di ottobre 2025. In ciascuna, chi ha posto la domanda ha riportato cosa ha risolto il problema. Ho verificato il contesto tecnico sulle pagine attuali di Microsoft Learn. Questa è una guida alla risoluzione dei problemi, non una procedura ufficiale Microsoft. Testa ogni modifica prima su un solo utente.

Come Entra abbina gli oggetti

Learn descrive questo ordine per un nuovo oggetto proveniente da AD:

  1. Hard match. Entra confronta il sourceAnchor con il ImmutableId degli oggetti cloud esistenti. Il sourceAnchor predefinito è la forma Base64 di mS-Ds-ConsistencyGUID, oppure di ObjectGUID, a seconda della configurazione.
  2. Soft match. Se non c'è un hard match, Entra confronta userPrincipalName o il valore SMTP: primario di proxyAddresses.
  3. Nuovo oggetto. Se nessuno dei due trova corrispondenza, Entra crea un nuovo oggetto.

Learn aggiunge due limiti. Il soft match viene valutato solo per i nuovi oggetti. E in caso di soft match, Entra assume il controllo dell'oggetto cloud e sovrascrive ogni attributo che ha un valore on-premises. Gli attributi esistenti solo nel cloud possono andare persi e, con la sincronizzazione dell'hash della password, l'hash cloud viene sostituito da quello on-premises.

Scenario 1: un secondo utente con UPN onmicrosoft.com

Cosa ha riportato la discussione. Un amministratore ha creato un utente in AD on-premises. Entra Connect ha creato un secondo utente Entra con UPN .onmicrosoft.com e con il flag di sincronizzazione on-premises. L'utente cloud previsto non aveva il flag di sincronizzazione. La risposta accettata descriveva sia il soft match sia l'hard match. Chi ha posto la domanda ha poi scritto che l'approccio con hard match ha risolto il problema.

Perché la corrispondenza potrebbe non essere riuscita

Il thread non spiegava il motivo. Learn documenta un'unica ragione per il nome onmicrosoft.com: se il suffisso UPN locale non è verificato nel tenant, Entra calcola un nuovo UPN dal MailNickName e dal dominio iniziale. Questo significa anche che l'UPN non può corrispondere all'utente cloud. È una pista, non una diagnosi. Confronta questi elementi su entrambi gli account:

  • suffisso UPN e se si tratta di un dominio verificato nel tuo tenant
  • indirizzo SMTP primario (la voce SMTP: in proxyAddresses)
  • se l'utente cloud mostra già un collegamento locale

Opzione A: far funzionare il soft match

La prima soluzione proposta nel thread era far corrispondere l'UPN locale e gli indirizzi proxy all'utente cloud, eliminare il duplicato e sincronizzare di nuovo. Learn specifica che il soft match viene valutato solo per gli oggetti nuovi e non copre la rivalutazione di un oggetto già collegato dopo l'eliminazione del duplicato. Chi ha posto la domanda ha alla fine usato l'Opzione B, quindi considera l'Opzione A non dimostrata.

Opzione B: hard match

  1. Scopri quale attributo usa Entra Connect come sourceAnchor. Learn indica mS-Ds-ConsistencyGUID o ObjectGUID.
  2. Converti in Base64 il GUID locale. La risposta nel thread usava questo schema:

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

  1. Imposta il risultato come ImmutableId dell'utente cloud. La risposta nel thread usava Set-MsolUser, che appartiene al modulo MSOnline, ormai superato. Le pagine attuali di Learn usano Microsoft Graph PowerShell. La pagina Update-MgUser documenta il parametro -OnPremisesImmutableId e indica che solo alcuni ruoli amministrativi privilegiati possono aggiornarlo. Controlla le note sul parametro in quella pagina prima di eseguirlo.
  2. Esegui una sincronizzazione delta:

``powershell Start-ADSyncSyncCycle -PolicyType Delta ``

  1. Verifica che l'utente cloud previsto mostri ora il flag di sincronizzazione, poi occupati del duplicato rimasto.

Learn non descrive l'ordine di pulizia per questo caso specifico. La risposta nel thread ha impostato prima l'ImmutableId, ha sincronizzato, verificato e rimosso il duplicato in seguito. Prima di eliminare qualsiasi cosa, controlla licenze e dati della casella sul duplicato.

Learn documenta un errore correlato, InvalidSoftMatch. Si verifica quando l'hard match non trova nulla, il soft match trova un oggetto cloud, ma quell'oggetto ha un ImmutableId diverso dal sourceAnchor in arrivo. Questo fa pensare che l'oggetto cloud sia stato sincronizzato da un altro oggetto locale. La soluzione indicata da Learn è la stessa prevista per AttributeValueMustBeUnique: individua il valore duplicato e gli oggetti coinvolti, decidi quale oggetto lo conserva e rimuovi il valore dall'altro oggetto nella directory da cui proviene.

Nuove protezioni da luglio 2026

Learn indica che, dal 1° luglio 2026, un hard match può essere bloccato quando l'account cloud di destinazione:

  • ha già impostato onPremisesObjectIdentifier,
  • ha assegnato un ruolo privilegiato di Microsoft Entra, oppure
  • è idoneo per un ruolo privilegiato di Microsoft Entra.

Gli account gestiti nel cloud con writeback abilitato sono esclusi. Learn spiega che queste protezioni non disattivano l'hard match per i destinatari sicuri. Descrive anche i flag a livello di tenant, BlockSoftMatchEnabled e BlockCloudObjectTakeoverThroughHardMatchEnabled, e un bypass temporaneo, AllowOnPremUpdateOfOnPremisesObjectIdentifierEnabled, disattivato per impostazione predefinita. Learn avverte che il bypass riduce la protezione e va disattivato al termine. Per impostazione predefinita, Entra non esegue il soft match tra utenti locali e utenti cloud che hanno un ruolo amministrativo, e Microsoft sconsiglia fortemente di sincronizzare account locali con account amministrativi preesistenti.

Quindi, se l'hard match del thread del 2025 oggi non funziona, una di queste protezioni potrebbe essere il motivo.

Scenario 2: la sincronizzazione è regolare, ma l'indirizzo non cambia mai

Cosa riportava il thread. I collaboratori esterni avevano bisogno del proprio indirizzo di posta esterno al posto di quello aziendale. Gli account locali mostravano gli indirizzi corretti in ADUC, ma mail e proxyAddresses in Entra conservavano ancora l'indirizzo aziendale. Chi ha posto la domanda ha trovato da solo la causa: account ospite solo cloud, creati per l'accesso a SharePoint, usavano gli stessi indirizzi esterni dei nuovi account locali. Chi ha posto la domanda ha scritto che questo era il conflitto.

Nota che la risposta accettata in quel thread era generica, e la diagnosi è venuta da chi ha posto la domanda.

Cosa aggiunge Learn

  • Entra ID richiede valori univoci per mail, proxyAddresses, signInName e userPrincipalName. Aggiungere o aggiornare un valore già assegnato a un altro oggetto genera AttributeValueMustBeUnique.
  • La resilienza agli attributi duplicati è il comportamento predefinito e non può essere disattivata. Gestisce solo i valori UPN e proxyAddresses SMTP: Entra mette in quarantena un valore duplicato invece di far fallire l'esportazione. Non corregge i dati, e la pagina di Learn non elenca mail tra gli attributi coperti.
  • Per un UPN duplicato viene assegnato un segnaposto nella forma <PrefissoOriginale>+<NumeroDi4Cifre>@<DominioIniziale>.onmicrosoft.com. Un indirizzo proxy SMTP in quarantena viene trattenuto mentre l'oggetto viene comunque creato o aggiornato.
  • Poiché l'esportazione va a buon fine, il client di sincronizzazione non registra alcun errore e non riprova.

Corrisponde a quanto descritto nella discussione: nessun errore visibile, un valore mancante. La risposta accettata menzionava la resilienza agli attributi duplicati solo in termini generali, e nessuno ha confermato che si applicasse, quindi si tratta di una spiegazione plausibile, non confermata.

Come trovare i conflitti

  1. Nell'interfaccia di amministrazione di Microsoft Entra, apri il report Errori di sincronizzazione in Microsoft Entra Connect Health. Secondo Learn viene aggiornato circa ogni 30 minuti e mostra gli errori del tentativo di sincronizzazione più recente.
  2. Per i valori in quarantena, Learn mostra:

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

  1. La soluzione indicata da Learn è la stessa per AttributeValueMustBeUnique e InvalidSoftMatch: individua il valore duplicato e gli oggetti coinvolti, decidi quale oggetto lo conserva, rimuovilo dall'altro oggetto nella directory da cui quell'oggetto viene sincronizzato, quindi lascia che Entra Connect sincronizzi. In alcuni casi potrebbe essere necessario eliminare uno degli oggetti in conflitto.
  2. Un processo in background rimuove gli attributi in quarantena una volta risolto il conflitto. Secondo Learn viene eseguito ogni ora.

Nel caso dei guest, significa modificare o rimuovere l'indirizzo sul guest solo cloud, quindi attendere la sincronizzazione successiva.

Verifica

  1. Cerca l'utente in Entra ID e confronta mail, proxyAddresses e UPN con AD.
  2. Esegui Start-ADSyncSyncCycle -PolicyType Delta, quindi ricontrolla.
  3. Verifica che il report degli errori non elenchi più l'oggetto.

Per le modifiche in blocco, l'articolo di Learn sul server di staging descrive un modo per visualizzare in anteprima le esportazioni in sospeso con csexport e CSExportAnalyzer prima di passare alla modalità attiva.

Limiti

  • Le discussioni non dimostrano quale passaggio abbia risolto il tuo caso.
  • I comandi di hard match presenti nella discussione usano un modulo più vecchio. Segui le indicazioni attuali di Learn.
  • Learn non documenta l'ordine di pulizia dopo la creazione errata di un duplicato. Fai delle prove con un solo utente.

Correlati

Fonti

Segui il podcastSpotify

Entities in this article

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

Related articles

RSS