Instalar VDAs

Last published : Nov 03, 2026
Related information
Planejar e construir uma implantação
Instalar VDAs usando a linha de comando

Introdução

Este artigo começa com uma descrição dos VDAs do Windows e dos instaladores de VDA disponíveis. O restante do artigo descreve as etapas do assistente de instalação do VDA. Equivalentes de linha de comando são fornecidos. Para obter detalhes, consulte Instalar VDAs usando a linha de comando.
Para obter informações sobre VDAs Linux, consulte Linux Virtual Delivery Agent.
Assista a uma introdução aos VDAs.
Vídeo de introdução aos VDAs

Considerações sobre a instalação

O artigo Citrix DaaS descreve o que são os VDAs e o que eles fazem. Aqui estão mais informações.
  • Coleta de análises: As análises são coletadas automaticamente quando você instala ou atualiza componentes. Por padrão, esses dados são carregados para a Citrix automaticamente quando a instalação é concluída. Além disso, ao instalar componentes, você é automaticamente inscrito no Programa de Melhoria da Experiência do Cliente Citrix (CEIP), que carrega dados anônimos. Além disso, durante uma instalação ou atualização, é oferecida a oportunidade de se inscrever no Call Home.
    Se uma instalação de VDA falhar, um analisador MSI analisa o log MSI com falha, exibindo o código de erro exato. O analisador sugere um artigo CTX, se for um problema conhecido. O analisador também coleta dados anonimizados sobre o código de erro da falha. Esses dados são incluídos com outros dados coletados pelo CEIP. Se você encerrar a inscrição no CEIP, os dados coletados pelo analisador MSI não serão mais enviados à Citrix.
    Para obter informações sobre esses programas, consulte Citrix Insight Services.
  • Aplicativo Citrix Workspace™: O aplicativo Citrix Workspace para Windows não é instalado por padrão ao instalar um VDA. Você pode baixar e instalar ou atualizar o aplicativo Citrix Workspace para Windows e outros aplicativos Citrix Workspace no site da Citrix. Alternativamente, você pode disponibilizar esses aplicativos Citrix Workspace a partir do Workspace ou de um servidor StoreFront™.
  • Serviço Spooler de Impressão: O Serviço Spooler de Impressão da Microsoft deve estar habilitado. Você não pode instalar um VDA com sucesso se esse serviço estiver desabilitado.
  • Microsoft Media Foundation: A maioria das edições do Windows suportadas já vem com o Media Foundation instalado. Se a máquina na qual você está instalando um VDA não tiver o Microsoft Media Foundation (como as edições N), vários recursos multimídia não serão instalados e não funcionarão.
    • Redirecionamento de Flash
    • Redirecionamento de Mídia do Windows
    • Redirecionamento de Vídeo HTML5
    • Redirecionamento de Webcam HDX™ RealTime
    Você pode reconhecer a limitação ou encerrar a instalação do VDA e reiniciá-la mais tarde, após instalar o Media Foundation. Na interface gráfica, essa escolha é apresentada em uma mensagem. Na linha de comando, você pode usar a opção /no_mediafoundation_ack para reconhecer a limitação.
  • Grupo de usuários local: Ao instalar o VDA, um novo grupo de usuários local chamado Direct Access Users é criado automaticamente. Para um VDA de SO de sessão única, esse grupo se aplica apenas a conexões RDP. Para um VDA de SO de várias sessões, esse grupo se aplica a conexões ICA® e RDP.
  • Requisito de endereço do Cloud Connector: O VDA deve ter pelo menos um endereço de Cloud Connector válido (no mesmo local de recurso) com o qual se comunicar. Caso contrário, as sessões não poderão ser estabelecidas. Você especifica os endereços do Cloud Connector ao instalar o VDA. Para obter informações sobre outras maneiras de especificar endereços do Cloud Connector onde os VDAs podem se registrar, consulte Registro de VDA.
  • Considerações sobre o sistema operacional:
    • Revise os Requisitos do sistema para plataformas, sistemas operacionais e versões suportados.
    • Certifique-se de que cada sistema operacional mantenha as atualizações mais recentes.
    • Certifique-se de que os VDAs tenham relógios de sistema sincronizados. A infraestrutura Kerberos que protege a comunicação entre as máquinas requer sincronização.
    • Orientações de otimização para máquinas Windows 10 estão disponíveis em CTX216252.
    • Se você tentar instalar (ou atualizar para) um VDA Windows em um SO que não é compatível com essa versão do VDA, uma mensagem descreverá suas opções. Para obter mais informações, consulte Requisitos do sistema e Sistemas operacionais anteriores.
  • MSIs instalados: Vários MSIs são instalados automaticamente quando você instala um VDA. Você pode impedir a instalação de alguns MSIs na página Componentes Adicionais da interface gráfica ou com a opção /exclude na CLI. Para outros, a única maneira de impedir a instalação é com a opção CLI /exclude.
  • Ingressado no domínio: Certifique-se de que a máquina esteja ingressada no domínio antes de instalar o software VDA.

