Criar catálogos unidos ao Azure Active Directory Híbrido

Last published : Nov 13, 2026
Este artigo descreve como criar catálogos unidos ao Azure Active Directory (AD) Híbrido.
Você pode criar catálogos unidos ao Azure AD usando o Web Studio ou o PowerShell.
Para obter informações sobre requisitos, limitações e considerações, consulte Unido ao Azure Active Directory Híbrido.
Related information
../../install-configure/create-machine-identities-joined-catalogs.md

Usar o Web Studio

As informações a seguir são um complemento às orientações em Criar catálogos de máquinas. Para criar catálogos unidos ao Azure AD híbrido, siga as orientações gerais desse artigo, atentando-se aos detalhes específicos dos catálogos unidos ao Azure AD híbrido.
No assistente de criação de catálogo:
  • Na página Identidades da Máquina, selecione Unido ao Azure Active Directory Híbrido. As máquinas criadas são de propriedade de uma organização e são conectadas com uma conta do Active Directory Domain Services que pertence a essa organização. Elas existem na nuvem e no local.
Observação:
Se você selecionar Unido ao Azure Active Directory Híbrido como o tipo de identidade, cada máquina no catálogo deve ter uma conta de computador AD correspondente.

Usar PowerShell

A seguir estão as etapas do PowerShell equivalentes às operações no Web Studio. Para obter informações sobre como criar um catálogo usando o SDK do PowerShell Remoto, consulte <https://developer-docs.citrix.com/projects/citrix-virtual-apps-desktops-sdk/en/latest/creating-a-catalog/>.
A diferença entre catálogos unidos ao AD local e catálogos unidos ao Azure AD híbrido reside na criação do pool de identidades e das contas de máquina.
Para criar um pool de identidades junto com as contas para catálogos unidos ao Azure AD híbrido:
New-AcctIdentityPool -AllowUnicode -IdentityType "HybridAzureAD" -Domain "corp.local" -IdentityPoolName "HybridAADJoinedCatalog" -NamingScheme "HybridAAD-VM-##" -NamingSchemeType "Numeric" -OU "CN=AADComputers,DC=corp,DC=local" -Scope @() -ZoneUid "81291221-d2f2-49d2-ab12-bae5bbd0df05"
New-AcctADAccount -IdentityPoolName "HybridAADJoinedCatalog" -Count 10 -ADUserName "corp\admin1" -ADPassword $password
Set-AcctAdAccountUserCert -IdentityPoolName "HybridAADJoinedCatalog" -All -ADUserName "corp\admin1" -ADPassword $password
Observação:
$password é a senha correspondente para uma conta de usuário AD com Permissões de Gravação.
Todos os outros comandos usados para criar catálogos unidos ao Azure AD híbrido são os mesmos que para os catálogos tradicionais unidos ao AD local.

Visualizar o status do processo de união ao Azure AD híbrido

No Web Studio, o status do processo de união ao Azure AD híbrido é visível quando as máquinas unidas ao Azure AD híbrido em um grupo de entrega estão em estado ligado. Para visualizar o status, use Pesquisar para identificar essas máquinas e, em seguida, para cada uma, verifique Identidade da Máquina na guia Detalhes no painel inferior. As seguintes informações podem aparecer em Identidade da Máquina:
  • Unido ao Azure AD Híbrido
  • Ainda não unido ao Azure AD
Observação:
  • Você pode experimentar um atraso na união híbrida ao Azure AD quando a máquina é ligada inicialmente. Isso é causado pelo intervalo de sincronização padrão da identidade da máquina (30 minutos do Azure AD Connect). A máquina estará no estado de união híbrida ao Azure AD somente depois que as identidades da máquina forem sincronizadas com o Azure AD por meio do Azure AD Connect.
  • Se as máquinas não conseguirem entrar no estado de união híbrida ao Azure AD, elas não serão registradas no Delivery Controller. O status de registro delas aparece como Inicialização.
Além disso, usando o Web Studio, você pode descobrir por que as máquinas estão indisponíveis. Para fazer isso, clique em uma máquina no nó Pesquisar, verifique Registro na guia Detalhes no painel inferior e, em seguida, leia a dica de ferramenta para obter informações adicionais.

Solução de problemas

Se as máquinas não conseguirem ser unidas ao Azure AD híbrido, faça o seguinte:
  • Verifique se a conta da máquina foi sincronizada com o Azure AD por meio do portal do Microsoft Azure AD. Se sincronizado, Ainda não unido ao Azure AD aparece, indicando status de registro pendente.
    Para sincronizar contas de máquina com o Azure AD, certifique-se de que:
    • A conta da máquina está na OU configurada para ser sincronizada com o Azure AD. Contas de máquina sem o atributo userCertificate não são sincronizadas com o Azure AD, mesmo que estejam na OU configurada para ser sincronizada.
    • O atributo userCertificate é preenchido na conta da máquina. Use o Active Directory Explorer para visualizar o atributo.
    • O Azure AD Connect deve ter sido sincronizado pelo menos uma vez após a criação da conta da máquina. Caso contrário, execute manualmente o comando Start-ADSyncSyncCycle -PolicyType Delta no console do PowerShell da máquina do Azure AD Connect para acionar uma sincronização imediata.
  • Verifique se o par de chaves do dispositivo gerenciado pelo Citrix para união híbrida ao Azure AD foi enviado corretamente para a máquina consultando o valor de DeviceKeyPairRestored em HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix.
    Verifique se o valor é 1. Caso contrário, as possíveis razões são:
    • IdentityType do pool de identidades associado ao esquema de provisionamento não está definido como HybridAzureAD. Você pode verificar isso executando Get-AcctIdentityPool.
    • A máquina não foi provisionada usando o mesmo esquema de provisionamento do catálogo de máquinas.
    • A máquina não está unida ao domínio local. A união ao domínio local é um pré-requisito para a união híbrida ao Azure AD.
  • Verifique as mensagens de diagnóstico executando o comando dsregcmd /status /debug na máquina provisionada pelo MCS.
    • Se a união híbrida ao Azure AD for bem-sucedida, AzureAdJoined e DomainJoined serão YES na saída da linha de comando.
    • Caso contrário, consulte a documentação da Microsoft para solucionar os problemas: <https://docs.microsoft.com/pt-br/azure/active-directory/devices/troubleshoot-hybrid-join-windows-current>.
    • Se você receber a mensagem de erro Server Message: The user certificate is not found on the device with id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, execute o seguinte comando PowerShell para reparar o certificado do usuário:
      Repair-AcctIdentity -IdentityAccountName TEST\VM1 -Target UserCertificate
      Para obter mais informações sobre o problema do certificado do usuário, consulte CTX566696.