VDA 安装和升级预检查

Last published : Nov 13, 2026
引入了一项解耦的 VDA 安装和升级预检,使客户能够在继续操作之前主动识别潜在问题。此检查会验证所有依赖项和先决条件,为每个条件提供明确的通过/失败状态。如果发生任何故障,将提供包含具体建议的详细补救指南。实际的安装或升级过程是独立的,并且必须在预检查完成后手动启动。
本文概述了执行 VDA 安装和升级预检查的步骤。

步骤 1. 运行命令行

注意:
  • 预检查仅支持命令行模式。
  • 运行此命令时不会启动安装或升级。
要执行预检查,请将 /precheckonly 选项添加到您常用的安装或升级命令中。将检查 VDA 安装或升级的所有预检查条件。

执行默认安装和升级的预检查

运行以下命令以执行预检查并确保计算机状态处于可接受状态: \x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /precheckonly
默认安装和升级的预检查

执行指定组件的安装和升级预检查

要在安装或升级之前检查特定组件的先决条件,请将 /precheckonly 添加到您的命令中。 \x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /precheckonly /components vda,plugins
指定组件的预检查

执行附加组件(Citrix 备份和还原)的安装和升级预检查

命令 \x64\XenDesktop Setup\XenDesktopVdaSetup.exe /quiet /precheckonly 检查 Citrix 备份和还原组件的先决条件,作为可选检查。如果所有预检查都通过(可选检查除外),则总体结果为“通过”。
附加组件的预检查
以下命令检查 Citrix Backup and Restore 组件的必备条件,作为强制检查的一部分:
  • \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
Citrix Backup and Restore 的预检查

步骤 2. 查看预检查结果

预检查结果显示在命令行中,记录在 %temp%/Citrix/XenDesktop Installer/XenDesktop Installation.log 中并保存在 %temp%/Citrix/XenDesktop Installer/PrecheckResult_{yyyyMMddHHmmss}.json 中。如果预检查失败,则总体结果为 FAIL,并为每个问题提供建议的修复措施。

命令行输出

命令行中的预检查结果包括:
  • 预检查标准
  • 预检查状态
  • 失败修复建议
  • 总体结果
  • 结束时间。
如果结果为 FAIL,则修复建议可在以 Precheck - Fix Suggestion: 开头的行中找到。
日志输出

日志输出

XenDesktop Installation.log 中的预检查结果与命令行中显示的结果一致。要找到它们,请在日志文件中搜索 Precheck -。 如果总体结果为 FAIL,则修复建议可在包含 Precheck - Fix Suggestion: 的行中找到。
日志输出修复建议

JSON 输出

每次运行带有 /quiet /precheckonly 的命令时,都会生成一个 .json 文件。该文件名为 PrecheckResult_{yyyyMMddHHmmss}.json,并带有时间戳后缀。
JSON 输出
.json 文件包括:
  • 预检查本地结束时间
  • 总体结果
  • 预检查详细信息
    • 标准
    • 实际值
    • 状态
    • 修复建议
JSON 预检查结果
状态为 FAIL 的每个预检查项目的修复建议可以在 .json 文件中的预检查详细信息部分下找到。
JSON 文件的修复建议