Documentação de produtos
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
Ver PDF

Instalar VDAs com scripts

January 23, 2026
Contribuição de: 
C

Observação:

A Citrix não se responsabiliza por problemas causados por scripts adaptados para ambientes de produção do cliente. Para quaisquer problemas relacionados à instalação da Citrix, abra um caso de suporte técnico com os logs de instalação relevantes usando o portal de Suporte da Citrix.

Este artigo se aplica à instalação de VDAs em máquinas com sistemas operacionais Windows. Para obter informações sobre VDAs para sistemas operacionais Linux, consulte a documentação do Linux Virtual Delivery Agent.

A mídia de instalação contém scripts de exemplo que instalam, atualizam ou removem Virtual Delivery Agents (VDAs) para máquinas no Active Directory. Você também pode usar os scripts para manter imagens mestre usadas pelo Machine Creation Services™ e pelo Citrix Provisioning (anteriormente Provisioning Services).

Acesso necessário

  • Os scripts precisam de acesso de Leitura para Todos ao compartilhamento de rede onde o comando de instalação do VDA está localizado. O comando de instalação é XenDesktopVdaSetup.exe no ISO completo do produto, ou VDAWorkstationSetup.exe ou VDAServerSetup.exe em um instalador autônomo.
  • Os detalhes de log são armazenados em cada máquina local. Para registrar os resultados centralmente para revisão e análise, os scripts precisam de acesso de Leitura e Gravação para Todos ao compartilhamento de rede apropriado.

Para verificar os resultados da execução de um script, examine o compartilhamento de log central. Os logs capturados incluem o log do script, o log do instalador e os logs de instalação do MSI. Cada tentativa de instalação ou remoção é registrada em uma pasta com carimbo de data/hora. O título da pasta indica o resultado da operação com o prefixo PASS ou FAIL. Você pode usar ferramentas de pesquisa de diretório padrão para encontrar uma instalação ou remoção com falha no compartilhamento de log central. Essas ferramentas oferecem uma alternativa à pesquisa local nas máquinas de destino.

Antes de iniciar qualquer instalação, leia e conclua as tarefas em Preparar para instalar.

Instalar ou atualizar VDAs usando o script

  1. Obtenha o script de exemplo InstallVDA.bat de \Support\AdDeploy\ na mídia de instalação. A Citrix recomenda que você faça um backup do script original antes de personalizá-lo.
  2. Edite o script:
    • Especifique a versão do VDA a ser instalada: SET DESIREDVERSION. O valor completo pode ser encontrado na mídia de instalação no arquivo ProductVersion.txt. No entanto, uma correspondência exata não é necessária.
    • Especifique o compartilhamento de rede onde o instalador será invocado. Aponte para a raiz do layout (o ponto mais alto da árvore). A versão apropriada do instalador (32 bits ou 64 bits) é chamada automaticamente quando o script é executado. Por exemplo: SET DEPLOYSHARE=\\fileserver1\share1.
    • Opcionalmente, especifique um local de compartilhamento de rede para armazenar logs centralizados. Por exemplo: SET LOGSHARE=\\fileserver1\log1).
    • Especifique as opções de configuração do VDA conforme descrito em Instalar usando a linha de comando. As opções /quiet e /noreboot são incluídas por padrão no script e são obrigatórias: SET COMMANDLINEOPTIONS=/QUIET /NOREBOOT /NORESUME.
  3. Usando Scripts de Inicialização de Política de Grupo, atribua o script à UO que contém suas máquinas. Esta UO deve conter apenas máquinas nas quais você deseja instalar o VDA. Quando as máquinas nessa UO são reiniciadas, o script é executado em todas elas. Um VDA é instalado em cada máquina que possui um sistema operacional compatível.

Remover VDAs usando o script

  1. Obtenha o script de exemplo UninstallVDA.bat de \Support\AdDeploy\ na mídia de instalação. A Citrix recomenda que você faça um backup do script original antes de personalizá-lo.
  2. Edite o script.
    • Especifique a versão do VDA a ser removida: SET CHECK\_VDA\_VERSION. O valor completo pode ser encontrado na mídia de instalação no arquivo ProductVersion.txt (como 7.0.0.3018). No entanto, uma correspondência exata não é necessária.
    • Opcionalmente, especifique um local de compartilhamento de rede para armazenar logs centralizados.
  3. Usando Scripts de Inicialização de Política de Grupo, atribua o script à UO que contém suas máquinas. Esta UO deve conter apenas máquinas das quais você deseja remover o VDA. Quando as máquinas na UO são reiniciadas, o script é executado em todas elas. O VDA é removido de cada máquina.

Solução de problemas

  • O script gera arquivos de log internos que descrevem o progresso da execução do script. O script copia um log Kickoff_VDA_Startup_Script para o compartilhamento de log central em segundos após o início da implantação. Você pode verificar se o processo geral está funcionando. Se este log não for copiado para o compartilhamento de log central conforme o esperado, solucione o problema inspecionando a máquina local. O script coloca dois arquivos de log de depuração na pasta %temp% em cada máquina:

    • Kickoff_VDA_Startup_Script_<DateTimeStamp>.log
    • VDA_Install_ProcessLog_<DateTimeStamp>.log

    Revise esses logs para garantir que o script esteja:

    • Sendo executado conforme o esperado.
    • Detectando corretamente o sistema operacional de destino.
    • Configurado corretamente para apontar para a ROOT do compartilhamento DEPLOYSHARE (contém o arquivo chamado AutoSelect.exe).
    • Capaz de autenticar nos compartilhamentos DEPLOYSHARE e LOG.

  • Para obter informações sobre como a Citrix relata o resultado das instalações de componentes, consulte Códigos de retorno de instalação da Citrix.

  • Na exibição do Studio para um grupo de entrega, a entrada Versão do VDA instalada no painel Detalhes pode não ser a versão instalada nas máquinas. A exibição de programas e recursos da máquina mostra a versão real do VDA.

  • Após a instalação de um VDA, ele não pode entregar aplicativos ou um desktop aos usuários até que se registre em um Delivery Controller.

    Para saber mais sobre os métodos de registro de VDA e como solucionar problemas de registro, consulte Registro de VDA.

Instalar VDAs com scripts
January 23, 2026
Contribuição de: 
C
January 23, 2026
Contribuição de: 
C

Neste artigo

Feedback do site | Your privacy choices footer linkSuas escolhas de privacidade | Privacidade e termos legais | Preferências de cookies | Configurações de consentimento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.