Reinicializações durante a instalação do VDA

É necessário reiniciar ao final da instalação do VDA. Essa reinicialização ocorre automaticamente por padrão.
Para minimizar o número de outras reinicializações necessárias durante a instalação do VDA:
  • Certifique-se de que uma versão compatível do Microsoft .NET Framework esteja instalada antes de iniciar a instalação do VDA.
  • Para máquinas com SO Windows multi-sessão, instale e habilite os serviços de função RDS antes de instalar o VDA.
Se você não instalar esses pré-requisitos antes de instalar o VDA:
  • Se você estiver usando a interface gráfica ou a interface de linha de comando sem a opção /noreboot, a máquina reinicia automaticamente após a instalação do pré-requisito.
  • Se você estiver usando a interface de linha de comando com a opção /noreboot, você deve iniciar a reinicialização.
Após cada reinicialização, a instalação do VDA continua. Se você estiver instalando pela linha de comando, pode impedir a retomada automática com a opção /noresume.
Ao atualizar um VDA para a versão 7.17 ou uma versão posterior compatível, uma reinicialização ocorre durante a atualização. Essa reinicialização não pode ser evitada.

Restaurar em caso de falha na instalação ou atualização

Nota:
Este recurso está disponível apenas para VDAs de sessão única.
Se uma instalação ou atualização de VDA de sessão única falhar, e o recurso "restaurar em caso de falha" estiver habilitado, a máquina é retornada a um ponto de restauração que foi definido antes do início da instalação ou atualização.
Quando uma instalação ou atualização de VDA de sessão única é iniciada com este recurso habilitado, o instalador cria um ponto de restauração do sistema antes de iniciar a instalação ou atualização real. Se a instalação ou atualização do VDA falhar, a máquina é retornada ao estado do ponto de restauração. A pasta %temp%/Citrix contém logs de implantação e outras informações sobre a restauração.
Por padrão, este recurso está desabilitado.
Se você planeja habilitar este recurso, certifique-se de que a restauração do sistema não esteja desabilitada por meio de uma configuração de GPO (Computer Configuration > Administrative Templates > System > System Restore).
Para habilitar este recurso ao instalar ou atualizar um VDA de sessão única:
  • Ao usar a interface gráfica de um instalador VDA (como usando Autostart ou o comando XenDesktopVDASetup.exe sem quaisquer opções de restauração ou silenciosas), selecione a caixa de seleção Habilitar restauração automática se a atualização falhar na página Resumo.
    Se a instalação/atualização for concluída com êxito, o ponto de restauração não será usado, mas será retido.
  • Execute um instalador VDA com a opção /enablerestore ou /enablerestorecleanup.
    • Se você usar a opção /enablerestorecleanup, e a instalação/atualização for concluída com êxito, o ponto de restauração será removido automaticamente.
    • Se você usar a opção /enablerestore, e a instalação/atualização for concluída com êxito, o ponto de restauração não será usado, mas será retido.

Instaladores VDA

Os instaladores VDA podem ser baixados diretamente do console Citrix Cloud™.
Por padrão, os arquivos nos instaladores autoextraíveis são extraídos para a pasta Temp. Os arquivos extraídos para a pasta Temp são automaticamente excluídos após a conclusão da instalação. Alternativamente, você pode usar o comando /extract com um caminho absoluto.
Três instaladores VDA autônomos estão disponíveis para download.
VDAServerSetup.exe Instala um VDA de SO multi-sessão.
VDAWorkstationSetup.exe Instala um VDA de SO de sessão única.
VDAWorkstationCoreSetup.exe Instala um VDA de SO de sessão única otimizado para implantações de Acesso Remoto a PC ou instalações VDI principais. O Acesso Remoto a PC usa máquinas físicas. As instalações VDI principais são VMs que não estão sendo usadas como uma imagem. Este instalador implanta apenas os serviços essenciais necessários para conexões VDA. Portanto, ele suporta apenas um subconjunto das opções válidas com o instalador VDAWorkstationSetup.
Para obter mais informações, consulte Instalar VDA para suas respectivas versões.

Solução de problemas

No display do Studio para um grupo de entrega, a entrada Versão do VDA Instalado no painel Detalhes pode não ser a versão instalada nas máquinas. O display de Programas e Recursos do Windows da máquina mostra a versão real do VDA.

Citrix Optimizer

O Citrix Optimizer é uma ferramenta para o sistema operacional Windows que ajuda os administradores Citrix a otimizar VDAs removendo e otimizando vários componentes.
Após instalar um VDA e concluir a reinicialização final, baixe e instale o Citrix Optimizer. Consulte CTX224676. O artigo CTX contém o pacote de download, além de instruções sobre como instalar e usar o Citrix Optimizer.

Personalizar um VDA

