Citrix Virtual Apps and Desktops 7 2203 LTSR

使用系统中心配置管理器 (SCCM) 安装虚拟投递代理 (VDA)

May 31, 2026

投稿者:

C C

注意：

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

概述

要使用微软系统中心配置管理器 (SCCM) 或类似的软件分发工具成功部署虚拟投递代理 (VDA)，思杰® 建议按一系列步骤使用虚拟投递代理 (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 的安装序列示例

以下示例演示了完整的安装顺序。

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

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

VDA 安装命令示例

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

远程 PC 访问的安装命令

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

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

VDAWorkstationSetup.exe /quiet /remotepc /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)

May 31, 2026

投稿者:

C C

May 31, 2026

投稿者:

C C

这是否有帮助？