Citrix Virtual Apps and Desktops

准备安装

April 8, 2026

投稿者:

C C

部署 Citrix Virtual Apps and Desktops™ 始于安装以下组件。此过程为向防火墙内的用户交付应用程序和桌面做准备。
一个或多个 Delivery Controller
Citrix Director
Citrix StoreFront™
Citrix License Server
一个或多个 Citrix Virtual Delivery Agent (VDA)
可选组件和技术，例如 Universal Print Server、Federated Authentication Service 和 Self-Service Password Reset

对于防火墙外的用户，请安装并配置一个额外组件，例如 Citrix Gateway。有关介绍，请参阅将 Citrix Virtual Apps and Desktops 与 Citrix Gateway 集成。

注意：

请确保在服务器操作系统和工作站操作系统上满足以下 Microsoft 先决条件：

Microsoft Volume Shadow Copy 和 Microsoft Software Shadow Copy Provider 服务正在运行。有关详细信息，请参阅 Volume Shadow Copy Service。

MS-Defender 版本必须高于 4.18.2105.5。有关详细信息，请参阅 Microsoft Defender Antivirus 安全智能和产品更新。

如果部署包含 Windows Server 工作负载，请为 Windows Server 工作负载配置 Microsoft RDS 许可证服务器。
可以使用产品 ISO 上的完整产品安装程序部署许多组件和技术。可以使用独立的 VDA 安装程序安装 VDA。独立的 VDA 安装程序可在 Citrix 下载站点上获取。所有安装程序都提供图形界面和命令行界面。请参阅安装程序。
产品 ISO 包含用于在 Active Directory 中为计算机安装、升级或删除 VDA 的示例脚本。还可以使用这些脚本管理 Machine Creation Services (MCS) 和 Citrix Provisioning（以前称为 Provisioning Services）使用的映像。有关详细信息，请参阅使用脚本安装 VDA。
安装前需查看的信息
技术概述：熟悉产品及其组件。
安全性：规划部署环境时。
已知问题：此版本中可能遇到的问题。
数据库：了解系统数据库以及如何配置它们。在 Controller 安装期间，可以安装 SQL Server Express 作为站点数据库。在安装核心组件后创建站点时，可以配置大多数数据库信息。
远程电脑访问：如果正在部署一个环境，使用户能够远程访问其办公室中的物理计算机。
连接和资源：如果正在使用虚拟机管理程序或其他服务来托管或预配用于应用程序和桌面的 VM。可以在创建站点时（安装核心组件后）配置第一个连接。在此之前设置虚拟化环境。
Microsoft System Center Configuration Manager：如果正在使用 ConfigMgr 管理对应用程序和桌面的访问，或者正在将 Wake on LAN 功能与远程电脑访问结合使用。
公有云主机连接： 如果拥有混合权利许可证，可以创建到公有云的主机连接。有关混合权利许可证的信息，请参阅混合权利续订。有关公有云权利以及此更改原因的信息，请参阅 CTX270373。

组件安装位置

请查看系统要求以了解支持的平台、操作系统和版本。组件先决条件会自动安装，除非另有说明。有关 Citrix StoreFront 和 Citrix License Server 的支持平台和先决条件，请参阅其文档。

可以将核心组件安装在同一台服务器上或不同的服务器上。

将所有核心组件安装在同一台服务器上适用于评估、测试或小型生产部署。
为适应未来扩展，请考虑将组件安装在不同的服务器上。例如，将 Studio 安装在与安装 Controller 的服务器不同的计算机上，可以远程管理站点。
对于大多数生产部署，建议将核心组件安装在单独的服务器上。
在其他服务器上安装其他组件之前，请先安装 Citrix License Server 和许可证。
要在 Server CoreOS（例如 Delivery Controller）上安装受支持的组件，必须使用命令行。该操作系统类型不提供图形界面，因此请在其他位置安装 Studio 和其他工具，然后将其指向 Controller 服务器。

