使用脚本安装 VDA

Last published : Nov 13, 2026
注意:
Citrix 不对因适应客户生产环境而修改的脚本引起的问题负责。对于任何与安装相关的 Citrix 问题,请使用 Citrix 支持门户 提交技术支持案例并附上相关安装日志。
本文适用于在 Windows 操作系统计算机上安装 VDA。有关适用于 Linux 操作系统的 VDA 的信息,请参阅 Linux Virtual Delivery Agent 文档。
安装介质包含用于在 Active Directory 中为计算机安装、升级或删除 Virtual Delivery Agent (VDA) 的示例脚本。您还可以使用这些脚本来维护 Machine Creation Services™ 和 Citrix Provisioning(以前称为 Provisioning Services)使用的主映像。
所需访问权限:
  • 脚本需要对 VDA 安装命令所在的网络共享具有“所有人读取”访问权限。安装命令在完整产品 ISO 中为 XenDesktopVdaSetup.exe,在独立安装程序中为 VDAWorkstationSetup.exe 或 VDAServerSetup.exe。
  • 日志记录详细信息存储在每台本地计算机上。为了集中记录结果以供审查和分析,脚本需要对相应的网络共享具有“所有人读取和写入”访问权限。
要检查脚本运行结果,请检查中央日志共享。捕获的日志包括脚本日志、安装程序日志和 MSI 安装日志。每次安装或删除尝试都记录在一个带时间戳的文件夹中。文件夹标题以 PASS 或 FAIL 前缀指示操作结果。您可以使用标准目录搜索工具在中央日志共享中查找失败的安装或删除。这些工具提供了在目标计算机上本地搜索的替代方法。
在开始任何安装之前,请阅读并完成 准备安装 中的任务。

使用脚本安装或升级 VDA

  1. 从安装介质上的 \Support\AdDeploy\ 获取示例脚本 InstallVDA.bat。Citrix 建议您在自定义脚本之前备份原始脚本。
  2. 编辑脚本:
    • 指定要安装的 VDA 版本:SET DESIREDVERSION。完整值可在安装介质的 ProductVersion.txt 文件中找到。但是,不要求完全匹配。
    • 指定将调用安装程序的网络共享。指向布局的根目录(树的最高点)。脚本运行时会自动调用相应版本的安装程序(32 位或 64 位)。例如:SET DEPLOYSHARE=\\fileserver1\share1。
    • (可选)指定用于存储集中式日志的网络共享位置。例如:SET LOGSHARE=\\fileserver1\log1)。
    • 按照使用命令行安装中所述指定 VDA 配置选项。/quiet 和 /noreboot 选项默认包含在脚本中,并且是必需的:SET COMMANDLINEOPTIONS=/QUIET /NOREBOOT /NORESUME。
  3. 使用组策略启动脚本,将脚本分配给包含您的计算机的 OU。此 OU 应仅包含要安装 VDA 的计算机。当该 OU 中的计算机重新启动时,脚本将在所有计算机上运行。VDA 将安装在每台具有受支持操作系统的计算机上。

使用脚本删除 VDA

  1. 从安装介质上的 \Support\AdDeploy\ 获取示例脚本 UninstallVDA.bat。Citrix 建议您在自定义脚本之前备份原始脚本。
  2. 编辑脚本。
    • 指定要删除的 VDA 版本:SET CHECK\_VDA\_VERSION。完整值可在安装介质的 ProductVersion.txt 文件中找到(例如 7.0.0.3018)。但是,不需要完全匹配。
    • (可选)指定用于存储集中式日志的网络共享位置。
  3. 使用组策略启动脚本,将脚本分配给包含您的计算机的 OU。此 OU 应仅包含要从中删除 VDA 的计算机。当 OU 中的计算机重新启动时,脚本将在所有计算机上运行。VDA 将从每台计算机中删除。

故障排除

  • 脚本会生成内部日志文件,描述脚本执行进度。脚本在开始部署后的几秒钟内将 Kickoff_VDA_Startup_Script 日志复制到中央日志共享。您可以验证整个过程是否正常运行。如果此日志未按预期复制到中央日志共享,请通过检查本地计算机进一步进行故障排除。脚本将两个调试日志文件放置在每台计算机的 %temp% 文件夹中:
    • Kickoff_VDA_Startup_Script_<DateTimeStamp>.log
    • VDA_Install_ProcessLog_<DateTimeStamp>.log
    检查这些日志以确保脚本:
    • 按预期运行。
    • 正确检测目标操作系统。
    • 正确配置为指向 DEPLOYSHARE 共享的 ROOT(包含名为 AutoSelect.exe 的文件)。
    • 能够对 DEPLOYSHARE 和 LOG 共享进行身份验证。
  • 有关 Citrix 如何报告组件安装结果的信息,请参阅Citrix 安装返回代码。
  • 在交付组的 Studio 显示中,详细信息窗格中的已安装的 VDA 版本条目可能不是计算机上安装的版本。计算机的程序和功能显示实际的 VDA 版本。
  • VDA 安装后,它无法向用户交付应用程序或桌面,直到它向 Delivery Controller 注册。
    要了解 VDA 注册方法以及如何排查注册问题,请参阅 VDA 注册。