DEV Community

Eduardo Silva
Eduardo Silva

Posted on

Hybrid Join travado: por que seus dispositivos ficam presos em "Pendente" no Microsoft Entra Connect

Hybrid Join travado: por que seus dispositivos ficam presos em "Pendente" no Microsoft Entra Connect

Se você administra um ambiente híbrido com Active Directory local e Microsoft Entra ID (antigo Azure AD), já deve ter visto esse cenário: o notebook do usuário está corretamente DomainJoined, o Entra Connect está sincronizando sem erros, mas o dispositivo nunca sai do estado "Pendente" no Entra ID — e o usuário não consegue usar SSO, Windows Hello for Business ou políticas de Conditional Access baseadas em dispositivo.

Esse artigo é um guia prático de diagnóstico e correção do Microsoft Entra hybrid join (o nome atual do antigo "Azure AD hybrid join"), usando a ferramenta nativa dsregcmd e os passos que a própria Microsoft recomenda.[1]

O que é "hybrid join" na prática

Um dispositivo Windows pode assumir quatro estados de identidade de device, combinando três flags que o dsregcmd /status expõe:[2]

AzureAdJoined EnterpriseJoined DomainJoined Estado
NO NO YES Domain Joined (só local)
YES NO NO Microsoft Entra joined (cloud nativo)
YES NO YES Microsoft Entra hybrid joined
NO YES YES On-premises DRS Joined

O objetivo do hybrid join é o terceiro caso: o dispositivo pertence ao domínio AD local e está registrado no Entra ID, sincronizado automaticamente via Microsoft Entra Connect (Entra Connect Sync).

Passo 1 — Rodar o diagnóstico básico

No dispositivo com problema, abra um Prompt de Comando como administrador e rode:

dsregcmd /status
Enter fullscreen mode Exit fullscreen mode

Verifique três campos na seção "Device State":[2]

  • DomainJoined : YES — se for NO, o dispositivo não pode fazer hybrid join, ponto final.
  • AzureAdJoined — deve virar YES quando o join terminar. Se ficar em NO indefinidamente, o join não está completando.
  • WorkplaceJoined : NO — se estiver YES num PC de domínio, há um registro "Entra registered" pessoal competindo com o hybrid join; ele some automaticamente no próximo logon do usuário após o hybrid join se completar.[1]

Role a saída até a seção "Diagnostic Data" (aparece só quando o dispositivo está domain-joined e falhando o hybrid join). Nela você encontra Error Phase e Client ErrorCode — é o par de informações mais importante para abrir um chamado ou buscar a causa.[1]

+----------------------------------------------------------------------+
| Diagnostic Data                                                      |
+----------------------------------------------------------------------+
AD Connectivity Test : PASS
AD Configuration Test : PASS
DRS Discovery Test : FAIL [0x801c0021/0x80072ee2]
DRS Connectivity Test : SKIPPED
Token acquisition Test : SKIPPED
+----------------------------------------------------------------------+
Enter fullscreen mode Exit fullscreen mode

Passo 2 — Interpretar os erros mais comuns

Alguns códigos que aparecem com frequência em ambientes reais:[1]

  • DSREG_AUTOJOIN_ADCONFIG_READ_FAILED (0x801c001d) — o dispositivo não conseguiu ler o Service Connection Point (SCP) no AD, ou seja, não descobriu o tenant do Entra ID. Verifique se o SCP foi criado corretamente durante a instalação do Entra Connect (ele é criado automaticamente pelo assistente quando a conta usada tem permissão na partição de configuração do AD).
  • DSREG_AUTOJOIN_DISC_FAILED / DISC_WAIT_TIMEOUT (0x801c0021 / 0x801c001f) — falha ou timeout de conectividade. O dispositivo (em contexto SYSTEM) precisa alcançar enterpriseregistration.windows.net, login.microsoftonline.com e device.login.microsoftonline.com na porta 443, sem interceptação de proxy/SSL.[1][3]
  • Erro de servidor "The device object by the given id isn't found" — normal durante o processo: significa que o objeto do dispositivo ainda não chegou via sincronização do Entra Connect. A solução é esperar o próximo ciclo de sync (ou forçar um delta).[1]

Para testar conectividade manualmente:

Test-NetConnection -ComputerName enterpriseregistration.windows.net -Port 443
Test-NetConnection -ComputerName login.microsoftonline.com -Port 443
Test-NetConnection -ComputerName device.login.microsoftonline.com -Port 443
Enter fullscreen mode Exit fullscreen mode

