安装 VDA
重要提示:
- 如果您正在升级,并且当前版本安装了 Personal vDisk 或 AppDisks 软件,请参阅 删除 PvD、AppDisks 和不受支持的主机。
- Citrix® 分发的二进制文件现已签名。签名二进制文件表示它们已通过 Citrix 生成的证书或真实的第三方证书进行验证。
适用于 Windows 计算机的 VDA 有两种类型:适用于多会话操作系统的 VDA 和适用于单会话操作系统的 VDA。(有关适用于 Linux 计算机的 VDA 的信息,请参阅 Linux Virtual Delivery Agent 文档。)
在开始安装之前,请查看 准备安装 并完成所有准备任务。
在安装 VDA 之前,请先安装核心组件。您也可以在安装 VDA 之前创建站点。
本文介绍了安装 VDA 时的安装向导序列。提供了命令行等效项。有关详细信息,请参阅 使用命令行安装。
步骤 1. 下载产品软件并启动向导
如果您使用的是完整产品安装程序:
- 如果您尚未下载产品 ISO:
- Use your Citrix account credentials to access the Citrix Virtual Apps and Desktops™ download page. Download the product ISO file.
- 解压缩文件。或者,将 ISO 文件刻录到 DVD。
-
在您要安装 VDA 的映像或计算机上使用本地管理员帐户。将 DVD 插入驱动器或装载 ISO 文件。如果安装程序未自动启动,请双击装载驱动器上的 AutoSelect 应用程序。
安装向导随即启动。
如果您使用的是独立软件包:
- 使用您的 Citrix 帐户凭据登录,以访问 Citrix Virtual Apps and Desktops 下载页面。下载相应的软件包:
-
VDAServerSetup_2308.exe: 多会话操作系统 VDA 版本 -
VDAWorkstationSetup_2308.exe: 单会话操作系统 VDA 版本 -
VDAWorkstationCoreSetup_2308.exe: 单会话操作系统核心服务 VDA 版本
-
-
右键单击软件包,然后选择以管理员身份运行。
安装向导随即启动。
步骤 2. 选择要安装的产品

Click Start next to the product to install: Citrix Virtual Apps or Citrix Virtual Desktops. (If the machine already has a Citrix Virtual Apps or Citrix Virtual Desktops component installed, this page does not appear.)
命令行选项:/xenapp 用于安装 Citrix 虚拟应用。如果省略此选项,则安装 Citrix 虚拟桌面。
步骤 3. 选择 VDA

选择虚拟投递代理条目。安装程序知道它是在单会话还是多会话操作系统上运行,因此它只提供适当的 VDA 类型。
例如,当您在 Windows Server 2019 计算机上运行安装程序时,多会话操作系统 VDA 选项可用。不提供单会话操作系统 VDA 选项。
如果您尝试在不受此 Citrix Virtual Apps and Desktops 版本支持的操作系统上安装(或升级到)Windows VDA,则会显示一条消息,引导您了解有关选项的信息。
步骤 4. 指定 VDA 的使用方式