可以在同一台服务器上同时安装 Delivery Controller™ 和适用于多会话操作系统的 VDA。启动安装程序并选择 Delivery Controller（以及要在该计算机上安装的任何其他核心组件）。然后再次启动安装程序并选择适用于多会话操作系统的 Virtual Delivery Agent。

确保每个操作系统都具有最新更新。

确保所有计算机都具有同步的系统时钟。保护计算机之间通信的 Kerberos 基础结构需要同步。
对于 XenServers，虚拟机的电源状态可能显示为未知，即使它已注册。要解决此问题，请编辑注册表项 HostTime 值以禁用与主机的时钟同步：

HKEY_LOCAL_MACHINE\Software\Citrix\XenTools\HostTime="Local"

HKEY_LOCAL_MACHINE\Software\Wow6432Node\Citrix\XenTools\HostTime="Local"

提示：

默认值为 HostTime="UTC"。将此值更改为 UTC 以外的值，例如 Local。此更改可有效禁用与主机的时钟同步。

Windows 10 单会话计算机的优化指南可在 CTX216252 中找到。

请勿安装组件的位置：
请勿在 Active Directory 域控制器上安装任何组件。
不支持在 SQL Server 群集安装、SQL Server 镜像安装的节点上或在运行 Hyper-V 的服务器上安装 Controller。
如果您尝试在当前产品版本不支持的 Windows 操作系统上安装或升级 VDA，则会显示一条消息，引导您查阅一篇介绍相关选项的文章。
权限和 Active Directory 要求
您必须是域用户，并且是安装组件的计算机上的本地管理员。
- 要使用独立的 VDA 安装程序，您必须具有提升的管理权限或使用 以管理员身份运行。

在开始安装之前，请配置您的 Active Directory 域。

系统要求列出了支持的 Active Directory 功能级别。Active Directory 加入包含更多信息。
您必须至少有一个运行 Active Directory 域服务的域控制器。
- 请勿在域控制器上安装任何 Citrix Virtual Apps™ and Desktops 组件。
- 在 Studio 中指定组织单位名称时，请勿使用正斜杠 (/)。
- 用于安装 Citrix License Server 的 Windows 用户帐户会自动配置为委派管理完全管理员。

有关详细信息：

安全最佳实践
委派管理
有关 Active Directory 配置的 Microsoft 文档

安装指南、注意事项和最佳实践

安装任何组件期间

从完整产品介质安装或升级 Delivery Controller、Studio、License Server 或 Director 时，如果 Citrix 安装程序检测到计算机上存在先前 Windows 安装导致的待处理重新启动，则安装程序将停止并显示退出/返回代码 9。系统会提示您重新启动计算机。

这不是 Citrix 强制重新启动。这是由于计算机上早期安装的其他组件导致的。如果发生这种情况，请重新启动计算机，然后再次启动 Citrix 安装程序。

使用命令行界面时，您可以通过在命令中包含 /no_pending_reboot_check 选项来阻止检查待处理的重新启动。
通常，如果组件具有先决条件，则安装程序会在不存在时部署它们。某些先决条件可能需要重新启动计算机。
在安装之前、期间和之后创建对象时，请为每个对象指定唯一的名称。例如，为网络、组、目录和资源提供唯一的名称。
如果组件安装不成功，安装将停止并显示错误消息。已成功安装的组件将保留。您无需重新安装它们。
当您安装（或升级）组件时，Citrix Analytics 会自动收集。默认情况下，安装完成后，这些数据会自动上传到 Citrix。此外，当您安装组件时，您会自动加入 Citrix 客户体验改善计划 (CEIP)，该计划会上传匿名数据。