Posteriormente, para personalizar (alterar informações de) um VDA instalado:
  1. No recurso do Windows para remover ou alterar programas, selecione Citrix Virtual Delivery Agent ou Citrix Remote PC Access/VDI Core Services VDA. Em seguida, clique com o botão direito e selecione Alterar.
  2. Selecione Personalizar Configurações do Virtual Delivery Agent.
Quando o instalador for iniciado, altere as configurações disponíveis.

Personalizar a porta para comunicação com os Cloud Connectors

Você pode personalizar a porta que os VDAs usam para se comunicar com os Cloud Connectors com base em seus requisitos de segurança específicos. Esse recurso é útil se sua equipe de segurança não permite que a porta padrão (porta 80) esteja aberta ou se a porta padrão já estiver em uso.
Nota:
Ao alterar o número da porta padrão, apenas valores dentro do intervalo de 1024 a 65535 são suportados.
Para personalizar a porta, conclua as seguintes etapas:
  1. Adicionar o número da porta VDA nos Citrix Cloud Connectors
  2. Configuração adicional do Citrix Cloud Connector™ ao usar o Rendezvous V1
  3. Adicionar o número da porta VDA nos VDAs

Adicionar o número da porta VDA nos Citrix Cloud Connectors

Vá para o Citrix Cloud Connector e execute os dois comandos PowerShell a seguir:
  • PS C:\> & 'C:\Program Files\Citrix\XaXdCloudProxy\XaXdCloudProxy.exe' -VdaPort <port number>
  • PS C:\> & 'C:\Program Files\Citrix\Broker\Service\HighAvailabilityService.exe' -VdaPort <port number> -ConfigureFirewall
Exemplo:
  • PS C:\> & 'C:\Program Files\Citrix\XaXdCloudProxy\XaXdCloudProxy.exe' -VdaPort 18000
  • PS C:\> & 'C:\Program Files\Citrix\Broker\Service\HighAvailabilityService.exe' -VdaPort 18000 -ConfigureFirewall
Ao personalizar a porta, considere o seguinte:
  • Você deve usar o mesmo número de porta em ambos os comandos.
  • Você deve executar ambos os comandos em todos os Cloud Connectors.
  • Para se comunicar com sucesso com os Cloud Connectors, certifique-se de que todos os VDAs usem o mesmo número de porta.
  • A porta que você configura persiste nas atualizações do conector.

Configuração adicional do Citrix Cloud Connector ao usar o Rendezvous V1

Defina a seguinte chave de registro em cada Citrix Cloud Connector:
HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\XaXdCloudProxyPersist
Nome: WorkerPortNumber Tipo: REG_DWORD Valor: <port number>

Adicionar o número da porta VDA nos VDAs

Instale o VDA com as configurações padrão e configure-o da seguinte forma. Se o VDA já estiver instalado, continue com as etapas abaixo.
  1. No VDA, abra XenDesktopVdaSetup.exe, que está localizado em C:\Program Files\Citrix\XenDesktopVdaSetup\XenDesktopVdaSetup.exe.
  2. Na página Protocol and Port, adicione o número da porta personalizada.
    Página de Protocolo e Porta
  3. Na página Delivery Controller™, insira o FQDN do Controller.
    Delivery Controller page
  4. Clique em Next para prosseguir com o assistente e concluir a configuração.
Os números das portas são então reconfigurados com sucesso.
Nota:
Você pode ver a seguinte mensagem de erro ao testar uma conexão do Controller: Nenhuma instância em execução de um Controller encontrada em < o endereço do Controller que você inseriu >. Se o endereço estiver correto, você pode ignorar a mensagem.

Solução de problemas

Para verificar se as portas personalizadas estão configuradas corretamente, vá para o Cloud Connector e execute as seguintes etapas de solução de problemas:
  1. Verifique se as duas chaves de registro a seguir existem.
    HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\XaXdCloudProxyPersist Nome: CustomVDAPortNumber Tipo: REG_DWORD Dados: 18000
    HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\XaXdCloudProxyPersist Nome: CustomVDAPortNumberHA Tipo: REG_DWORD Dados: 18000
  2. Execute o seguinte comando para criar um arquivo .txt.
    • netsh http show urlacl > <filepath>.txt
    Exemplo:
    • netsh http show urlacl > c:\reservations.txt
  3. Abra o arquivo .txt e verifique as quatro URLs a seguir para confirmar se a porta correta está sendo usada.
    • http://+:18000/Citrix/CdsController/IRegistrar/
    • http://+:18000/Citrix/CdsController/ITicketing/
    • http://+:18000/Citrix/CdsController/IDynamicDataSink/
    • http://+:18000/Citrix/CdsController/INotifyBroker/
  4. Verifique se as duas regras de firewall a seguir foram criadas e se as portas necessárias estão abertas.
    • Citrix XaXdProxy
    • Citrix Broker Service (TCP-In)

Outras informações

Próximos passos

Criar catálogos de máquinas.
Para revisar todo o processo de configuração, consulte Planejar e construir uma implantação.