Pool de identidades de identidade de máquina híbrida unida ao Microsoft Entra

Last published : Nov 03, 2026
Este artigo descreve como criar um pool de identidades de identidade de máquina híbrida unida ao Microsoft Entra usando o Citrix DaaS.
Para obter informações sobre requisitos, limitações e considerações, consulte Microsoft Entra híbrido unido.
Related information
Pools de identidade de diferentes tipos de junção de identidade de máquina

Usar o Studio

As informações a seguir são um suplemento às orientações em Criar catálogos de máquinas. Para criar catálogos híbridos unidos ao Microsoft Entra, siga as orientações gerais desse artigo, atentando-se aos detalhes específicos dos catálogos híbridos unidos ao Microsoft Entra.
No assistente de criação de catálogo:
  1. Na página Identidades da Máquina:
    1. Selecione o tipo de identidade como Microsoft Entra híbrido unido.
    2. Em Configurações avançadas, clique em Selecionar conta de serviço e selecione uma conta de serviço disponível na lista. Se uma conta de serviço adequada não estiver disponível para as identidades da máquina se unirem, você poderá criar uma conta de serviço. Para obter informações sobre contas de serviço, consulte Contas de serviço do Microsoft Entra.
    3. Clique em Adicionar Atributos de Extensão para armazenar dados exclusivos e personalizados diretamente nos objetos de dispositivo do Entra ID. Na página Adicionar Atributos de Extensão, adicione Atributos de extensão e Valor.
      Nota:
      • Você pode adicionar no máximo 15 atributos de extensão.
      • O nome e o valor devem ser únicos e não podem estar vazios.
    4. Selecione uma opção de conta do Active Directory:
      • Criar novas contas do Active Directory:
        • Se você selecionar Criar novas contas do Active Directory e usar um pool de identidades existente para criar novas contas, selecione um domínio para essas contas e especifique um esquema de nomenclatura de conta.
        • Se você selecionar Criar novas contas do Active Directory e usar um pool de identidades existente para criar novas contas, selecione um pool de identidades na lista.
      • Usar contas existentes do Active Directory: Você pode procurar ou importar de um arquivo CSV e redefinir a senha ou especificar a mesma senha para todas as contas.
    5. Clique em Avançar.
  2. Na página Credenciais de domínio, selecione uma conta de serviço ou insira as credenciais manualmente. O pool de identidades híbrido do Microsoft Entra também pode ser associado a uma conta de serviço AD local. Para obter informações sobre contas de serviço, consulte Contas de serviço do Active Directory local.

Adicionar ou modificar atributos de extensão

Para alterar ou adicionar atributos de extensão adicionais a um catálogo de máquinas MCS existente, ou adicionar atributos de extensão a um catálogo MCS sem uma conta de serviço, use o assistente Editar Catálogo de Máquinas.
  • Para alterar ou adicionar atributos de extensão adicionais, navegar até a página Atributos de Extensão de Dispositivo do Microsoft Entra. Clique no ícone de lápis e adicione ou atualize os atributos de extensão.
  • Para adicionar atributos de extensão a um catálogo MCS sem uma conta de serviço do Microsoft Entra:
    1. navegar até a página Conta de Serviço. Selecione uma conta de serviço do Microsoft Entra para o Microsoft Intra ID.
    2. Vá para a página Atributos de Extensão de Dispositivo do Microsoft Entra, clique em Adicionar Atributos de Extensão.

Usar PowerShell

As seguintes etapas do PowerShell são equivalentes às operações no Studio.
A diferença entre catálogos unidos ao AD local e catálogos híbridos do Microsoft Entra reside na criação do pool de identidades e das contas de máquina.

Criar novo pool de identidades

Por exemplo: Para criar um pool de identidades junto com as contas para catálogos unidos ao Microsoft Entra 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
Nota:
O $password é a senha correspondente para uma conta de usuário do AD com Permissões de Gravação.
Todos os outros comandos usados para criar catálogos unidos ao Microsoft Entra híbrido são os mesmos que para catálogos tradicionais unidos ao AD local.
Você também pode associar uma conta de serviço local a um catálogo de máquinas criado pelo MCS, associando uma conta de serviço local ao pool de identidades. Você pode criar um pool de identidades ou atualizar um pool de identidades existente para associá-lo a uma conta de serviço.
Por exemplo: Para criar um novo pool de identidades e associá-lo a uma conta de serviço, execute o seguinte:
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" -ServiceAccountUid $serviceAccountUid
Por exemplo: Para criar um novo pool de identidades com atributos de extensão especificados e associá-lo a uma conta de serviço, execute o seguinte:
New-AcctIdentityPool -IdentityPoolName HybridAzureAD -NamingScheme ACC#### -NamingSchemeType Numeric -Domain "abc.local" -IdentityType HybridAzureAD -ServiceAccountUid $serviceAccountUid -EntraIDExtensionAttributes @{"extensionAttribute1" = "val1"; "extensionAttribute2" = "val2"}
Quando uma VM é ligada pela primeira vez, após ingressar no Microsoft Entra ID, a VM reporta seu deviceId do Entra ID ao MCS.
Por exemplo: Para verificar o EntraIDDeviceID, execute Get-AcctADAccount ou Get-AcctIdentity.
Get-AcctADAccount -IdentityPoolName MyPool
Após a reinicialização, para VMs persistentes e não persistentes, o EntraIDDeviceID permanece o mesmo.
Nota:
O MCS remove automaticamente os IDs de dispositivo associados e os atributos de extensão quando você exclui uma VM do catálogo, mas não a exclui do Azure.