在安装期间，您还可以选择参与其他 Citrix 技术，这些技术会收集诊断信息以进行维护和故障排除。有关这些计划的信息，请参阅 Citrix Insight Services。
- 安装（或升级）Studio 时，会自动收集（并随后上传）Google Analytics 数据。安装 Studio 后，您可以使用注册表项 HKLM\Software\Citrix\DesktopStudio\GAEnabled 更改此设置。值为 1 表示启用收集和上传，0 表示禁用收集和上传。
- 如果 VDA 安装失败，MSI 分析器会解析失败的 MSI 日志，显示确切的错误代码。如果是已知问题，分析器会建议一篇 CTX 文章。分析器还会收集有关失败错误代码的匿名数据。此数据包含在 CEIP 收集的其他数据中。如果您终止 CEIP 注册，则收集的 MSI 分析器数据将不再发送到 Citrix。
VDA 安装期间
适用于 Windows 的 Citrix Workspace™ 应用程序可用，但在安装 VDA 时默认不安装。您或您的用户可以从 Citrix 网站下载并安装（和升级）适用于 Windows 的 Citrix Workspace 应用程序以及其他 Citrix Workspace 应用程序。或者，您可以从 StoreFront 服务器提供这些 Citrix Workspace 应用程序。请参阅 StoreFront 文档。
Microsoft Print Spooler 服务必须启用。如果该服务被禁用，则无法成功安装 VDA。
大多数受支持的 Windows 版本都已安装 Microsoft Media Foundation。如果计算机没有 Media Foundation（例如 N 版本），则某些多媒体功能将不会安装且无法工作。
- Windows Media 重定向
- HTML5 视频重定向
- HDX™ RealTime 网络摄像头重定向
您可以确认此限制，或者结束 VDA 安装，并在安装 Media Foundation 后稍后重新启动。在图形界面中，此选择会以消息形式显示。在命令行中，您可以使用 /no_mediafoundation_ack 选项来确认此限制。
安装 VDA 时，会自动创建一个名为 Direct Access Users 的新本地用户组。在单会话操作系统 VDA 上，此组仅适用于 RDP 连接。在多会话操作系统 VDA 上，此组适用于 ICA® 和 RDP 连接。
VDA 必须具有用于通信的有效 Controller 地址。否则，无法建立会话。您可以在安装 VDA 时或之后指定 Controller 地址。请记住，此操作必须完成。有关详细信息，请参阅 VDA 注册。

VDA 安装后和安装期间的重新启动

VDA 安装结束时需要重新启动。默认情况下，此重新启动会自动发生。

将 VDA 升级到版本 7.17（或更高受支持版本）时，升级期间会发生重新启动。这是无法避免的。
要最大程度地减少 VDA 安装期间所需的重新启动次数：
确保在开始 VDA 安装之前安装了受支持的 .NET Framework 版本。
对于 Windows 多会话操作系统计算机，在安装 VDA 之前安装并启用 RDS 角色服务。

如果您在安装 VDA 之前未安装这些必备项：

如果您使用的是图形界面或不带 /noreboot 选项的命令行界面，计算机将在安装必备项后自动重新启动。
如果您使用的是带 /noreboot 选项的命令行界面，您必须启动重新启动。

升级 VDA 版本时，升级期间会发生重新启动。这是无法避免的。

安装或升级失败时恢复

注意：

此功能适用于单会话和多会话 VDA。

如果单会话 VDA 安装或升级失败，并且“失败时恢复”功能已启用，计算机将恢复到在安装或升级开始之前设置的还原点。

如果多会话 VDA 安装或升级失败，并且“失败时恢复”功能已启用，计算机将恢复到在安装或升级开始之前执行的备份。

在启用此功能的单会话 VDA 安装或升级开始时，安装程序会在实际安装或升级开始之前创建一个系统还原点。如果 VDA 安装或升级失败，计算机将恢复到还原点状态。%temp%/Citrix 文件夹包含部署日志和有关还原的其他信息。

在启用此功能的多会话 VDA 安装或升级开始时，安装程序会在实际安装或升级开始之前创建一个服务器备份。如果 VDA 安装或升级失败，计算机将恢复到备份状态。%temp%/Citrix 文件夹包含部署日志和有关还原的其他信息。创建服务器备份所需的时间取决于所需备份的大小以及服务器可用的资源量。备份存储在 C:\WindowsImageBackup\servername 中。

