安装 VDA

重要提示：

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

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

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

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

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

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

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

1. 如果您尚未下载产品 ISO：
   • Use your Citrix account credentials to access the Citrix Virtual Apps and Desktops™ download page. Download the product ISO file.
   • 解压缩文件。或者，将 ISO 文件刻录到 DVD。

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

   安装向导随即启动。

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

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

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

组件安装程序中的“组件选择”页面(/zh-cn/citrix-virtual-apps-desktops/2507-ltsr/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_2507.exe：多会话操作系统 VDA 版本
   • VDAWorkstationSetup_2507.exe：单会话操作系统 VDA 版本
   • VDAWorkstationCoreSetup_2507.exe：单会话操作系统核心服务 VDA 版本
   • VDASingleSessionCoreSetup_2507.exe：新单会话操作系统核心服务 VDA 版本（适用于 2507 CU1 及更高版本）

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

   安装向导随即启动。

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

在环境页面上，指定您计划如何使用 VDA，指示您是否将此计算机用作预配更多计算机的映像。

您选择的选项会影响自动安装哪些 Citrix Provisioning™ 工具（如果有），以及 VDA 安装程序“附加组件”页面上的默认值。

安装 VDA 时，会自动安装多个 MSI（预配和其他）。阻止其安装的唯一方法是在命令行安装中使用 /exclude 选项。

选择以下选项之一：

• 创建主 MCS 映像： 如果您计划使用 Machine Creation Services™ 预配 VM，请选择此选项以在 VM 映像上安装 VDA。此选项将安装 Machine Identity Service。这是默认选项。

  命令行选项：/mastermcsimage 或 /masterimage

重要：

安装介质或 ISO 映像必须在本地装载。不支持从网络驱动器装载 ISO 映像以安装软件。

• 使用 Citrix Provisioning 或第三方预配工具创建主映像： 如果您计划使用 Citrix Provisioning 或第三方预配工具（例如 Microsoft System Center Configuration Manager）来预配虚拟机，请选择此选项以在虚拟机映像上安装 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/2507-ltsr/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 配置文件管理服务。无需启用此服务。

  命令行选项：/includeadditional "Citrix Profile Management" 用于启用组件安装，/exclude "Citrix Profile Management" 用于阻止组件安装。

• Citrix 配置文件管理 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 service）部署。使 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 软件。

The Citrix Workspace™ App and Citrix Secure Access™ Client have been moved from the Component page to the Optional Software page.

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

在“可选软件”页面上：

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

单击“下一步”。

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

注意：

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

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

  • 默认情况下，不安装 Citrix Workspace 应用程序 (CWA)、Citrix 安全访问客户端 (CSA) 和 Citrix 用户个性化层 (UPL)。如果需要，您可以在安装期间选择它们。

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

  • 默认情况下，Citrix Workspace Environment Management™ 代理 在基本部署（一种功能有限的单机模式，不连接到 WEM 基础结构）中运行。要通过将代理连接到 Citrix Cloud 中的 WEM 服务或本地部署来启用完整的 WEM 功能，请通过组策略配置设置。有关详细信息，请参阅(/zh-cn/workspace-environment-management/service/get-started/install-and-configure#step-2-configure-group-policies-optional)这篇 WEM 文章。

  • 命令行更改

    /components VDA CSA : 此命令安装 VDA 和 CSA（已选择），以及 思杰设备信任、思杰 uberAgent 和 思杰工作区环境管理代理（默认集成）。

    /components VDA : 此命令安装 VDA，以及 思杰设备信任、思杰 uberAgent 和 思杰工作区环境管理代理，因为它们现在已集成到 VDA 本身中。如果您将 思杰设备信任、思杰 uberAgent 和 思杰工作区环境管理代理 指定为“/components”选项的参数，VDA Meta-installer 将记录一条通知，指示从“/components”选项中删除这些参数。随后，VDA Meta-installer 将继续安装或升级 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 用户个性化层，您可以选择安装它们。
• 在 VDA 升级期间，如果 Citrix Workspace 应用程序和其他已安装插件的版本可以升级，则会显示升级它们的选项。
• 在安装或升级期间，如果 Citrix Workspace 应用程序 (CWA) 插件或任何组件安装或升级失败，您可以通过选中“如果所选组件失败，则继续 VDA 升级或安装。”复选框来覆盖失败并继续安装核心 VDA。
• 在 VDA 卸载期间，您可以选择是否卸载 Citrix Workspace 应用程序 (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。WebSocketToken 用于所需的令牌。
• 让 机器创建服务 自动执行： 仅在使用 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. 检查必备项并确认安装

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

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

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

步骤 13. 诊断

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

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

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

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

步骤 14. 完成此安装

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

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

后续步骤

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

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

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

思杰优化器

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

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

自定义 VDA

要自定义已安装的 VDA：

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

2. 选择“自定义 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 长期服务版本。