安装 VDA

重要：

• 如果您正在升级，并且当前版本安装了 Personal vDisk 或 AppDisks 软件，请参阅 删除 PvD、AppDisks 和不受支持的主机。
• Citrix® 分发的二进制文件现已签名。签名二进制文件表示它们已通过 Citrix 生成的证书或真实的第三方证书进行验证。

适用于 Windows 计算机的 VDA 有两种类型：多会话操作系统 VDA 和单会话操作系统 VDA。（有关适用于 Linux 计算机的 VDA 的信息，请参阅 Linux Virtual Delivery Agent 文档。）

在开始安装之前，请查看 准备安装 并完成所有准备任务。

在安装 VDA 之前，请安装核心组件。您也可以在安装 VDA 之前创建站点。

本文介绍了安装 VDA 时的安装向导顺序。提供了命令行等效项。有关详细信息，请参阅 使用命令行安装。

步骤 1. 下载产品软件并启动向导

如果您使用的是完整产品安装程序：

1. 如果您尚未下载产品 ISO：
   • 使用您的 Citrix 帐户凭据访问 Citrix 虚拟应用和桌面™ 下载页面。下载产品 ISO 文件。
   • 解压缩文件。（可选）将 ISO 文件刻录到 DVD。

2. 在要安装 VDA 的映像或计算机上使用本地管理员帐户。将 DVD 插入驱动器或装载 ISO 文件。如果安装程序未自动启动，请双击装载驱动器上的 AutoSelect 应用程序。

   安装向导随即启动。

步骤 2. 选择要安装的产品

组件安装程序中的产品安装页面(/zh-cn/citrix-virtual-apps-desktops/2511/media/product-selector2-75.png)

单击要安装的产品旁边的“开始”：Citrix 虚拟应用或 Citrix 虚拟桌面。（如果计算机已安装 Citrix 虚拟应用或 Citrix 虚拟桌面组件，则此页面不会出现。）

命令行选项：/xenapp 用于安装 Citrix 虚拟应用。如果省略此选项，则安装 Citrix 虚拟桌面。

步骤 3. 选择 VDA

组件安装程序中的组件选择页面(/zh-cn/citrix-virtual-apps-desktops/2511/media/what-to-install-2.png)

选择“Virtual Delivery Agent”条目。安装程序知道它是在单会话还是多会话操作系统上运行，因此它只提供适当的 VDA 类型。

例如，当您在 Windows Server 2019 计算机上运行安装程序时，多会话操作系统 VDA 选项可用。不提供单会话操作系统 VDA 选项。

如果您尝试在不支持此 Citrix Virtual Apps™ and Desktops 版本的操作系统上安装（或升级到）Windows VDA，则会显示一条消息，引导您了解有关选项的信息。

如果您使用的是独立软件包：

1. 使用您的 Citrix 帐户凭据访问 Citrix 虚拟应用和桌面™ 下载页面。下载相应的软件包：
   • VDAServerSetup_2511.exe：多会话操作系统 VDA 版本
   • VDAWorkstationSetup_2511.exe：单会话操作系统 VDA 版本
   • VDAWorkstationCoreSetup_2511.exe：单会话操作系统核心服务 VDA 版本
   • VDASingleSessionCoreSetup_2511.exe：新单会话操作系统核心服务 VDA 版本

2. 右键单击该软件包，然后选择“以管理员身份运行”。

   安装向导随即启动。

步骤 4. 指定 VDA 的使用方式