Passo 3 — Forçar o ciclo de sincronização no servidor do Entra Connect

Muito travamento em "Pendente" é só sincronização atrasada. No servidor do Microsoft Entra Connect:

Import-Module ADSync
Start-ADSyncSyncCycle -PolicyType Delta
Enter fullscreen mode Exit fullscreen mode

Depois do delta sync terminar, volte ao dispositivo e force uma nova tentativa de join:

dsregcmd /leave
# reinicie o dispositivo
dsregcmd /join
Enter fullscreen mode Exit fullscreen mode

⚠️ dsregcmd /leave remove o registro do device — rode fora do horário de pico e avise o usuário, pois o Windows Hello for Business e certificados ligados ao device precisarão ser reconfigurados.

Passo 4 — Checar o status pós-join (PRT)

Hybrid join concluído não significa SSO funcionando. Depois que AzureAdJoined virar YES, confira a seção "SSO State" do dsregcmd /status, rodado sem elevação, na sessão do usuário logado:[1]

+----------------------------------------------------------------------+
| SSO State                                                            |
+----------------------------------------------------------------------+
AzureAdPrt : YES
AzureAdPrtUpdateTime : 2026-11-10 10:12:00.000 UTC
AzureAdPrtExpiryTime : 2026-11-24 10:12:00.000 UTC
+----------------------------------------------------------------------+
Enter fullscreen mode Exit fullscreen mode

AzureAdPrt : NO indica falha ao obter o Primary Refresh Token — sem ele não há SSO real para apps que dependem de identidade de dispositivo. Se AzureAdPrtUpdateTime estiver parado há mais de 4 horas, bloqueie e desbloqueie a sessão para forçar um refresh e veja se o timestamp atualiza.[1]

Passo 5 — Causa recorrente: objeto movido de OU

Um padrão bem documentado: o objeto de computador foi movido para uma OU fora do escopo de sincronização do Entra Connect, o Entra Connect interpretou isso como exclusão e removeu o device do Entra ID; quando o objeto volta para a OU correta, o Entra Connect recria um objeto "pendente", mas o dispositivo já tinha um registro anterior e não completa o re-registro.[1][3]

A correção:

  1. Confirme que a OU do dispositivo está dentro do escopo de sincronização configurado no Entra Connect (wizard → "Domain and OU filtering").
  2. No dispositivo, rode dsregcmd /leave, reinicie.
  3. O re-registro roda automaticamente pela tarefa agendada Automatic-Device-Join Task, em Task Scheduler Library > Microsoft > Windows > Workplace Join. Você pode disparar manualmente clicando com o botão direito nela e selecionando "Executar".[3]

Checklist rápido

  • [ ] DomainJoined : YES e WorkplaceJoined : NO antes de investigar mais a fundo
  • [ ] Conectividade 443 liberada para os três endpoints de registro de dispositivo
  • [ ] Objeto de computador dentro do escopo de OU do Entra Connect
  • [ ] Delta sync forçado após qualquer ajuste de escopo ou AD
  • [ ] AzureAdPrt : YES confirmado após o join — não só o AzureAdJoined
  • [ ] Event Viewer → Applications and Services Logs > Microsoft > Windows > User Device Registration, eventos 304/305/307, para erros que não aparecem no dsregcmd /status[1]

Conclusão

O hybrid join falha silenciosamente por três motivos na grande maioria dos casos: SCP mal configurado, bloqueio de rede para os endpoints de registro, ou um objeto de computador fora do escopo de sincronização do Entra Connect. O dsregcmd /status sempre traz a pista certa na seção "Diagnostic Data" — o erro é não ler até lá. Combine isso com um delta sync forçado e o Event Viewer como segunda fonte, e a maioria dos tickets de "dispositivo preso em pendente" se resolve sem precisar reconstruir o Entra Connect.

📚 Recursos recomendados


Sources

[1] https://learn.microsoft.com/en-us/entra/identity/devices/troubleshoot-hybrid-join-windows-current — Troubleshoot Microsoft Entra hybrid joined devices - MS Learn
[2] https://learn.microsoft.com/en-us/entra/identity/devices/troubleshoot-device-dsregcmd — Troubleshoot devices using dsregcmd - MS Learn
[3] https://learn.microsoft.com/en-us/entra/identity/devices/how-to-hybrid-join — How to plan hybrid join - MS Learn

Top comments (0)