Verificação prévia para instalação e atualização do VDA

Last published : Nov 13, 2026
Apresentando uma pré-verificação desacoplada para instalação e atualizações do VDA, permitindo que os clientes identifiquem proativamente possíveis problemas antes de prosseguir. Esta verificação valida todas as dependências e pré-requisitos, fornecendo um status claro de aprovação/reprovação para cada condição. Se ocorrerem falhas, são fornecidas orientações detalhadas de correção com recomendações específicas. O processo real de instalação ou atualização permanece separado e deve ser iniciado manualmente após a conclusão da pré-verificação.
Este artigo descreve as etapas para realizar a verificação prévia para instalação e atualização do VDA.

Etapa 1. Executar a Linha de Comando

Nota:
  • A verificação prévia é suportada apenas no modo de linha de comando.
  • A instalação ou atualização não é iniciada ao executar este comando.
Para realizar uma verificação prévia, adicione a opção /precheckonly ao seu comando frequentemente usado para instalação ou atualização. Todas as condições de verificação prévia para a sua instalação ou atualização do VDA serão verificadas.

Realizar verificação prévia para instalação e atualização padrão

Execute o seguinte comando para realizar uma verificação prévia e garantir que o status da máquina esteja em um estado aceitável: \x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /precheckonly
Verificação prévia para instalação e atualização padrão

Realizar verificação prévia para instalação e atualização de componentes especificados

Para verificar os pré-requisitos para componentes específicos antes da instalação ou atualização, adicione /precheckonly ao seu comando. \x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /precheckonly /components vda,plugins
Verificação prévia para componentes especificados

Realizar verificação prévia para instalação e atualização de componente adicional - Citrix Backup and Restore

O comando \x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /precheckonly verifica os pré-requisitos para o componente Citrix Backup and Restore como uma verificação opcional. Se todas as pré-verificações forem aprovadas, exceto a verificação opcional, o resultado geral será APROVADO.
Verificação prévia para componentes adicionais
Os seguintes comandos verificam os pré-requisitos para o componente Citrix Backup and Restore como parte da verificação obrigatória:
  • \x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /precheckonly /includeadditional "Citrix Backup and Restore"
  • \x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /precheckonly /enablerestore
  • \x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /precheckonly /enablerestorecleanup
Verificação prévia para Citrix Backup and Restore

Etapa 2. Visualizar resultados da verificação prévia

Os resultados da verificação prévia são exibidos na linha de comando, registrados em %temp%/Citrix/XenDesktop Installer/XenDesktop Installation.log e salvos em %temp%/Citrix/XenDesktop Installer/PrecheckResult_{yyyyMMddHHmmss}.json. Se a verificação prévia falhar, o resultado geral é FAIL, com correções sugeridas para cada problema.

Saída da linha de comando

Os resultados da verificação prévia na linha de comando incluem:
  • Critérios de verificação prévia
  • Status da verificação prévia
  • Sugestões de correção para falha
  • Resultado geral
  • Hora de término.
Se o resultado for FAIL, as sugestões de correção estão disponíveis nas linhas que começam com Verificação prévia - Sugestão de correção:
Saída do log

Saída do log

Os resultados da pré-verificação em XenDesktop Installation.log espelham os mostrados na linha de comando. Para localizá-los, procure por Precheck - no arquivo de log. Se o resultado geral for FAIL, as sugestões de correção estão disponíveis nas linhas que contêm Precheck - Fix Suggestion:.
Sugestão de correção de saída de log

Saída JSON

Um arquivo .json é gerado toda vez que um comando com /quiet /precheckonly é executado. O arquivo é nomeado PrecheckResult_{yyyyMMddHHmmss}.json, com um sufixo de carimbo de data/hora.
Saída JSON
O arquivo .json inclui:
  • Hora de término local da pré-verificação
  • Resultado geral
  • Detalhes da pré-verificação
    • Critérios
    • Valor real
    • Status
    • Sugestão de correção
Resultado da pré-verificação JSON
Sugestões de correção para cada item de pré-verificação com status de FAIL podem ser encontradas na seção de detalhes da pré-verificação no arquivo .json.
Sugestão de correção para arquivo JSON