在环境页面上,指定您计划如何使用 VDA,指示您是否将此计算机用作预配更多计算机的映像。
您选择的选项会影响自动安装哪些 Citrix Provisioning™ 工具(如果有),以及 VDA 安装程序“附加组件”页面上的默认值。
安装 VDA 时,会自动安装多个 MSI(预配和其他)。阻止其安装的唯一方法是在命令行安装中使用 /exclude 选项。
选择以下选项之一:
-
创建主 MCS 映像: 如果您计划使用 Machine Creation Services™ 预配 VM,请选择此选项以在 VM 映像上安装 VDA。此选项将安装 Machine Identity Service。这是默认选项。
命令行选项:
/mastermcsimage或/masterimage
重要:
安装介质或 ISO 映像必须在本地装载。不支持从网络驱动器装载 ISO 映像以安装软件。
-
使用 Citrix 预配或第三方预配工具创建主映像: 如果您计划使用 Citrix 预配或第三方预配工具(例如 Microsoft System Center 配置管理器)来预配虚拟机,请选择此选项以在虚拟机映像上安装 VDA。
命令行选项:
/masterpvsimage -
(仅在多会话操作系统计算机上显示)启用与服务器的代理连接: 选择此选项可在物理或虚拟机上安装 VDA,该虚拟机将不作为映像用于预配其他计算机。
命令行选项:
/remotepc -
(仅在单会话操作系统计算机上显示) 启用远程电脑访问: 选择此选项可在物理机上安装 VDA,以用于远程电脑访问。
命令行选项:
/remotepc
单击下一步。
此页面不显示:
- 如果您正在升级 VDA
- 如果您正在使用
VDAWorkstationCoreSetup_2308.exe、VDAServerSetup_2308.exe或VDAWorkstationSetup_2308.exe安装程序
步骤 5. 选择要安装的组件和安装位置

