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

选择虚拟投递代理条目。安装程序知道它是在单会话还是多会话操作系统上运行,因此它只提供适当的 VDA 类型。
例如,当您在 Windows Server 2019 计算机上运行安装程序时,多会话操作系统 VDA 选项可用。单会话操作系统 VDA 选项不提供。
如果您尝试在不支持此 Citrix Virtual Apps and Desktops 版本的操作系统上安装(或升级到)Windows VDA,则会显示一条消息,引导您了解相关选项的信息。
步骤 4. 指定 VDA 的使用方式
VDA 安装程序中的环境页面(/zh-cn/citrix-virtual-apps-desktops/2503/media/vda-ss-environment.png)
在环境页面上,指定您计划如何使用 VDA,指示您是否将此计算机用作预配更多计算机的映像。
您选择的选项会影响自动安装哪些 Citrix Provisioning™ 工具(如果有),以及 VDA 安装程序“附加组件”页面上的默认值。
安装 VDA 时,会自动安装多个 MSI(预配和其他)。阻止其安装的唯一方法是在命令行安装中使用 /exclude 选项。
选择以下选项之一:
-
创建主 MCS 映像: 如果您计划使用 Machine Creation Services™ 预配 VM,请选择此选项以在 VM 映像上安装 VDA。此选项将安装 Machine Identity Service。这是默认选项。
命令行选项:
/mastermcsimage或/masterimage
重要提示:
安装介质或 ISO 映像必须在本地装载。不支持从网络驱动器装载 ISO 映像以安装软件。
-
Create a master image using Citrix Provisioning or third-party provisioning tools: Select this option to install a VDA on a VM image, if you plan to use either Citrix Provisioning or third-party provisioning tools (such as Microsoft System Center Configuration Manager) to provision VMs.
命令行选项:
/masterpvsimage -
(仅在多会话操作系统计算机上显示)启用与服务器的代理连接: 选择此选项可在物理或虚拟计算机上安装 VDA,该计算机不会用作预配其他计算机的映像。
命令行选项:
/remotepc -
(仅在单会话操作系统计算机上显示) 启用远程电脑访问: 选择此选项可在物理计算机上安装 VDA,以用于远程电脑访问。
命令行选项:
/remotepc
单击下一步。
此页面不显示:
- 如果您正在升级 VDA
- 如果您正在使用
VDAWorkstationCoreSetup_2308.exe、VDAServerSetup_2308.exe或VDAWorkstationSetup_2308.exe安装程序
步骤 5. 选择安装 VDA 的位置

注意:
新的“可选软件”页面。CWA 和 CSA 已从“组件”页面移至新的“可选软件”页面。
在组件页面上:
-
位置: 默认情况下,VDA 安装在
C:\Program Files\Citrix中。此默认设置适用于大多数部署。如果您指定其他位置,该位置必须对网络服务具有execute权限。
单击下一步。
步骤 6. 安装其他组件

注意:
“Citrix Personalization for App-V - VDA” has been renamed to “App Packages Delivery Component”.
“附加组件”页面包含用于启用或禁用与其他功能和技术一起安装 VDA 的复选框。在命令行安装中,您可以使用 /exclude 或 /includeadditional 选项明确排除或包含一个或多个可用组件:
- 包含附加 “组件”[,”组件”] …
- 排除 “组件”[,”组件”] …
下表指示此页面上项目的默认设置。默认设置取决于您在“环境”页面上选择的选项。
| 附加组件的页面 | 环境页面:“带 MCS 的主映像”或“带 Citrix Provisioning 的主映像”已选择 | 环境页面:“启用与服务器的代理连接”(适用于多会话操作系统)或“远程电脑访问”(适用于单会话操作系统)已选择 |
|---|---|---|
| 应用程序包交付组件 | 未选择 | 未选择 |
| 用户个性化功能层 | 未选择 | 未显示,因为它不适用于此用例。 |
| Citrix 配置文件管理 | 已选择 | 未选择 |
| Citrix 配置文件管理 WMI 插件 | 已选择 | 未选择 |
| 思杰 VDA 升级代理 | 未选择 | 未选择 |
| Citrix 备份和恢复 | 未选择 | 未选择 |
| 思杰 MCS IO驱动程序 | 未选择 | 未选择 |
| 思杰 兰德福 V2 | 未选择 | 未选择 |
如果出现以下情况,此页面将不显示:
- 您正在使用
VDAWorkstationCoreSetup.exe安装程序。此外,附加组件的命令行选项不适用于该安装程序。 - 您正在升级 VDA 并且所有附加组件均已安装。如果某些附加组件已安装,则该页面仅列出未安装的组件。
选中或清除以下复选框。(这些组件在安装程序中的显示顺序可能不同。)
-
应用程序包交付组件: 如果您使用 Microsoft App-V 包中的应用程序,请安装此组件。有关详细信息,请参阅部署和交付 App-V 应用程序。
命令行选项:
/includeadditional "Citrix Personalization for App-V – VDA"用于启用组件安装,/exclude "Citrix Personalization for App-V – VDA"用于阻止组件安装。 -
Citrix 用户个性化层: 安装用户个性化层的 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 的计算机的数据。
即使您正在使用第三方用户配置文件管理解决方案,思杰仍建议您安装并运行思杰配置文件管理服务。无需启用思杰配置文件管理服务。
命令行选项:
/includeadditional "Citrix Profile Management"启用组件安装,/exclude "Citrix Profile Management"阻止组件安装。 -
Citrix 配置文件管理 WMI 插件:此插件在 WMI(Windows 管理规范)对象中提供配置文件管理运行时信息(例如,配置文件提供程序、配置文件类型、大小和磁盘使用情况)。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 协议。
命令行选项:
/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. 安装可选软件