默认情况下，此功能处于禁用状态。

如果您计划启用此功能，请确保系统还原未通过 GPO 设置 (Computer Configuration > Administrative Templates > System > System Restore) 禁用。

注意：
此 GPO 设置不适用于还原多会话 VDA。
在安装或升级单会话或多会话 VDA 时启用此功能：
当使用 VDA 安装程序的图形界面（例如，使用 Autostart 或不带任何还原或静默选项的 XenDesktopVDASetup.exe 命令）时，请在“摘要”页面上选中“如果更新失败则启用自动还原”复选框。
如果安装/升级成功完成，则不会使用还原点/备份，但会保留。
使用命令行运行带 /enablerestore 或 /enablerestorecleanup 选项的 VDA 安装程序。
- 如果您使用 /enablerestorecleanup 选项，并且安装/升级成功完成，则还原点/服务器备份将自动删除。
- 如果您使用 /enablerestore 选项，并且安装/升级成功完成，则不会使用还原点，但会保留。
安装程序

完整产品安装程序

使用 ISO 中提供的完整产品安装程序，您可以：

安装、升级或删除核心组件：Delivery Controller、Studio、Director 和 License Server。
安装或升级 StoreFront。
安装或升级适用于单会话或多会话操作系统的 Windows VDA。
在您的打印服务器上安装通用打印服务器 UpsServer 组件。
安装联合身份验证服务。
安装会话录制。
安装 Workspace Environment Management。
注意：
Workspace Environment Management™ 代理安装程序未本地化。它仅提供英文版本。
要为单个用户（例如，用于 Web 开发）从多会话操作系统交付桌面，请使用完整产品安装程序的命令行界面。有关详细信息，请参阅服务器 VDI。
独立 VDA 安装程序
独立 VDA 安装程序可在 Citrix 下载页面上获取。（它们无法从产品安装介质获取。）独立 VDA 安装程序比完整产品 ISO 小得多。它们更易于适应以下部署：
使用已暂存或本地复制的电子软件分发 (ESD) 软件包
具有物理计算机
具有远程办公室

默认情况下，自解压独立 VDA 中的文件将提取到 Temp 文件夹。与使用完整产品安装程序相比，提取到 Temp 文件夹时，计算机上需要更多的磁盘空间。但是，提取到 Temp 文件夹的文件在安装完成后会自动删除。或者，您可以使用带绝对路径的 /extract 命令。

有四个独立的 VDA 安装程序可供下载。

多会话操作系统虚拟投递代理 (VDAServerSetup.exe)：

安装适用于多会话操作系统的 VDA。它支持完整产品安装程序提供的所有多会话操作系统 VDA 选项。

单会话操作系统虚拟投递代理 (VDAWorkstationSetup.exe)：

安装适用于单会话操作系统的 VDA。它支持完整产品安装程序提供的所有单会话操作系统 VDA 选项。

单会话操作系统核心服务虚拟投递代理 (VDAWorkstationCoreSetup.exe)：

安装适用于单会话操作系统的 VDA，该 VDA 针对远程电脑访问部署或核心 VDI 安装进行了优化。远程电脑访问使用物理机。核心 VDI 安装是未用作映像的虚拟机。它仅安装此类部署的 VDA 连接所需的核心服务。因此，它仅支持完整产品安装程序或 VDAWorkstationSetup.exe 安装程序有效选项的子集。

此安装程序不安装或包含用于以下目的的组件：

App-V。
配置文件管理。从安装中排除 Citrix Profile Management 会影响 Citrix Director 显示。有关详细信息，请参阅安装 VDA。
计算机身份服务。
Citrix MCS IODriver
Citrix Backup and Restore
deviceTRUST
uberAgent
WEM

VDAWorkstationCoreSetup.exe 安装程序不安装或包含以下组件：适用于 Windows 的 Citrix Workspace 应用程序 (CWA)、Citrix Secure Access Client (CSA)、Citrix User Personalization Layer (UPL)、Session Recording Agent (SRAGENT) 和 Citrix Assistant App (ASSISTANTAPP)。