在核心组件页面上:
-
位置: 默认情况下,组件安装在
C:\Program Files\Citrix。此默认设置适用于大多数部署。如果您指定其他位置,该位置必须具有网络服务execute权限。 -
组件: 默认情况下,Citrix Workspace App for Windows 不随 VDA 一起安装。如果您使用的是
VDAWorkstationCoreSetup.exe安装程序,则 Citrix Workspace App for Windows 永远不会安装,因此不显示此复选框。
单击下一步。
命令行选项:/installdir、/components vda,plugin 用于安装 VDA 和适用于 Windows 的 Citrix Workspace 应用程序
注意:
在以下情况下,您可以在 VDA 安装、升级或卸载期间选择安装、升级或卸载 Citrix Workspace™ 应用程序:
- 在 VDA 安装过程中,您可以选择安装 Citrix Workspace App。默认情况下,此应用程序不会随 VDA 一同安装。
- 在 VDA 升级过程中,如果 VDA 上尚未安装 Citrix Workspace App,您可以选择安装此应用程序。
- 在 VDA 升级期间,如果 Citrix Workspace App 的版本可升级,则会显示升级该应用程序的选项。
- 在 VDA 卸载期间,您可以选择不卸载 Citrix Workspace App。默认情况下,此应用程序会在 VDA 卸载期间被卸载。
步骤 6. 安装附加组件
VDA 安装程序中的“附加组件”页面(/zh-cn/citrix-virtual-apps-desktops/2407/media/vda-ss-addtnl-components.png)
“附加组件”页面包含用于启用或禁用随 VDA 安装其他功能和技术的复选框。在命令行安装中,您可以使用 /exclude 或 /includeadditional 选项明确省略或包含一个或多个可用组件:
- /包含附加组件 “组件名称”[,”组件名称”] …
- /排除指定组件 “组件名称”[,”组件名称”] …
下表指示此页面上各项的默认设置。默认设置取决于您在“环境”页面上选择的选项。
| 附加组件的页面 | 环境页面:“带 MCS 的主映像”或“带 Citrix Provisioning 的主映像”已选中 | 环境页面:“启用到服务器的代理连接”(适用于多会话操作系统)或“远程电脑访问”(适用于单会话操作系统)已选中 |
|---|---|---|
| 适用于 App-V 的 思杰个性化 - VDA | 未选中 | 未选择 |
| 用户个性化设置层 | 未选择 | 未显示,因为它不适用于此用例。 |
| Citrix 配置文件管理 | 已选择 | 未选择 |
| Citrix 配置文件管理 WMI 插件 | 已选择 | 未选择 |
| 思杰 VDA 升级代理 | 未选择 | 未选择 |
| Citrix 备份和还原 | 未选择 | 未选择 |
| 思杰 MCS IO驱动程序 | 未选择 | 未选择 |
| 思杰 润德沃 V2 | 未选择 | 未选择 |
在以下情况下,此页面不会出现:
- 如果您正在使用
VDAWorkstationCoreSetup.exe安装程序。此外,附加组件的命令行选项对该安装程序无效。 - 您正在升级 VDA 并且所有附加组件都已安装。如果某些附加组件已安装,则此页面将仅列出未安装的组件。
选中或清除以下复选框。(这些组件在安装程序中可能以不同的顺序显示。)
-
Citrix Personalization for App-V: 如果您使用 Microsoft App-V 软件包中的应用程序,请安装此组件。有关详细信息,请参阅 部署和交付 App-V 应用程序。
命令行选项:
/includeadditional "Citrix Personalization for App-V – VDA"启用组件安装,/exclude "Citrix Personalization for App-V – VDA"阻止组件安装。 -
Citrix User Personalization Layer: 安装用户个性化层的 MSI。有关详细信息,请参阅 用户个性化层。
此组件仅在单会话 Windows 10 计算机上安装 VDA 时出现。
命令行选项:
/includeadditional "User Personalization Layer"启用组件安装,/exclude "User Personalization Layer"阻止组件安装。 -
Citrix Profile Management:此组件管理用户配置文件中的用户个性化设置。有关详细信息,请参阅 Profile Management。
在安装中排除 Citrix Profile Management 会影响使用 Citrix Director 对 VDA 进行监视和故障排除。在用户详细信息和端点页面上,个性化面板和登录持续时间面板将失败。在控制板和趋势页面上,平均登录持续时间面板仅显示已安装 Profile Management 的计算机的数据。
即使您正在使用第三方用户配置文件管理解决方案,Citrix 仍建议您安装并运行 Citrix Profile Management Service。无需启用此服务。
命令行选项:
/includeadditional "Citrix Profile Management"启用组件安装,/exclude "Citrix Profile Management"阻止组件安装。 -
Citrix Profile Management WMI 插件:此插件在 WMI (Windows Management Instrumentation) 对象中提供用户配置文件管理运行时信息(例如,配置文件提供程序、配置文件类型、大小和磁盘使用情况)。WMI 对象向 Director 提供会话信息。
命令行选项:
/includeadditional "Citrix Profile Management WMI Plug-in"启用组件安装,/exclude "Citrix Profile Management WMI Plug-in"阻止组件安装。 -
VDA 升级代理:仅适用于 Citrix DaaS(以前称为 Citrix Virtual Apps and Desktops 服务)部署。使 VDA 能够参与 VDA 升级功能。您可以使用该功能通过管理控制台立即或在计划时间升级目录的 VDA。如果未安装此代理,您可以通过在计算机上运行 VDA 安装程序来升级 VDA。
命令行选项:
/includeadditional "Citrix VDA Upgrade Agent"启用组件安装,/exclude "Citrix VDA Upgrade Agent"阻止组件安装。 -
用于存储优化的 MCSIO 写入缓存:安装 Citrix MCS I/O 驱动程序。有关详细信息,请参阅 虚拟机管理程序共享的存储 和 配置临时数据缓存。
命令行选项:
/includeadditional "Citrix MCS IODriver"启用组件安装,/exclude "Citrix MCS IODriver"阻止组件安装。 -
代理配置:如果您计划在您的环境中使用 Rendezvous 协议与 Gateway Service、VDA Upgrade Service 等,并且您的网络中存在用于出站连接的非透明代理,请在此处指定代理。仅支持 HTTP 代理。
如果安装此组件,请在Rendezvous 代理配置页面上指定代理地址或 PAC 文件路径。有关功能详细信息,请参阅 Rendezvous protocol。
命令行选项:
/includeadditional "Citrix Rendezvous V2"启用组件安装,/exclude "Citrix Rendezvous V2"阻止组件安装。 -
Citrix 备份和还原:如果 VDA 安装或升级失败,此组件可以将计算机恢复到安装或升级之前的备份。
确保满足 安装准备 中提到的 Microsoft 先决条件。
命令行选项:
/includeadditional "Citrix Backup and Restore"用于启用组件安装,/exclude "Citrix Backup and Restore"用于阻止组件安装。注意:
如果启用了 MCS 存储优化,则 Windows 服务器或桌面操作系统的备份或还原可能会失败。要解决此问题,请在元安装程序中禁用 MCS 存储优化选项。
步骤 7. 交付控制器™ 地址