VDA 安装程序中的环境页面(/zh-cn/citrix-virtual-apps-desktops/2511/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 映像以安装软件。

• 使用 Citrix 预配或第三方预配工具创建主映像： 如果您计划使用 Citrix 预配或第三方预配工具（例如 Microsoft System Center Configuration Manager）来预配 VM，请选择此选项以在 VM 映像上安装 VDA。

  命令行选项：/masterpvsimage

• （仅在多会话操作系统计算机上显示）启用与服务器的代理连接： 选择此选项可在物理或虚拟机上安装 VDA，该虚拟机不会用作预配其他计算机的映像。

  命令行选项：/remotepc

• (仅在单会话操作系统计算机上显示) 启用远程电脑访问： 选择此选项可在物理计算机上安装 VDA，以用于远程电脑访问。

  命令行选项：/remotepc

单击下一步。

此页面不显示：

• 如果您正在升级 VDA
• 如果您正在使用 VDAWorkstationCoreSetup_2507.exe、VDAServerSetup_2507.exe 或 VDAWorkstationSetup_2507.exe 安装程序

步骤 5. 选择 VDA 的安装位置

注意：

CWA 和 CSA 已从“组件”页面移至新的“可选软件”页面。

在组件页面上：

• 位置： 默认情况下，VDA 安装在 C:\Program Files\Citrix 中。此默认设置适用于大多数部署。如果您指定其他位置，该位置必须对网络服务具有 execute 权限。

单击下一步。

步骤 6. 安装其他组件

VDA 安装程序中的附加组件页面(/zh-cn/citrix-virtual-apps-desktops/2511/media/vda-ss-addtnl-components.png)

附加组件页面包含用于启用或禁用随 VDA 安装其他功能和技术的复选框。在命令行安装中，您可以使用 /exclude 或 /includeadditional 选项明确排除或包含一个或多个可用组件：

• /includeadditional “component”[,”component”] …
• /排除 “组件”[,“组件”] …

下表列出了此页面上各项的默认设置。默认设置取决于您在环境页面上所选的选项。

如果出现以下情况，此页面将不显示：

• 您正在使用 VDAWorkstationCoreSetup.exe 安装程序。此外，附加组件的命令行选项不适用于该安装程序。
• 您正在升级 VDA 并且所有附加组件均已安装。如果某些附加组件已安装，则此页面仅列出未安装的组件。

选择或清除以下复选框。（组件在安装程序中可能以不同的顺序显示。）

• 应用程序包交付组件： 如果您使用 Microsoft App-V 包中的应用程序，请安装此组件。有关详细信息，请参阅部署和交付 App-V 应用程序。

  命令行选项：/includeadditional "App Packages Delivery Component" 启用组件安装，/exclude "App Packages Delivery Component" 阻止组件安装。

• Citrix Profile Management： 此组件管理用户配置文件中的用户个性化设置。有关详细信息，请参阅配置文件管理。

  排除安装 Citrix Profile Management 会影响使用 Citrix Director 监视和故障排除 VDA。在“用户详细信息”和“端点”页面上，“个性化”面板和“登录持续时间”面板将失败。在“控制板”和“趋势”页面上，“平均登录持续时间”面板仅显示已安装 Profile Management 的计算机的数据。

  即使您正在使用第三方用户配置文件管理解决方案，Citrix 仍建议您安装并运行 Citrix 配置文件管理服务。无需启用 Citrix 配置文件管理服务。

  命令行选项：/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" 阻止组件安装。

注意：

从此版本开始，Citrix Profile Management 和 Citrix Profile Management WMI 插件现在是 VDA 的一部分，并针对主映像/MCS/PVS 用例自动安装。对于远程 PC 用例，这些组件默认不安装。在所有情况下，已安装的组件都会自动升级。命令行行为与以前的版本保持不变。

• 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. 安装可选软件

注意：

“可选软件”页面是 Citrix Virtual Apps and Desktops 2503 中新增的功能，为客户提供了更大的灵活性，可以在 VDA 上安装其他 Citrix 软件。

Citrix Workspace™ 应用程序和 Citrix Secure Access™ 客户端已从“组件”页面移至“可选软件”页面。

用户个性化层也已从“附加组件”页面移至“可选软件”页面。其选择逻辑与在“附加组件”页面时相同。也就是说，如果用户个性化层已安装，则将其选择为必需，并升级该组件。

在“可选软件”页面上：

• 位置：默认情况下，组件安装在 C:\Program Files\Citrix 中。此默认设置适用于大多数部署。如果指定其他位置，则该位置必须对网络服务具有 execute 权限。
• 组件：默认情况下，Citrix Workspace 应用程序 for Windows 不随 VDA 一起安装。如果您使用的是 VDAWorkstationCoreSetup.exe 安装程序，则 Citrix Workspace 应用程序 for Windows 永远不会安装，因此不显示此复选框。

单击“下一步”。

命令行选项：'/installdir "C:\Program Files\VDA" /components "VDA","CSA","PLUGINS"，用于将虚拟投递代理、思杰安全访问客户端、思杰 deviceTRUST、思杰 uberAgent 和 思杰 Workspace 应用程序安装到指定目录中。

注意：

在以下场景中，您可以在 VDA 安装、升级或卸载期间选择安装、升级或卸载 Citrix Workspace 应用程序和其他组件：

• 在 VDA 安装和升级到 2511 期间，您可以选择包含或排除组件和 CWA 插件。

  • 默认情况下，思杰工作区应用程序 (CWA)、思杰安全访问客户端 (CSA)、思杰用户个性化层 (UPL)（仅适用于 WS VDA） 和 思杰弹性应用分层 (CEAL)（仅适用于 TS VDA） 未安装。如果需要，您可以在安装期间选择它们。会话录制代理​ (SRAGENT) 和 ​​思杰助手应用程序 (ASSISTANTAPP)（仅适用于 WS VDA） 默认安装。如果需要，您可以在安装期间取消选择它们。

  • 思杰设备信任、思杰 uberAgent 和 思杰工作区环境管理™ 代理 现已与 VDA 集成并始终安装。使用 GUI 安装时，无法取消选择这些组件。

  • 默认情况下，Citrix Workspace Environment Management™ agent 在 Basic deployment 模式下运行，这是一种功能有限的单机模式，不连接到 WEM 基础结构。要通过将代理连接到 Citrix Cloud 中的 WEM 服务或本地部署来启用完整的 WEM 功能，请通过组策略配置设置。有关详细信息，请参阅这篇 WEM 文章。

  • 命令行更改

    /components VDA CSA : The command installs VDA and CSA (selected), and also Citrix Device Trust, Citrix uberAgent, and Citrix Workspace Environment Management agent (default integrated).

    /components VDA : The command installs VDA, and also Citrix Device Trust, Citrix uberAgent, and Citrix Workspace Environment Management agent as these are now integrated into the VDA itself. If you specify Citrix Device Trust, Citrix uberAgent, and Citrix Workspace Environment Management agent as arguments alongside the “/components” option, the VDA Meta-installer logs a notification indicating the removal of these arguments from the “/components” option. Subsequently, the VDA Meta-installer proceeds with the installation or upgrade of the VDA.

    /components：此命令是无效命令，它必须始终包含 VDA。可以根据需要添加其他组件进行安装。

    对默认集成组件使用 /exclude 命令：在 Citrix Virtual Apps and Desktops 2507 LTSR 中，/exclude 选项始终优先。它可用于阻止安装默认集成组件。示例：/exclude “Citrix 设备信任”、“Citrix 通用打印客户端”。此命令安装带有 Citrix Workspace Environment Management 代理的 VDA，但不安装 Citrix 设备信任和 Citrix 通用打印客户端。

• 在 VDA 升级期间，如果 VDA 中尚未安装 Citrix Workspace 应用程序、Citrix 安全访问客户端、Citrix 用户个性化层、会话录制代理、Citrix 助手应用程序和弹性应用程序分层，您可以选择安装它们。
• 在 VDA 升级期间，如果 Citrix Workspace app 的版本以及其他已安装的插件可以升级，则会显示升级它们的选项。
• 在安装或升级期间，如果 Citrix Workspace app (CWA) 插件或任何组件安装或升级失败，您可以通过选中复选框 “如果所选组件失败，则继续 VDA 升级或安装。” 来覆盖此失败并继续安装核心 VDA。
• 在 VDA 卸载期间，您可以选择是否卸载 Citrix Workspace app (CWA) 和任何其他已安装的组件。默认情况下，除 CWA 外的所有组件都会自动卸载。CWA 的处理方式不同，除非明确选择，否则不会将其删除。

• Citrix 用户个性化层： 安装用户个性化层的 MSI。有关详细信息，请参阅用户个性化层。

  此组件仅在单会话 Windows 10 计算机上安装 VDA 时显示。

  命令行选项：/includeadditional "User Personalization Layer" 用于启用组件安装，/exclude "User Personalization Layer" 用于阻止组件安装。

步骤 8. 交付控制器™ 地址

在 Delivery Controller 页面上，选择输入已安装 Controller 地址的方式。Citrix 建议您在安装 VDA 时指定地址（手动执行）。VDA 必须拥有此信息才能向 Controller 注册。如果 VDA 无法注册，用户将无法访问该 VDA 上的应用程序和桌面。

• 手动执行：（默认）输入已安装 Controller 的 FQDN，然后单击添加。如果您安装了多个 Controller，请添加它们的地址。
• 稍后执行（高级）： 如果选择此选项，向导会要求您在继续之前确认此操作。要稍后指定地址，可以重新运行安装程序或使用 Citrix 组策略。向导还会在摘要页面上提醒您。
• 从 Active Directory 中选择位置： 仅当计算机已加入域且用户是域用户时有效。
• 使用 Web 套接字令牌： 创建一个 Web 套接字 VDA。该 Web 套接字令牌用于所需的令牌。
• 让计算机创建服务自动执行： 仅在使用 MCS 预配计算机时有效。

单击下一步。如果您选择了稍后执行（高级），系统会提示您确认稍后指定 Controller 地址。

其他注意事项：

• 地址不能包含非字母数字字符。
• 如果您在 VDA 安装期间和组策略中指定地址，则策略设置将覆盖安装期间提供的设置。
• 成功的 VDA 注册要求用于与 Controller 通信的防火墙端口处于打开状态。此操作在向导的防火墙页面上默认启用。
• 指定 Controller 位置后（在 VDA 安装期间或之后），您可以使用自动更新功能在添加或删除 Controller 时更新 VDA。有关 VDA 如何发现和注册 Controller 的详细信息，请参阅VDA 注册。

命令行选项：/controllers

步骤 9. 代理配置

代理配置页面仅在您在附加组件页面上启用了代理配置复选框时显示。

1. 选择是通过代理地址还是 PAC 文件路径指定代理源。

2. 指定代理地址或 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. 查看必备条件并确认安装

“摘要”页面列出了将要安装的内容。使用“返回”按钮返回到之前的向导页面并更改选择。

准备就绪后，单击“安装”。

如果尚未安装或启用必备条件，计算机可能会重启一次或多次。请参阅准备安装。

注意：

此时，您还可以单击“摘要”页面上的“生成自定义脚本”按钮，以根据您当前的安装选择创建命令行脚本。此脚本可重复用于以无人参与模式安装或升级 VDA。

步骤 13. 诊断

在“诊断”页面上，选择是否参与 Citrix Call Home。如果您选择参与（默认），单击“连接”。出现提示时，输入您的 Citrix 帐户凭据。

凭据验证后（或者如果您选择不参与），单击“下一步”。

使用完整产品安装程序时，如果您在“诊断”页面上单击“连接”而未首先选择“收集诊断信息”，则关闭“连接到 Citrix Insight Services”对话框后，“下一步”按钮将禁用。您无法移动到下一页。要重新启用“下一步”按钮，请选择并立即取消选择“收集诊断信息”。

有关详细信息，请参阅 Call Home。

步骤 14. 完成此安装

“完成”页面包含所有已成功安装和初始化的必备项和组件的绿色复选标记。

单击“完成”。默认情况下，计算机将自动重新启动。尽管可以禁用此自动重新启动，但在计算机重新启动之前，VDA 无法使用。

后续步骤

如有需要，请重复上述步骤，在其他计算机或映像上安装 VDA。

安装所有 VDA 后，启动 Studio。如果您尚未创建站点，Studio 会自动引导您完成该任务。完成该任务后，Studio 会引导您创建计算机目录，然后创建交付组。请参阅：

• 创建站点
• 创建计算机目录
• 创建交付组

思杰优化器

Citrix 优化器是适用于 Windows 操作系统的工具，可通过删除和优化各种组件来帮助 Citrix 管理员优化 VDA。

安装 VDA 并完成最终重新启动后，下载并安装 Citrix 优化器。请参阅 CTX224676。CTX 文章包含下载包以及有关安装和使用 Citrix 优化器的说明。

自定义 VDA

要自定义已安装的 VDA：

1. 在 Windows 的“程序和功能”中，选择 Citrix 虚拟投递代理 或 Citrix 远程电脑访问/VDI 核心服务 VDA。然后右键单击并选择 更改。

2. 选择自定义 Virtual Delivery Agent 设置。安装程序启动后，您可以更改：

   • 控制器地址
   • 用于向 Controller 注册的 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 长期服务版本。