使用 VDAWorkstationCoreSetup.exe 相当于使用完整产品安装程序或 VDAWorkstationSetup 安装程序安装单会话操作系统 VDA，并执行以下操作之一：

在图形界面中：在“环境”页面上选择“远程电脑访问”选项。
在命令行界面中：指定 /remotepc 选项。
在命令行界面中：指定 /components vda 以及列出所有有效附加组件名称的 /exclude 选项。

您可以通过运行完整产品安装程序来稍后安装省略的组件/功能。该操作使您能够安装所有缺失的组件。

VDAWorkstationCoreSetup.exe 安装程序会自动安装 Browser Content Redirection MSI。此自动安装适用于 VDA 2003 及更高版本支持的版本。

单会话核心服务虚拟投递代理 (VDASingleSessionCoreSetup.exe)：

适用于 Windows 365 Cloud PC 和远程电脑部署的新型轻量级单会话 VDA 元安装程序。此安装程序基于现有 VDAWorkstationCoreSetup.exe 安装程序构建，可提供必要的 VDA 组件以及配置文件管理、deviceTRUST、uberAgent、WEM、备份和还原以及 VDA 升级代理。可以使用命令行选项 /enablerestore 或 /enablerestorecleanup 启用备份和还原功能。

它显著减小了程序包大小，并提高了基于云的工作负载的安装可靠性。此安装程序专为现代远程电脑场景设计，为在 Windows 365 和远程电脑上部署 Citrix 工作负载提供了简化且高性能的选项。

使用单会话 VDA 安装程序的最佳实践

对于单会话操作系统，有四种不同的安装程序可用。完整产品 VDA 安装程序和 VDAWorkstationSetup.exe 安装程序提供所有组件的安装，而 VDAWorkstationCoreSetup.exe 和 VDASingleSessionCoreSetup.exe 安装程序不包含某些默认和附加组件。

为了保持环境稳定性、一致的性能和持续的可支持性，Citrix 建议在 Citrix VDA 的整个生命周期（包括安装、升级和卸载）中始终使用一致的安装程序类型。混合使用安装程序类型可能会带来某些风险。

混合使用安装程序类型相关的风险：

场景 1： 如果单会话 VDA 最初是使用 VDAWorkstationCoreSetup.exe 或 VDASingleSessionCoreSetup.exe 安装程序安装的，随后使用完整产品 VDA 安装程序或 VDAWorkstationSetup.exe 安装程序进行升级，则除非明确排除，否则以前排除的组件可能会在升级期间安装。

场景 2： 如果单会话 VDA 最初是使用完整产品 VDA 安装程序或 VDAWorkstationSetup.exe 安装的，随后使用 VDAWorkstationCoreSetup.exe 或 VDASingleSessionCoreSetup.exe 进行升级，则核心服务 VDA 安装程序未安装的任何组件都将从升级中排除。这些组件既不会在升级过程中升级，也不会在卸载期间删除。

场景 3：如果最初使用 VDAWorkstationCoreSetup.exe 安装程序安装了单会话 VDA，随后又使用 VDASingleSessionCoreSetup.exe 进行了升级，则您将体验到新功能。如果下次使用 VDAWorkstationCoreSetup.exe 进行升级，则 VDASingleSessionCoreSetup.exe 新增的组件在升级过程中不会升级，在卸载过程中也不会删除。

解决混合安装程序类型的指南：

如果需要混合使用安装程序类型，务必确保在升级过程中包含相同的组件。

如果安装程序类型意外混合，导致安装了额外的组件或某些组件脱离了管理，并且需要还原以前的环境，请按以下步骤操作：