注意:
“可选软件”页面是此版本中的新增功能,为客户提供了更大的灵活性,可以在 VDA 上安装其他 Citrix 软件。
Citrix Workspace™ 应用程序和 Citrix Secure Access™ 客户端已从“组件”页面移至“可选软件”页面。
思杰 设备信任、Uber Agent 组件和 思杰 Workspace Environment Management™ 代理已添加到“可选软件”页面,并且现在默认选择安装。
用户个性化层也已从“附加组件”页面移至“可选软件”页面。其选择逻辑与在“附加组件”页面时相同。也就是说,如果用户个性化层已安装,则会将其选择为“必需”,并且该组件将升级。

在可选软件页面上:
-
组件:默认情况下,Citrix Workspace 应用程序 for Windows 不随 VDA 一起安装。如果您使用的是
VDAWorkstationCoreSetup.exe安装程序,则 Citrix Workspace 应用程序 for Windows 永远不会安装,因此不显示此复选框。
单击下一步。
命令行选项:'/installdir "C:\Program Files\VDA" /components "VDA","CSA","DT","UBERAGENT","PLUGINS"。用于将虚拟投递代理、Citrix 安全访问客户端、Citrix 设备信任、Citrix uberAgent 和 Citrix Workspace 应用程序安装到指定目录中。
注意:
在以下情况下,您可以在 VDA 安装、升级或卸载期间选择安装、升级或卸载 Citrix Workspace 应用程序和其他组件:
During a VDA installation, you can choose to install the components and CWA plugins here. By default, Citrix Workspace app, Citrix Secure Access Client and Citrix User Personalization Layer are not installed during the VDA installation. Rest all components like Citrix deviceTrust®, Citrix uberAgent, and Citrix Workspace Environment Management agent are selected by default to install.
- 在 VDA 升级过程中,如果 Citrix Workspace 应用程序、Citrix Secure Access Client 和 Citrix 用户个性化层尚未在 VDA 中安装,您可以选择将其安装。
- 在 VDA 升级期间,如果 Citrix Workspace app 和其他已安装插件的版本可以升级,则会显示升级它们的选项。
- 在安装或升级期间,如果 Citrix Workspace App (CWA) 插件或任何组件安装或升级失败,您可以通过选中复选框 “如果选定组件失败,则继续 VDA 升级或安装。” 来覆盖失败并继续安装核心 VDA。
- 在 VDA 卸载期间,您可以选择不卸载 Citrix Workspace app 和任何其他已安装的组件。默认情况下,Citrix Workspace app 和其他已安装的组件会在 VDA 卸载期间被卸载。
步骤 8. 交付控制器™ 地址

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

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

在功能页面上,使用复选框启用或禁用您要使用的功能。
-
使用 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
单击下一步。
步骤 11. 防火墙端口

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

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

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

“完成”页面包含所有已成功安装和初始化的必备项和组件的绿色复选标记。
单击完成。默认情况下,计算机将自动重新启动。尽管可以禁用此自动重新启动,但在计算机重新启动之前,无法使用 VDA。
后续步骤
如有需要,请重复上述过程,在其他计算机或映像上安装 VDA。
安装所有 VDA 后,启动 Studio。如果您尚未创建站点,Studio 会自动引导您完成该任务。完成后,Studio 会引导您创建计算机目录,然后创建交付组。请参阅:
Citrix 优化程序
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 或更早版本时,会话会在一段时间后断开连接。此问题已在 Citrix Workspace app 的较新 LTSR 和 CR 版本中修复。 有关支持的版本信息,请参阅 适用于 Windows 的 Citrix Workspace 应用程序 / 适用于 Windows 的 Citrix Receiver 长期服务版本。