Citrix Virtual Apps and Desktops 7 2203 LTSR

使用脚本安装 VDA

注意:

Citrix 对因适应客户生产环境而修改的脚本所导致的问题不承担任何责任。对于任何与安装相关的 Citrix 问题,请使用 Citrix 支持门户 并附上相关安装日志来开具技术支持案例。

本文适用于在 Windows 操作系统计算机上安装 VDA。有关适用于 Linux 操作系统的 VDA 的信息,请参阅 Linux Virtual Delivery Agent 文档。

安装介质包含用于在 Active Directory 中为计算机安装、升级或删除虚拟投递代理 (VDA) 的示例脚本。您还可以使用这些脚本来维护 Machine Creation Services™ 和 Citrix Provisioning(以前称为 Provisioning Services)所使用的主映像。

所需访问权限:

  • 脚本需要对 VDA 安装命令所在的网络共享具有“所有人读取”访问权限。在完整产品 ISO 中,安装命令为 XenDesktopVdaSetup.exe;在独立安装程序中,安装命令为 VDAWorkstationSetup.exeVDAServerSetup.exe
  • 日志记录详细信息存储在每台本地计算机上。为了集中记录结果以供审查和分析,脚本需要对相应的网络共享具有“所有人读取和写入”访问权限。

要检查运行脚本的结果,请检查中央日志共享。捕获的日志包括脚本日志、安装程序日志和 MSI 安装日志。每次安装或删除尝试都记录在一个带时间戳的文件夹中。文件夹标题以 PASS 或 FAIL 前缀指示操作结果。您可以使用标准目录搜索工具在中央日志共享中查找失败的安装或删除。这些工具提供了一种替代方法,无需在目标计算机上进行本地搜索。

在开始任何安装之前,请阅读并完成 准备安装 中的任务。

使用脚本安装或升级 VDA

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

使用脚本删除 VDA

  1. 从安装介质上的 \Support\AdDeploy\ 获取示例脚本 UninstallVDA.bat。Citrix 建议您在自定义原始脚本之前进行备份。
  2. 编辑脚本。
    • 指定要删除的 VDA 版本:SET CHECK\_VDA\_VERSION。例如,版本 7 可以指定为 7.0。完整值可在安装介质的 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 的文件)。
    • 能够对 DEPLOYSHARELOG 共享进行身份验证。
  • 有关 Citrix 如何报告组件安装结果的信息,请参阅Citrix 安装返回代码

  • 在交付组的 Studio 显示中,详细信息窗格中的“已安装的 VDA 版本”条目可能不是计算机上安装的版本。计算机的程序和功能显示会显示实际的 VDA 版本。

  • VDA 安装后,必须先向 Delivery Controller 注册,然后才能向用户交付应用程序或桌面。

    要了解 VDA 注册方法以及如何排查注册问题,请参阅VDA 注册

使用脚本安装 VDA