Unido ao Azure Active Directory Híbrido

Last published : Nov 13, 2026
Este artigo descreve os requisitos para criar catálogos unidos ao Azure Active Directory Híbrido (HAAD), além dos requisitos descritos na seção de requisitos do sistema.
Máquinas unidas ao Azure AD Híbrido 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, é necessário que os usuários do domínio estejam sincronizados com o Azure AD.
Observação:
VMs unidas ao Azure AD Híbrido são suportadas em infraestruturas de identidade federada e gerenciada.

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 para o AD local em vez do Azure AD. Neste caso, é recomendado configurar a autenticação baseada em certificado do Azure AD 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 Azure AD dentro da sessão. Caso contrário, o PRT não estará presente e o SSO para recursos do Azure AD não funcionará. Para obter informações sobre como obter o logon único (SSO) do Azure AD para VDAs unidos hibridamente usando o Citrix Federated Authentication Service (FAS), consulte VDAs unidos hibridamente.
  • 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 estejam unidas ao Azure AD ou ao Azure AD Híbrido.

Considerações

  • A criação de máquinas unidas ao Azure Active Directory Híbrido 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 união ao Azure AD híbrido é 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 até Configuração do Computador > Modelos Administrativos > Componentes do Windows > Registro de Dispositivo.
    3. Defina Registrar computadores unidos ao domínio como dispositivos como Desabilitado.
  • Selecione a Unidade Organizacional (OU) que está configurada para ser sincronizada com o Azure AD ao criar as identidades da máquina.
  • Para VMs mestre baseadas no Windows 11 22H2, crie uma tarefa agendada na VM mestre que executa 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 Azure AD Connect sincroniza a cada 30 minutos. As máquinas provisionadas podem levar até 30 minutos para serem ingressadas no Azure AD híbrido durante a primeira inicialização.

Próximos passos

Para obter mais informações sobre como criar catálogos ingressados no Azure Active Directory híbrido, consulte Criar catálogos ingressados no Azure Active Directory híbrido.