对于场景 1：从 Windows 的“卸载或更改程序”功能中卸载 VDA，然后使用最初使用的安装程序（VDAWorkstationCoreSetup.exe 或 VDASingleSessionCoreSetup.exe）重新安装 VDA。
对于场景 2：使用完整产品 VDA 安装程序或 VDAWorkstationSetup.exe 安装程序升级缺失的组件。
对于场景 3：如果您打算继续利用新功能，请使用 VDASingleSessionCoreSetup.exe 安装程序升级缺失的组件。或者，如果您在通过 VDASingleSessionCoreSetup.exe 升级后不希望使用新功能，请首先从 Windows 的“卸载或更改程序”功能中卸载 VDA，然后使用 VDAWorkstationCoreSetup.exe 重新安装 VDA。

Citrix 安装返回代码

安装日志包含组件安装结果，其形式为 Citrix 返回代码，而非 Microsoft 值。

0 = 成功
1 = 失败
2 = 部分成功
3 = 部分成功且需要重新启动
4 = 失败且需要重新启动
5 = 用户已取消
6 = 命令行参数错误
7 = 找到更高版本
8 = 成功且需要重新启动
9 = 文件锁定重新启动
10 = 已中止
11 = 介质失败
12 = 许可证失败
13 = 预检查失败
14 = 已中止待处理的重新启动检查
15 = 预检查通过 - 在使用新的 /precheckonly 命令行选项后，如果预检查通过，则返回此代码。
16 = 预检查失败 - 在使用新的 /precheckonly 命令行选项后，如果预检查失败，则返回此代码。
17 = 可选软件失败 - 当新的可选软件组件之一安装失败，并且已选择“如果任何其他选定组件失败，则继续 VDA 安装或升级”时，将返回此代码。

例如，当使用 Microsoft System Center Configuration Manager 等工具时，如果安装日志包含返回代码 3，则脚本化 VDA 安装可能显示为失败。当 VDA 安装程序正在等待必须由您启动的重新启动时（例如，在服务器上安装 RDS 角色先决条件后），可能会发生这种情况。仅当所有先决条件和选定组件都已安装，并且在安装后重新启动计算机时，VDA 安装才被视为成功。

或者，您可以将安装包装在 CMD 脚本中（它们返回 Microsoft 退出代码），或者更改 Configuration Manager 包中的成功代码。

为 Windows Server 工作负载配置 Microsoft RDS 许可证服务器

本产品在交付 Windows Server 工作负载（例如 Windows 2016）时，会访问 Windows Server 远程会话功能。这通常需要远程桌面服务客户端访问许可证 (RDS CAL)。VDA 必须能够联系 RDS 许可证服务器以请求 RDS CAL。安装并激活许可证服务器。有关详细信息，请参阅 Microsoft 文档激活远程桌面服务许可证服务器。对于概念验证环境，可以使用 Microsoft 提供的宽限期。

通过此方法，您可以让此服务应用许可证服务器设置。您可以在映像上的 RDS 控制台中配置许可证服务器和每用户模式。您还可以使用 Microsoft 组策略设置配置许可证服务器。有关详细信息，请参阅 Microsoft 文档使用客户端访问许可证 (CAL) 许可 RDS 部署。

要使用组策略设置配置 RDS 许可证服务器：

在可用计算机上安装远程桌面服务许可证服务器。该计算机必须始终可用。Citrix 产品工作负载必须能够访问此许可证服务器。
使用 Microsoft 组策略指定许可证服务器地址和每用户许可证模式。有关详细信息，请参阅 Microsoft 文档指定 RD 会话主机服务器的远程桌面许可模式。

Windows 10 工作负载需要相应的 Windows 10 许可证激活。建议您遵循 Microsoft 文档来激活 Windows 10 工作负载。

准备安装

安装前需查看的信息

组件安装位置

权限和 Active Directory 要求

安装指南、注意事项和最佳实践

安装任何组件期间

VDA 安装期间

VDA 安装后和安装期间的重新启动

安装或升级失败时恢复

安装程序

完整产品安装程序

独立 VDA 安装程序

使用单会话 VDA 安装程序的最佳实践

Citrix 安装返回代码

为 Windows Server 工作负载配置 Microsoft RDS 许可证服务器

更多信息

在本文中