Atualizar pool de identidades existente

Por exemplo: Para atualizar um pool de identidades existente para associá-lo a uma conta de serviço, execute o seguinte:
$identityPoolUid = (Get-ProvScheme -ProvisioningSchemeName "MyProvScheme").IdentityPoolUid

Set-AcctIdentityPool -IdentityPoolUid $identityPoolUid -ServiceAccountUid $serviceAccountUid
Nota:
O $serviceAccountUid deve ser um UID válido de uma conta de serviço do Active Directory local.
Por exemplo: Para editar atributos de extensão para o catálogo existente, execute o seguinte:
Nota:
  • Após atualizar as VMs do catálogo existente para a versão 2511 ou posterior do VDA, é necessário reiniciar. Essa reinicialização permite que a VM relate seu deviceId do Entra ID ao MCS, permitindo que o MCS configure os atributos de extensão da VM.
  • O catálogo existente deve ter uma conta de serviço do tipo AzureAD com a permissão "Device.ReadWrite.All".
Para adicionar novos atributos:
Set-AcctIdentityPool -IdentityPoolName MyPool -EntraIDExtensionAttributes @{"extensionAttribute1" = "val1"; "extensionAttribute2" = "val2"}
Para remover alguns atributos existentes
Set-AcctIdentityPool -IdentityPoolName MyPool -EntraIDExtensionAttributes @{}
OU
Set-AcctIdentityPool -IdentityPoolName MyPool -EntraIDExtensionAttributes @{extensionAttribute1 = ""; extensionAttribute2 = ""}
Set-AcctIdentityPool também atualiza os atributos de extensão do dispositivo Entra ID para VMs que já estão unidas ao Entra ID e possuem um valor EntraIDDeviceID em suas identidades.

Criar um catálogo híbrido do Microsoft Entra

Você também pode criar um catálogo híbrido do Microsoft Entra usando uma imagem preparada. Para o conjunto completo de comandos do PowerShell para criar a definição de imagem, a versão da imagem e a especificação da versão da imagem preparada, consulte:
  • Ambiente de virtualização do Azure: Usar PowerShell.
  • Ambiente de virtualização VMware: Usar PowerShell
Após criar a especificação da versão da imagem preparada, crie o pool de identidades e o catálogo de máquinas. Por exemplo:
New-AcctIdentityPool -IdentityPoolName "mypool" -NamingScheme ACC##  -NamingSchemeType "Numeric"  -ZoneUid $zoneuid -Domain $domainName -OU "OU=HAAD Computers,DC=haad,DC=link" -IdentityType "HybridAzureAD"

New-ProvScheme -ProvisioningSchemeName <name> -ImageVersionSpecUid <preparedVersionSpecUid> -HostingUnitUid <hostingUnitUid> -IdentityPoolUid <IdentityPoolUid> [-CleanOnBoot] -NetworkMapping @{"0"="XDHyp:\HostingUnits\<hostingunitName>\<region>.region\virtualprivatecloud.folder\<resourcegroupName>.resourcegroup\<vnetName>.virtualprivatecloud\<sunNetName>.network"} -ServiceOffering <serviceofferingPath> [-MachineProfile <machineProfilePath>] [-CustomProperties <>]

Visualizar o status do processo de junção híbrida do Microsoft Entra

No Studio, o status do processo de junção híbrida do Microsoft Entra é visível quando as máquinas unidas hibridamente ao Microsoft Entra 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 hibridamente ao Microsoft Entra
  • Ainda não unido ao Microsoft Entra ID
Nota:
  • Você pode experimentar um atraso na junção híbrida do Microsoft Entra quando a máquina é ligada inicialmente. Isso é causado pelo intervalo de sincronização padrão da identidade da máquina (30 minutos do Microsoft Entra Connect). A máquina estará no estado de junção híbrida do Microsoft Entra somente depois que as identidades da máquina forem sincronizadas com o Microsoft Entra ID através do Microsoft Entra Connect.
  • Se as máquinas não conseguirem entrar no estado de junção híbrida do Microsoft Entra, elas não serão registradas no Delivery Controller. O status de registro delas aparece como Inicialização.
Além disso, usando o 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 hibridamente ao Microsoft Entra, faça o seguinte:
  • Verifique se a conta da máquina foi sincronizada com o Microsoft Entra ID através do portal Microsoft Microsoft Entra. Se sincronizada, Ainda não unido ao Microsoft Entra ID aparece, indicando status de registro pendente.
    Para sincronizar contas de máquina com o Microsoft Entra ID, certifique-se de que:
    • A conta da máquina está na UO configurada para ser sincronizada com o Microsoft Entra ID. Contas de máquina sem o atributo userCertificate não são sincronizadas com o Microsoft Entra ID, mesmo que estejam na UO configurada para ser sincronizada.
    • O atributo userCertificate é preenchido na conta da máquina. Use o Active Directory Explorer para visualizar o atributo.
    • O Microsoft Entra 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 Microsoft Entra Connect para acionar uma sincronização imediata.
  • Verifique se o par de chaves do dispositivo gerenciado pelo Citrix para junção híbrida do Microsoft Entra foi corretamente enviado 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á ingressada no domínio local. O ingresso no domínio local é um pré-requisito para o ingresso híbrido no Microsoft Entra.
  • Verifique as mensagens de diagnóstico executando o comando dsregcmd /status /debug na máquina provisionada pelo MCS.
    • Se o ingresso híbrido no Microsoft Entra for bem-sucedido, AzureAdJoined e DomainJoined serão SIM 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.