产品文档
Citrix Virtual Apps and Desktops
服务 当前版本 2607 LTSR 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR
查看 PDF

使用 SCCM 安装虚拟投递代理

June 2, 2026
投稿者: 
C

概述

微软端点配置管理器（以前称为 System Center Configuration Manager (SCCM)）是一款 Windows 产品，能够对整个企业中的设备和应用程序进行管理、部署和安全防护。

注意：

以下文章仅描述了基于 Citrix® 测试环境的建议。您可以根据自己的需求自定义这些步骤。Citrix 不对为满足客户需求而进行的任何更新或调整负责。

推荐事项

  • 要使用 SCCM 或类似的软件分发工具成功部署 Virtual Delivery Agent (VDA)，Citrix 建议使用 分步 VDA 安装程序。

  • Citrix 不建议将 VDA 清理实用程序用作 VDA 安装或升级的一部分。仅当 VDA 安装程序之前失败时，才在有限情况下使用 VDA 清理实用程序。

开始之前

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

  • 可能需要重新启动以完成挂起的更新或早期软件安装导致的重新启动。
  • 以前被其他进程锁定的文件可能需要更新，从而强制进行额外的重新启动。
  • 虚拟投递代理安装程序中的某些可选组件（例如 Citrix Profile Management 和 Citrix Files）可能需要重新启动。
  • 升级 VDA 时，安装了 VDA 的计算机必须处于维护模式，且没有会话。
  • 当 VDA 首次在计算机上运行时，所使用的 VDA 安装程序将复制到该计算机上。 有关 VDA 安装的更多信息，请参阅 (/zh-cn/citrix-virtual-apps-desktops/2511/install-configure/install-prepare#installers)。

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

使用 SCCM 部署 VDA 的关键步骤

以下步骤描述了如何在虚拟机上使用 SCCM 部署 VDA。

  1. 安装虚拟投递代理。
  2. 创建组织单位 (OU)。
  3. 验证计算机。
  4. 使用 VDA 分发内容。

步骤 1：安装 VDA

确定所有 先决条件 后，使用 SCCM Task Sequencer 完成以下任务：

  1. 从可访问的安装介质副本或 VDA 独立安装程序之一安装 VDA：

    • VDAWorkstationSetup_XXXX.exe
    • VDAServerSetup_XXXX.exe
    • VDAWorkstationCoreSetup_XXXX.exe

    有关 VDA 安装程序的更多信息，请参阅 安装程序。

    注意：

    当您升级 VDA 时，安装了 VDA 的计算机必须处于维护模式，且没有会话。

  2. 当 VDA 首次在一台计算机上运行时，所使用的 VDA 安装程序会复制到该计算机上。
    • 当您使用 VDAWorkstationCoreSetup_XXXX.exe 以外的 VDA 安装程序时，VDA 安装程序会复制到 %ProgramData%\Citrix\XenDesktopSetup\XenDesktopVdaSetup.exe。
    • 当您使用 VDAWorkstationCoreSetup_XXXX.exe 时，VDA 安装程序会复制到 %ProgramData%\Citrix\XenDesktopSetup\XenDesktopRemotePCSetup.exe.

  3. VDA 安装程序的目录位置也存储在注册表 HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\MetaInstall” “MetaInstallerInstallLocation” 中。

  4. 将命令行选项 /NOREBOOT、/NORESUME 和 /QUIET 添加到您的命令行选项中。

    • /QUIET：在安装过程中不显示用户界面，以便 SCCM 控制安装过程。
    • /NOREBOOT：禁止 VDA 安装程序自动重新启动。SCCM 会在需要时触发重新启动。
    • /NORESUME：通常，当安装过程中需要重新启动时，VDA 安装程序会设置一个 runonce 注册表项 (\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce)。Windows 使用该项在计算机重新启动时打开 VDA 安装程序。这对 SCCM 来说是一个问题，因为 SCCM 无法监视安装并捕获退出代码。

步骤 2：创建组织单位 (OU)

  1. 创建两个要添加到 OU 的已加入域的虚拟机。虚拟机最初创建时位于 Computers 文件夹中。将虚拟机移动到 SCCM 文件夹。 示例：WIN10EN-BB80MJ4.cseblr.com W2K19ST-EBPR3UG.cseblr.com

    SCCM 虚拟投递代理

  2. 在 微软配置管理器 中，转到 \Administration\Overview\Hierarchy Configuration\Discovery Methods\。

  3. 点击 Active Directory 系统发现，并选中 启用 Active Directory 系统发现 复选框以启用新创建虚拟机的自动发现功能。

  4. 单击 图标 图标以选择新容器。

  5. 在位置部分，添加您的 SCCM 虚拟机所在的路径。

  6. 转到 \Administration\Overview\Site Configuration\Sites 并右键单击 SCCM VDA。

  7. 选择客户端安装设置 > 客户端推送安装。将打开客户端推送安装属性窗口。

  8. 将虚拟机设置为 Enabled 后，您可以看到虚拟机列表，如下图所示。

    系统中心配置管理器

    系统中心配置管理器-2

  9. 创建设备集合以创建 OU。输入集合的名称。

    设备集合

  10. 按照向导说明操作。

    成员资格规则

    OU 已创建。

    OU 创建

  11. 将已创建的虚拟机添加到新创建的设备集合中。

    1. 右键单击虚拟机。选择添加选定项 > 将选定项添加到现有设备集合。

      添加项目

    2. 在选择集合窗口中，选择所需的设备名称。在此示例中，它是 Devices-SCCM。

      设备列表

    Devices-SCCM 列在资产和合规性 > 概述 > 设备集合中。

    列出的设备

  12. 在设备收集器上选择安装客户端。

    安装客户端

  13. 选择所需的安装站点。

    安装站点

  14. 按照向导说明操作。安装配置管理器客户端向导已成功完成。

    安装完成

有关详细信息，请参阅 Microsoft 文档中的管理集合。

步骤 3：验证计算机

  1. 在客户端计算机上，通过检查 CCMExec 进程是否正在运行来验证客户端是否已安装。

    CCMexe.exe

  2. 验证 SCCM 上的虚拟机是否正在运行客户端。

步骤 4: 使用 VDA 分发内容

以下步骤介绍了如何使用已部署的 VDA 在关联的虚拟机上分发内容。

  1. 创建程序包

  2. 分发内容

创建程序包

  1. 要创建程序包，右键单击所需的 VDA，然后单击“创建程序包”。

    创建程序包

  2. 通过单击“浏览”指定此程序包的源文件位置。

    浏览程序包

  3. 选择所需的程序包类型。

    创建程序包和程序向导

  4. 输入程序包的“名称”和“命令行”。

    指定程序包详细信息

  5. 单击“下一步”。

    程序包成功

有关详细信息，请参阅 Microsoft 文档中的 配置管理器中的包和程序。

将内容分发出去

  1. 右键单击您已创建的包名称。

  2. 选择 分发内容。

    分发内容

  3. 在 分发内容向导 窗口中，选择您已创建的包的源文件位置。在此示例中，它是 2019-SCCM。单击 下一步。

    指定位置

  4. 验证包（在此示例中为 Zodiac）是否可用于部署。

    验证

    以下图片展示了该软件包已准备就绪，可以进行部署。

    要部署的包

有关详细信息，请参阅 Microsoft 文档中的 部署和管理 Configuration Manager 的内容。

使用 SCCM 的安装序列示例

以下示例展示了安装的步骤和顺序。

  1. 重新启动计算机： 通过重新启动计算机来准备计算机。

    重启计算机

  2. 首次尝试安装 VDA： 启动 VDA 安装。

    1. 将 /quiet、/noreboot 和 /noresume 选项添加到命令行选项中。

    2. 运行您选择的 VDA 安装程序（本地映像或其中一个最小安装程序）。

      首次尝试安装 VDA

    3. SCCM 必须捕获返回代码。

      • 如果返回代码为 0 或 8，则安装完成，需要重新启动。

        SCCM 捕获返回代码

      • 如果返回代码为 3，请重新启动计算机，然后将控制权传递给第二次尝试安装 VDA。

        重新启动计算机

  3. 第二次尝试安装 VDA： 继续 VDA 安装。

    1. 在首次尝试安装 VDA 后，如果文件 %programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml 存在，则安装未完成，必须在重新启动完成后继续。

      第二次尝试安装 VDA

    2. 第二次尝试安装 VDA 重复执行，直到文件 %programdata%\Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml 不存在或返回除 0 或 8 之外的返回代码。将任何其他返回代码视为错误，并且 INSTALL VDA SECOND ATTEMPT 应报告错误并停止。

    3. 通过从文件 %programdata%\ Citrix\XenDesktopSetup\ 目录运行相应的 VDA 安装程序（大多数情况下为 XenDesktopVdaSetup.exe，如果使用了 VDAWorkstationCoreSetup_XXXX.exe 则为 XenDesktopRemotePCSetup.exe），且不带任何命令行参数，来恢复 VDA 安装。（VDA 安装程序使用其在首次运行安装程序期间保存的参数。）

      升级任务序列编辑器

    4. 注意 VDA 安装程序的返回代码。

      • 0 或 8: 成功，安装完成，需要重新启动。

        成功安装完成

      • 3: 安装未完成。重新启动计算机并重复 INSTALL VDA SECOND ATTEMPT，直到文件 %programdata%\ Citrix\XenDesktopSetup\CitrixVirtualDesktopAgent.xml 不存在或返回 0 或 8。将任何其他返回代码视为错误，并且 INSTALL VDA SECOND ATTEMPT 应报告错误并结束。

有关返回代码的更多信息，请参阅 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

使用 SCCM 安装虚拟投递代理
June 2, 2026
投稿者: 
C
June 2, 2026
投稿者: 
C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.