Unido hibridamente ao Microsoft Entra

Last published : Nov 13, 2026
Observação:
Desde julho de 2023, a Microsoft renomeou o Azure Active Directory (Azure AD) para Microsoft Entra ID. Neste documento, qualquer referência a Azure Active Directory, Azure AD ou AAD agora se refere a Microsoft Entra ID.
Este artigo descreve os requisitos para criar um pool de identidades de catálogos híbridos do Microsoft Entra, além dos requisitos descritos na seção de requisitos do sistema.
Máquinas híbridas do Microsoft Entra usam o AD local como provedor de autenticação. Você pode atribuí-las a usuários ou grupos de domínio no AD local. Para habilitar a experiência de SSO contínuo do Azure AD, você precisa ter os usuários de domínio sincronizados com o Azure AD.
Observação:
VMs híbridas do Microsoft Entra são suportadas em infraestruturas de identidade federadas e gerenciadas.

Requisitos

  • Tipo de VDA: Sessão única (somente desktops) ou multi-sessão (aplicativos e desktops)
  • Versão do VDA: 2212 ou posterior
  • Tipo de provisionamento: Machine Creation Services™ (MCS), Persistente e Não persistente
  • Tipo de atribuição: Dedicado e agrupado
  • Plataforma de hospedagem: Qualquer hipervisor ou serviço de nuvem

Limitações

  • Se o Citrix Federated Authentication Service (FAS) for usado, o logon único será direcionado ao AD local em vez do Microsoft Entra ID. Neste caso, é recomendável configurar a autenticação baseada em certificado do Microsoft Entra para que o token de atualização primário (PRT) seja gerado no logon do usuário, o que facilita o logon único para recursos do Microsoft Entra dentro da sessão. Caso contrário, o PRT não estará presente e o SSO para recursos do Microsoft Entra não funcionará. Para obter informações sobre como obter o logon único (SSO) do Microsoft Entra para VDAs híbridos usando o Citrix Federated Authentication Service (FAS), consulte VDAs híbridos.
  • Não pule a preparação da imagem ao criar ou atualizar catálogos de máquinas. Se você quiser pular a preparação da imagem, certifique-se de que as VMs mestre não sejam Microsoft Entra ou híbridas do Microsoft Entra.

Considerações

  • A criação de máquinas híbridas do Microsoft Entra requer a permissão Write userCertificate no domínio de destino. Certifique-se de inserir as credenciais de um administrador com essa permissão durante a criação do catálogo.
  • O processo de junção híbrida do Microsoft Entra é gerenciado pela Citrix. Você precisa desabilitar autoWorkplaceJoin controlado pelo Windows nas VMs mestre da seguinte forma. A tarefa de desabilitar manualmente autoWorkplaceJoin é necessária apenas para a versão 2212 ou anterior do VDA.
    1. Execute gpedit.msc.
    2. navegar para Configuração do Computador > Modelos Administrativos > Componentes do Windows > Registro de Dispositivo.
    3. Defina Registrar computadores ingressados no domínio como dispositivos como Desabilitado.
  • Selecione a Unidade Organizacional (OU) que está configurada para ser sincronizada com o Microsoft Entra ID ao criar as identidades da máquina.
  • Para uma VM mestre baseada no Windows 11 22H2, crie uma tarefa agendada na VM mestre que execute os seguintes comandos na inicialização do sistema usando a conta SYSTEM. Esta tarefa de agendar uma tarefa na VM mestre é necessária apenas para a versão 2212 ou anterior do VDA.
    $VirtualDesktopKeyPath = 'HKLM:\Software\AzureAD\VirtualDesktop'
    $WorkplaceJoinKeyPath = 'HKLM:\SOFTWARE\Policies\Microsoft\Windows\WorkplaceJoin'
    $MaxCount = 60

    for ($count = 1; $count -le $MaxCount; $count++)
    {
      if ((Test-Path -Path $VirtualDesktopKeyPath) -eq $true)
      {
        $provider = (Get-Item -Path $VirtualDesktopKeyPath).GetValue("Provider", $null)
        if ($provider -eq 'Citrix')
        {
            break;
        }

        if ($provider -eq 1)
        {
            Set-ItemProperty -Path $VirtualDesktopKeyPath -Name "Provider" -Value "Citrix" -Force
            Set-ItemProperty -Path $WorkplaceJoinKeyPath -Name "autoWorkplaceJoin" -Value 1 -Force
            Start-Sleep 5
            dsregcmd /join
            break
        }
      }

      Start-Sleep 1
    }
  • Por padrão, o Microsoft Entra Connect sincroniza a cada 30 minutos. As máquinas provisionadas podem levar até 30 minutos para serem ingressadas no Microsoft Entra híbrido durante a primeira inicialização.

Próximos passos

Para obter mais informações sobre como criar um pool de identidades de catálogos ingressados no Microsoft Entra híbrido, consulte Pool de identidades de identidade de máquina ingressada no Microsoft Entra híbrido.