M365Con 2027 – conferência online gratuita · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Entra Connect criou um usuário duplicado ou ignorou um atributo: correspondência leve, correspondência forte e valores duplicados

By ·

Um novo usuário local criou uma segunda conta na nuvem com UPN em onmicrosoft.com, ou o endereço de e-mail nunca foi atualizado. Veja como funciona a correspondência, como interpretar os erros e como revincular com segurança.

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

Duas situações levam as pessoas às regras de correspondência do Entra Connect. Na primeira, um novo usuário local aparece duas vezes na nuvem: a conta que você queria, mais uma nova conta sincronizada com um nome de logon .onmicrosoft.com. Na segunda, a sincronização roda sem erros, mas o mail ou o proxyAddresses de um usuário no Entra ID ainda mostra o endereço antigo.

Pontos-chave

  • O Entra tenta primeiro uma correspondência forte entre o sourceAnchor e o ImmutableId, depois uma correspondência leve pelo userPrincipalName ou pelo endereço SMTP primário e, caso contrário, cria um novo objeto.
  • Se o sufixo de UPN local não estiver verificado no locatário, o Entra monta um novo UPN a partir do mailNickName e do domínio inicial onmicrosoft.com.
  • A resiliência a atributos duplicados coloca em quarentena um valor conflitante de proxyAddresses ou de UPN, em vez de falhar. Por isso, a sincronização pode parecer saudável enquanto um valor está faltando.
  • A partir de 1º de julho de 2026, a Learn diz que a correspondência forte pode ser bloqueada para contas na nuvem que já têm o onPremisesObjectIdentifier definido, que possuem uma função privilegiada ou que são elegíveis para uma.

Os dois casos surgiram em tópicos do Microsoft Q&A, um de janeiro de 2025 e outro de outubro de 2025. Em cada um, a pessoa que perguntou informou o que resolveu o problema. Confiro o embasamento técnico com as páginas atuais da Microsoft Learn. Este é um guia de solução de problemas, não um procedimento oficial da Microsoft. Teste cada alteração em um único usuário antes.

Como o Entra faz a correspondência dos objetos

A Learn descreve esta ordem para um novo objeto vindo do AD:

  1. Correspondência forte. O Entra compara o sourceAnchor com o ImmutableId dos objetos existentes na nuvem. O sourceAnchor padrão é a forma Base64 de mS-Ds-ConsistencyGUID ou de ObjectGUID, dependendo da configuração.
  2. Correspondência leve. Se não houver correspondência forte, o Entra compara o userPrincipalName ou o valor SMTP: primário de proxyAddresses.
  3. Novo objeto. Se nenhuma das duas corresponder, o Entra cria um novo objeto.

A Learn acrescenta duas limitações. A correspondência leve é avaliada apenas para novos objetos. E, em uma correspondência leve, o Entra assume o objeto na nuvem e sobrescreve todos os atributos que têm valor no local. Atributos existentes somente na nuvem podem ser perdidos e, com a sincronização de hash de senha, o hash de senha da nuvem é substituído pelo do local.

Cenário 1: um segundo usuário com UPN em onmicrosoft.com

O que o tópico relatou. Um administrador criou um usuário no AD local. O Entra Connect criou um segundo usuário no Entra com UPN .onmicrosoft.com e o indicador de sincronização local. O usuário na nuvem pretendido não tinha o indicador de sincronização. A resposta aceita descreveu a correspondência leve e a correspondência forte. A pessoa que perguntou escreveu depois que a abordagem de correspondência forte resolveu o problema.

Por que a correspondência pode ter falhado

O tópico não dizia o motivo. O Learn documenta um motivo para o nome onmicrosoft.com: se o sufixo UPN local não estiver verificado no locatário, o Entra calcula um novo UPN a partir do MailNickName e do domínio inicial. Isso também significa que o UPN não pode coincidir com o usuário na nuvem. Isto é uma pista, não um diagnóstico. Compare estes itens nas duas contas:

  • Sufixo UPN e se é um domínio verificado no seu locatário
  • endereço SMTP primário (a entrada SMTP: em proxyAddresses)
  • se o usuário na nuvem já mostra um vínculo com o ambiente local

Opção A: fazer funcionar a correspondência suave

A primeira solução alternativa do tópico foi fazer o UPN local e os endereços proxy coincidirem com o usuário na nuvem, excluir o duplicado e sincronizar novamente. O Learn diz que a correspondência suave é avaliada apenas para objetos novos, e não cobre se um objeto já vinculado é avaliado novamente depois que o duplicado é excluído. Quem fez a pergunta acabou usando a Opção B, então trate a Opção A como não comprovada.

Opção B: correspondência forte

  1. Descubra qual atributo o seu Entra Connect usa como sourceAnchor. O Learn cita mS-Ds-ConsistencyGUID ou ObjectGUID.
  2. Converta o GUID local para Base64. A resposta do tópico usou este padrão:

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

  1. Defina o resultado como o ImmutableId do usuário na nuvem. A resposta do tópico usou Set-MsolUser, que pertence ao módulo MSOnline, mais antigo. As páginas atuais do Learn usam o Microsoft Graph PowerShell. A página do Update-MgUser documenta o parâmetro -OnPremisesImmutableId e informa que apenas funções administrativas privilegiadas específicas podem atualizá-lo. Verifique as observações sobre o parâmetro nessa página antes de executar.
  2. Execute uma sincronização delta:

``powershell Start-ADSyncSyncCycle -PolicyType Delta ``

  1. Confirme que o usuário pretendido na nuvem agora mostra o sinalizador de sincronização e, em seguida, trate o duplicado que restou.