在Delivery Controller页面上,选择输入已安装的 Controller 地址的方式。Citrix 建议您在安装 VDA 时指定地址(手动执行)。VDA 必须拥有此信息才能向 Controller 注册。如果 VDA 无法注册,用户将无法访问该 VDA 上的应用程序和桌面。
- 手动执行:(默认)输入已安装的 Controller 的 FQDN,然后单击添加。如果您安装了更多 Controller,请添加它们的地址。
- 稍后执行(高级): 如果您选择此选项,向导会要求您在继续之前确认您的操作。要稍后指定地址,您可以重新运行安装程序或使用 Citrix 组策略。向导也会在摘要页面上提醒您。
- 从 Active Directory 中选择位置: 仅当计算机已加入域且用户是域用户时有效。
- 使用 WebSocket 令牌(技术预览): 此功能用于创建一个 WebSocket VDA。其中,WebSocketToken 是用于验证所需令牌的凭据。
- 让机器创建服务自动执行: 仅在使用 MCS 预配计算机时有效。
单击下一步。如果您选择了稍后执行(高级),系统会提示您确认稍后指定 Controller 地址。
其他注意事项:
- 地址不能包含非字母数字字符。
- 如果您在 VDA 安装期间和组策略中指定地址,则策略设置将覆盖安装期间提供的设置。
- VDA 成功注册要求用于与 Controller 通信的防火墙端口处于打开状态。此操作在向导的防火墙页面上默认启用。
- 指定 Controller 位置(在 VDA 安装期间或之后)后,您可以使用自动更新功能在添加或删除 Controller 时更新 VDA。有关 VDA 如何发现和注册 Controller 的详细信息,请参阅VDA 注册。
命令行选项:/controllers
步骤 8. 代理配置

只有在附加组件页面上启用了代理配置复选框时,才会显示代理配置页面。
- 选择是通过代理地址还是 PAC 文件路径指定代理源。
-
指定代理地址或 PAC 文件路径。
- 代理地址格式:
http://<url-or-ip>:<port> - PAC 文件格式:
http://<url-or-ip>:<port>/<path>/<filename>.pac
- 代理地址格式:
代理端口的防火墙必须打开,连接测试才能成功。如果无法连接到代理,您可以选择是否继续 VDA 安装。
命令行选项:/proxyconfig
步骤 9. 启用或禁用功能

在“功能”页面上,使用复选框启用或禁用您要使用的功能。
-
使用 Windows 远程协助: 启用此功能后,Windows 远程协助将与 Director 的用户影子功能一起使用。Windows 远程协助会在防火墙中打开动态端口。(默认 = 禁用)
命令行选项:
/enable_remote_assistance -
使用实时音频传输: 如果您的网络中广泛使用 IP 语音,请启用此功能。此功能可降低延迟并提高在有损网络上的音频弹性。它允许使用 RTP over UDP 传输音频数据。(默认 = 禁用)
命令行选项:
/enable_real_time_transport -
使用屏幕共享: 启用后,屏幕共享使用的端口将在 Windows 防火墙中打开。(默认 = 禁用)
命令行选项:
/enable_ss_ports -
此 VDA 是否安装在云中的 VM 上: 此设置有助于 Citrix 正确识别本地和服务 (Citrix Cloud™) VDA 部署的资源位置,以用于遥测目的。此功能对客户侧利用率没有影响。如果您的部署使用 Citrix DaaS,请启用此设置(默认 = 禁用)。
命令行选项:
/xendesktopcloud -
安全默认设置: 此选项将各种功能的默认设置从启用更改为禁用,以实现更安全的开箱即用配置。相关功能包括:客户端驱动器重定向、特殊文件夹重定向、拖放、客户端 TWAIN 设备重定向、客户端 USB 即插即用设备重定向、客户端打印机重定向、客户端剪贴板重定向和客户端麦克风重定向。
命令行选项:/ENABLE_SECURE_DEFAULTS
单击“下一步”。
步骤 10. 防火墙端口

