Citrix Virtual Apps and Desktops

使用 SCCM 安装 VDA

September 20, 2024

投稿者:

概述

Microsoft Endpoint Configuration Manager（以前称为 System Center Configuration Manager (SCCM) ）是一款 Windows 产品，支持在企业内管理、部署设备和应用程序以及保护其安全。

注意：

以下文章仅介绍基于 Citrix 测试环境的方式提出的建议。可以根据需要自定义这些步骤。Citrix 对满足客户需求所需的任何更新或调整概不负责。

建议

要使用 SCCM 或类似的软件分发工具成功部署 Virtual Delivery Agent (VDA)，Citrix 建议在一系列步骤中使用 VDA 安装程序。
Citrix 不建议在 VDA 安装或升级过程中使用 VDA 清理实用程序。请仅在 VDA 安装程序之前失败时的有限情况下使用 VDA 清理实用程序。

开始之前的准备工作

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

早期软件安装中挂起的更新或重新启动可能需要重新启动。
以前被其他进程锁定的文件可能需要更新，从而强制额外重新启动。
VDA 安装程序中的某些可选组件（例如 Citrix Profile Management 和 Citrix Files）可能需要重新启动。
升级 VDA 时，安装了 VDA 的计算机必须处于维护模式，没有任何会话。
首次在计算机上运行 VDA 安装时，正在使用的 VDA 安装程序将复制到该计算机上。有关 VDA 安装的详细信息，请参阅安装程序。

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

使用 SCCM 部署 VDA 的关键步骤

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

步骤 1：安装 VDA

确定所有必备项后，使用 SCCM 任务排序器完成以下任务：

从安装介质的可访问副本或其中一个 VDA 独立安装程序安装 VDA：
- VDAWorkstationSetup_XXXX.exe
- VDAServerSetup_XXXX.exe
- VDAWorkstationCoreSetup_XXXX.exe
有关 VDA 安装程序的详细信息，请参阅安装程序。

注意：

升级 VDA 时，安装了 VDA 的计算机必须处于维护模式，没有任何会话。
首次在计算机上运行 VDA 安装时，正在使用的 VDA 安装程序将复制到该计算机上。
- 使用 VDA 安装程序而非 VDAWorkstationCoreSetup_XXXX.exe 时，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 安装程序会设置一个一次性注册表项 (\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce)。计算机重新启动时，Windows 将使用该密钥打开 VDA 安装程序。这对 SCCM 来说是个问题，因为 SCCM 无法监视安装并捕获退出代码。

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

创建两个要添加到 OU 的已加入域的虚拟机。最初创建虚拟机时，它们位于计算机文件夹中。将虚拟机移至 SCCM 文件夹。示例：WIN10EN-BB80MJ4.cseblr.com W2K19ST-EBPR3UG.cseblr.com
在 Microsoft Configuration Manager 中，转到 \Administration\Overview\Hierarchy Configuration\Discovery Methods\。
单击 Active Directory 系统发现，然后选中启用 Active Directory 系统发现复选框以启用对新创建的虚拟机的自动发现。
单击图标以选择新容器。
在位置部分中，添加 SCCM 虚拟机所在的路径。
转到 \Administration\Overview\Site Configuration\Sites 并右键单击 SCCM VDA。
选择客户端安装设置 > 客户端请求安装。客户端请求安装属性窗口将打开。
将 VM 设置为 Enabled 后，您可以看到 VM 列表，如下图所示。
创建设备集合以创建 OU。输入集合名称的名称。
请按照向导说明进行操作。

OU 已创建。
将创建的 VM 添加到新创建的设备集合中。
1. 右键单击该 VM。选择 Add Selected Items（添加选定项目）> Add Selected Items to Existing Device Collection（将所选项目添加到现有设备集合中）。
2. 在 Select Collection（选择集合）窗口中，选择所需的设备名称。在此示例中，为 Devices-SCCM。
Devices-SCCM 在 Assets and Compliance（资产与合规性）> Overview（概述）> Device Collections（设备集合）中列出。
选择在设备收集器上安装客户端。
选择所需的安装站点。
请按照向导说明进行操作。安装 Configuration Manager 客户端向导已成功完成。

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

步骤 3：验证计算机

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

步骤 4：使用 VDA 分发内容

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

创建软件包
分发内容

创建软件包

要创建软件包，请右键单击所需的 VDA，然后单击创建软件包。
单击浏览指定此软件包的源文件的位置。
选择所需的软件包类型。
输入软件包名称和命令行。
单击下一步。

有关详细信息，请参阅 Microsoft 文档中的 Packages and programs in Configuration Manager（Configuration Manager 中的软件包和程序）。

分发内容

右键单击您创建的软件包名称。
选择分发内容。
在分发内容向导窗口中，选择您创建的软件包的源文件的位置。在此示例中，为 2019-SCCM。单击下一步。
验证软件包（在本示例中为 Zodiac）是否可供部署。

下图说明了该软件包可供部署。

有关详细信息，请参阅 Microsoft 文档中的 Deploy and manage content for Configuration Manager（部署和管理 Configuration Manager 的内容）。

使用 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 安装命令示例

可用的安装选项有所不同，具体取决于使用的安装程序。有关命令行选项详细信息，请参阅以下文章。

Remote PC Access 的安装命令

以下命令使用单会话核心 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 文档内容采用了机器翻译，仅供您参考。Cloud Software Group 无法控制机器翻译的内容，这些内容可能包含错误、不准确或不合适的语言。对于从英文原文翻译成任何其他语言的内容的准确性、可靠性、适用性或正确性，或者您的 Cloud Software Group 产品或服务沿用了任何机器翻译的内容，我们均不作任何明示或暗示的保证，并且适用的最终用户许可协议或服务条款或者与 Cloud Software Group 签订的任何其他协议（产品或服务与已进行机器翻译的任何文档保持一致）下的任何保证均不适用。对于因使用机器翻译的内容而引起的任何损害或问题，Cloud Software Group 不承担任何责任。

这是否有帮助？

使用 SCCM 安装 VDA

September 20, 2024

投稿者:

September 20, 2024

投稿者:

这是否有帮助？