O Learn não descreve a ordem de limpeza para este caso específico. A resposta do tópico definiu o ImmutableId primeiro, sincronizou, verificou e removeu o duplicado depois. Antes de excluir qualquer coisa, verifique as licenças e os dados da caixa de correio do duplicado.

O Learn documenta um erro relacionado, InvalidSoftMatch. Ele ocorre quando a correspondência forte não encontra nada, a correspondência suave encontra um objeto na nuvem, mas esse objeto tem um ImmutableId diferente do sourceAnchor recebido. Isso sugere que o objeto na nuvem foi sincronizado a partir de outro objeto local. A correção do Learn é a mesma usada para AttributeValueMustBeUnique: identifique o valor duplicado e os objetos envolvidos, decida qual objeto mantém o valor e remova-o do outro objeto no diretório de origem.

Novas proteções desde julho de 2026

O Learn informa que, a partir de 1º de julho de 2026, uma correspondência forte pode ser bloqueada quando a conta de destino na nuvem:

  • já tem onPremisesObjectIdentifier definido,
  • tem uma função privilegiada do Microsoft Entra atribuída, ou
  • é elegível para uma função privilegiada do Microsoft Entra.

Contas gerenciadas na nuvem com writeback habilitado são excluídas. O Learn diz que essas proteções não desativam a correspondência forte para destinos seguros. Ele também descreve as flags em todo o locatário, BlockSoftMatchEnabled e BlockCloudObjectTakeoverThroughHardMatchEnabled, e uma exceção temporária, AllowOnPremUpdateOfOnPremisesObjectIdentifierEnabled, que vem desativada por padrão. O Learn alerta que essa exceção reduz a proteção e deve ser desligada depois. Por padrão, o Entra também não faz correspondência suave entre usuários locais e usuários na nuvem que tenham uma função de administrador, e a Microsoft recomenda fortemente não sincronizar contas locais com contas de administrador pré-existentes.

Portanto, se a correspondência forte do tópico de 2025 falhar hoje, uma dessas proteções pode ser o motivo.

Cenário 2: a sincronização não dá erro, mas o endereço nunca muda

O que o tópico relatou. Terceiros precisavam de seus próprios endereços de e-mail externos em vez do endereço da empresa. As contas locais mostravam os endereços corretos no ADUC, mas mail e proxyAddresses no Entra ainda mantinham o endereço da empresa. Quem fez a pergunta descobriu a causa sozinho: contas de convidado somente na nuvem, criadas para acesso ao SharePoint, usavam os mesmos endereços externos das novas contas locais. Quem perguntou escreveu que isso era o conflito.

Observe que a resposta aceita nesse tópico era genérica, e o diagnóstico veio de quem fez a pergunta.

O que o Learn acrescenta

  • O Entra ID exige valores únicos para mail, proxyAddresses, signInName e userPrincipalName. Adicionar ou atualizar um valor que outro objeto já possui causa AttributeValueMustBeUnique.
  • A resiliência a atributos duplicados é o comportamento padrão e não pode ser desativada. Ela trata apenas valores de UPN e de proxyAddresses SMTP: o Entra coloca em quarentena um valor duplicado em vez de fazer a exportação falhar. Ela não corrige os dados, e a página do Learn não lista mail entre os atributos que cobre.
  • Para um UPN duplicado, é atribuído um marcador no formato <OriginalPrefix>+<4DigitNumber>@<InitialTenantDomain>.onmicrosoft.com. Um endereço proxy SMTP em quarentena fica retido enquanto o objeto continua sendo criado ou atualizado.
  • Como a exportação é bem-sucedida, o cliente de sincronização não registra nenhum erro e não tenta novamente.

Isso corresponde ao que a discussão descreveu: nenhuma falha visível e um valor ausente. A resposta aceita mencionou a resiliência a atributos duplicados apenas em termos gerais, e ninguém confirmou que ela se aplicava. Portanto, esta é uma explicação plausível, não confirmada.

Como encontrar os conflitos

  1. No centro de administração do Microsoft Entra, abra o relatório Erros de sincronização no Microsoft Entra Connect Health. O Learn informa que ele é atualizado a cada 30 minutos, aproximadamente, e mostra os erros da tentativa de sincronização mais recente.
  2. Para valores em quarentena, o Learn mostra:

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

  1. A correção indicada pelo Learn é a mesma para AttributeValueMustBeUnique e InvalidSoftMatch: identifique o valor duplicado e os objetos envolvidos, decida qual objeto mantém o valor, remova-o do outro objeto no diretório de onde esse objeto é originado e então deixe o Entra Connect sincronizar. Em alguns casos, pode ser necessário excluir um dos objetos em conflito.
  2. Um trabalho em segundo plano remove os atributos em quarentena assim que o conflito é resolvido. O Learn informa que ele é executado a cada hora.

No caso de convidados, isso significa alterar ou remover o endereço do convidado somente em nuvem e, em seguida, aguardar a próxima sincronização.

Verificar

  1. Procure o usuário no Entra ID e compare mail, proxyAddresses e UPN com o AD.
  2. Execute Start-ADSyncSyncCycle -PolicyType Delta e verifique novamente.
  3. Confirme que o relatório de erros não lista mais o objeto.

Para alterações em massa, o artigo do Learn sobre servidor de staging descreve uma forma de visualizar as exportações pendentes com csexport e CSExportAnalyzer antes de mudar para o modo ativo.

Limitações

  • As discussões não comprovam qual etapa resolveu o seu caso.
  • Os comandos de hard match da discussão usam um módulo mais antigo. Siga a orientação atual do Learn.
  • O Learn não documenta a ordem de limpeza após a criação incorreta de um duplicado. Teste com um usuário.

Relacionados

Fontes

Seguir o podcastSpotify

Entities in this article

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

Related articles

RSS