Citrix Virtual Apps and Desktops 7 2311

使用 SCCM 安装虚拟投递代理 (VDA)

June 2, 2026

投稿者:

C C

注意：

Citrix 不对因使用软件分发工具（例如 Microsoft System Center Configuration Manager (SCCM)）部署虚拟投递代理 (VDA) 而引起的问题负责，这些工具已调整以匹配客户生产环境。对于任何与安装相关的 Citrix 问题，请使用 Citrix 支持门户并附上相关安装日志来开立技术支持案例。

概述

为了使用 Microsoft System Center Configuration Manager (SCCM) 或类似的软件分发工具成功部署虚拟投递代理 (VDA)，Citrix® 建议按一系列步骤使用 VDA 安装程序。

Citrix 不建议在 VDA 安装或升级过程中使用 VDA 清理实用程序。仅当 VDA 安装程序之前失败时，才在有限情况下使用 VDA 清理实用程序。

重新启动

VDA 安装过程中所需的重新启动次数取决于环境。例如：

对于挂起的更新或早期软件安装导致的重新启动，可能需要重新启动。
以前被其他进程锁定的文件可能需要更新，从而强制进行额外的重新启动。
虚拟投递代理 (VDA) 安装程序中的某些可选组件（例如 Citrix 配置文件管理和 Citrix 文件）可能需要重新启动。

SCCM 任务序列器管理所有必需的重新启动。

定义任务序列

确定所有先决条件和重新启动后，使用 SCCM 任务序列器完成以下操作：

可以从安装介质的可访问副本或从 VDA 独立安装程序之一安装 VDA：
- VDAWorkstationSetup_XXXX.exe
- VDAServerSetup_XXXX.exe
- VDAWorkstationCoreSetup_XXXX.exe
有关 VDA 安装程序的更多信息，请参阅安装程序。
升级 VDA 时，安装 VDA 的计算机必须处于维护模式，且没有会话。
当 VDA 首次在一台计算机上运行时，所使用的 VDA 安装程序会复制到该计算机上。
- 当使用除 VDAWorkstationCoreSetup_XXXX.exe 之外的 VDA 安装程序时，VDA 安装程序会复制到 %ProgramData%\Citrix\XenDesktopSetup\XenDesktopVdaSetup.exe。
- 当使用 VDAWorkstationCoreSetup_XXXX.exe 时，VDA 安装程序会复制到 %ProgramData%\Citrix\XenDesktopSetup\XenDesktopRemotePCSetup.exe。 `
VDA 安装程序的目录位置也存储在注册表 “HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\MetaInstall” “MetaInstallerInstallLocation” 中。
将命令行选项 /NOREBOOT、/NORESUME 和 /QUIET 添加到您的命令行选项中。
- /QUIET：在安装过程中不显示用户界面，以便 SCCM 控制安装过程。
- /NOREBOOT：阻止 VDA 安装程序自动重新启动。SCCM 会在需要时触发重新启动。
- /NORESUME：通常，当安装过程中需要重新启动时，VDA 安装程序会设置一个 runonce 注册表项 (\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce)。当计算机重新启动时，Windows 会使用该项启动 VDA 安装程序。这对 SCCM 来说是一个问题，因为 SCCM 无法监视安装并捕获退出代码。

使用 SCCM 的安装序列示例

以下示例将安装序列展示出来。

重新启动计算机： 通过重新启动计算机来准备机器。
首次尝试安装 VDA： 开始 VDA 安装。
1. 将 /quiet、/noreboot 和 /noresume 选项添加到命令行选项中。
2. 运行您选择的 VDA 安装程序（本地映像或其中一个最小安装程序）。
3. SCCM 必须捕获返回代码。
  - 如果返回代码为 0 或 8，则安装完成，需要重新启动。
  - 如果返回代码为 3，请重新启动计算机，然后将控制权传递给第二次尝试安装 VDA。
第二次尝试安装 VDA： 继续 VDA 安装。
1. 在首次尝试安装 VDA 之后，如果文件 %programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml 存在，则安装未完成，必须在重新启动完成后继续安装。
2. 第二次尝试安装 VDA 重复执行，直到文件 %programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml 不存在或返回除 0 或 8 之外的返回代码。将任何其他返回代码视为错误，并且第二次尝试安装 VDA 应报告错误并停止。
3. 通过从文件 %programdata%\ Citrix\XenDesktopSetup\ 目录运行相应的 VDA 安装程序（大多数情况下为 XenDesktopVdaSetup.exe，如果使用了 VDAWorkstationCoreSetup_XXXX.exe 则为 XenDesktopRemotePCSetup.exe），且不带命令行参数，来恢复 VDA 安装。（VDA 安装程序使用其在首次运行安装程序时保存的参数。）
4. 注意 VDA 安装程序的返回代码。
  - 0 或 8：成功，安装完成，需要重新启动。
  - 3：安装未完成。重新启动机器并重复第二次尝试安装 VDA，直到文件 %programdata%\ Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml 不存在或返回 0 或 8。将任何其他返回代码视为错误，并且第二次尝试安装 VDA 应报告错误并结束。

有关返回代码的更多信息，请参阅 Citrix 安装返回代码。

VDA 安装命令示例

可用的安装选项因所使用的安装程序而异。有关命令行选项的详细信息，请参阅以下文章。

远程电脑访问的安装命令

以下命令使用单会话核心 VDA 安装程序 (VDAWorkstationCoreSetup.exe)：

VDAWorkstationCoreSetup.exe /quiet /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot
以下命令使用单会话完整 VDA 安装程序 (VDAWorkstationSetup.exe)：

VDAWorkstationSetup.exe /quiet /remotepc /physicalmachine /controllers “control.domain.com” /enable_hdx_ports /noresume /noreboot

专用 VDI 的安装命令

以下命令使用单会话完整 VDA 安装程序 (VDAWorkstationSetup.exe)：

VDAWorkstationSetup.exe /quiet /components vda /controllers “control.domain.com” /enable_hdx_ports /enable_remote_assistance /noresume /noreboot

本产品文档的官方版本为英语版本。任何非英语版本仅为方便您而提供，可能包括机器翻译的内容。有关详细信息，请参阅 Cloud Software Group home 上的“机器翻译免责声明”。

这是否有帮助？

使用 SCCM 安装虚拟投递代理 (VDA)

June 2, 2026

投稿者:

C C

June 2, 2026

投稿者:

C C

这是否有帮助？