在“防火墙”页面上,默认情况下,如果 Windows 防火墙服务正在运行,即使防火墙未启用,端口也会自动打开。此默认设置适用于大多数部署。有关端口信息,请参阅网络端口。
单击 下一步。
命令行选项:/enable_hdx_ports
步骤 11. 查看先决条件并确认安装

摘要页面列出了将要安装的内容。使用 返回 按钮返回到之前的向导页面并更改选择。
准备就绪后,单击 安装。
如果尚未安装或启用先决条件,计算机可能会重启一次或多次。请参阅准备安装。
步骤 12. 诊断

在 诊断 页面上,选择是否参与 Citrix Call Home。如果您选择参与(默认),请单击 连接。出现提示时,输入您的 Citrix 帐户凭据。
凭据验证通过后(或者如果您选择不参与),单击 下一步。
使用完整产品安装程序时,如果您在 诊断 页面上单击 连接 而未首先选择 收集诊断信息,则在关闭 连接到 Citrix Insight Services 对话框后,下一步 按钮将禁用。您无法移动到下一页。要重新启用 下一步 按钮,请选择并立即取消选择 收集诊断信息。
有关详细信息,请参阅Call Home。
步骤 13. 完成此安装

“完成”页面包含所有成功安装和初始化的必备项和组件的绿色复选标记。
单击“完成”。默认情况下,计算机将自动重新启动。尽管可以禁用此自动重新启动,但在计算机重新启动之前,无法使用 VDA。
后续步骤
如有需要,请重复上述过程,在其他计算机或映像上安装 VDA。
安装所有 VDA 后,启动 Studio。如果尚未创建站点,Studio 会自动引导您完成该任务。完成后,Studio 会引导您创建计算机目录,然后创建交付组。请参阅:
思杰优化器
Citrix Optimizer 是一款适用于 Windows 操作系统的工具,可帮助 Citrix 管理员通过删除和优化各种组件来优化 VDA。
安装 VDA 并完成最终重新启动后,下载并安装 Citrix Optimizer。请参阅 CTX224676。CTX 文章包含下载包以及有关安装和使用 Citrix Optimizer 的说明。
自定义 VDA
要自定义已安装的 VDA:
- 在 Windows 的“程序和功能”中,选择“Citrix 虚拟投递代理”或“Citrix 远程电脑访问/VDI 核心服务 VDA”。然后右键单击并选择“更改”。
-
选择“自定义 Virtual Delivery Agent 设置”。安装程序启动后,您可以更改:
- 控制器地址
- 用于向控制器注册的 TCP/IP 端口(默认值 = 80)
- 是否自动打开 Windows 防火墙端口
故障排除
-
有关 Citrix 如何报告组件安装结果的信息,请参阅Citrix 安装返回代码。
-
在交付组的 Studio 显示中,详细信息窗格中的已安装 VDA 版本条目可能不是计算机上安装的版本。计算机的 Windows 程序和功能显示实际的 VDA 版本。
-
VDA 安装后,必须先向 Delivery Controller 注册,然后才能向用户交付应用程序或桌面。
要了解 VDA 注册方法以及如何排查注册问题,请参阅VDA 注册。
已知限制
当您使用 Citrix Workspace app for Windows 1912 或更早版本时,会话会在一段时间后断开。此问题已在较新的 LTSR 和 CR 版本的 Citrix Workspace app 中修复。 有关支持的版本信息,请参阅适用于 Windows 的 Citrix Workspace 应用程序/适用于 Windows 的 Citrix Receiver 长期服务版本。