使用 SCCM 安装 VDA

Last published : Nov 13, 2026
注意：
Citrix 不对因使用 Microsoft System Center Configuration Manager (SCCM) 等软件分发工具部署虚拟投递代理 (VDA) 而引起的问题负责，这些工具已调整以匹配客户生产环境。对于任何与安装相关的 Citrix 问题，请使用 Citrix 支持门户 提交技术支持案例并附上相关安装日志。
Related information
安装和配置

概述

为了使用 Microsoft System Center Configuration Manager (SCCM) 或类似软件分发工具成功部署虚拟投递代理 (VDA)，Citrix® 建议按一系列步骤使用 VDA 安装程序。
Citrix 不建议将 VDA 清理实用程序作为 VDA 安装或升级的一部分使用。仅当 VDA 安装程序之前失败时，才可在有限情况下使用 VDA 清理实用程序。

重启

VDA 安装期间所需的重新启动次数取决于环境。例如：
  • 可能需要重新启动以应用挂起的更新或完成早期软件安装的重新启动。
  • 以前被其他进程锁定的文件可能需要更新，从而强制进行额外重新启动。
  • VDA 安装程序中的某些可选组件（例如 Citrix Profile Management 和 Citrix Files）可能需要重新启动。
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 的安装序列示例

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

VDA 安装命令示例

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

远程电脑访问的安装命令

  • 以下命令使用单会话核心 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