产品文档
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
查看 PDF

使用 VDA Upgrade Service 升级 VDA

November 25, 2025
投稿者: 
C

可以通过 VDA Upgrade Service 启动 VDA 升级，方法是选择目标计算机目录、单个计算机或计算机组，然后选择“升级 VDA”。

注意：

Citrix® 建议在执行升级之前尽可能备份 VDA。

安排升级

Citrix 中的 VDA 升级过程可以根据要求在目录级别、计算机组级别或单个计算机级别进行。 升级可以设置为立即开始，也可以最多提前 7 天安排日期和时间。

注意事项

  • 目录与计算机组与计算机作用域： 目录升级非常适合批量更新，而单独或按组升级计算机可以实现更精细的控制。

  • 安排： 升级最多可提前 7 天安排。 如果使用计算机目录级别升级，则在计划升级后添加到目录中的计算机将不作为现有计划升级的一部分包括在内。

主要区别

功能 每目录升级 每计算机升级 计算机组
升级范围 整个目录 单台计算机 计算机目录中的计算机组
计划控制 单一计划适用于计算机目录中的所有 VDA，最适合大规模升级操作 VDA 是单独安排的，主要用于测试和一次性升级 VDA 按组进行安排，让您可以灵活地在不同时间升级不同组的 VDA
管理 通过 Web Studio 中的计算机目录节点或 New-VusCatalogSchedule cmdlet 进行管理 通过 Web Studio 中的“搜索”节点或 New-VusMachineUpgrade cmdlet 进行管理 通过 Web Studio 中的“搜索”节点进行管理，或者通过将计算机列表传递给 New-VusMachineUpgrade cmdlet
用例 整个计算机目录的批量升级 针对目标升级和测试场景的精细控制 针对 VDA 子集进行有针对性的控制。 可用于错开目录中的升级
可用的 VDA 版本 对于 CR 和所有当前支持的 LTSR VDA 版本，可以升级到最新版本以及之前的 2 个版本 (N-2)。 有关详细信息，请参阅可用的 VDA 版本 对于 CR 和所有当前支持的 LTSR VDA 版本，可以升级到最新版本以及之前的 2 个版本 (N-2)。 有关详细信息，请参阅可用的 VDA 版本 仅可升级最新的 LTSR 或 CR VDA 版本
附加组件 在每个 VDA 上安装或升级 VDA 组件。 不选中某个组件将不会卸载该功能，但不会升级该组件 在 VDA 上安装或升级 VDA 组件。 不选中某个组件将不会卸载该功能，但不会升级该组件 升级一组计算机时，VDA Upgrade Service 无法管理附加组件。 注意：其他功能（例如“启用还原清理”）可用于计算机组升级
附加功能 可以启用或升级附加功能 可以启用或升级附加功能 可以启用或升级附加功能
并发 在安排升级时作为设置进行控制。 有关详细信息，请参阅并发 单个 VDA 已升级 根据升级计划中选择的 VDA 数量自动实现负载平衡
故障阈值 如果一定数量的 VDA 升级失败，则可以设置失败阈值来阻止将来的升级。 有关详细信息，请参阅故障阈值 故障阈值不适用于每计算机升级 故障阈值不适用于计算机组升级。 请考虑将要升级的计算机组的大小设置为可接受的故障量的最大 VDA 数量

计划升级的工作原理

VDA 上的 VDA Upgrade Agent 定期与 Delivery Controller 通信以确定是否应升级 VDA。 可以安排 VDA 立即升级或最多提前 7 天升级。 安排提前升级时，可以设置升级开始的日期和时间 (UTC)。

升级持续时间设置计划升级开始时间之后进行升级的时间长度。 默认情况下，对于计算机目录和计算机组升级，Citrix 会在整个升级期间平衡 VDA 升级负载，以提高性能并避免瓶颈。

一旦升级开始，VDA 将进入维护模式，直到升级完成。 如果 VDA 上存在会话，则 VDA 将不升级，直到不存在会话为止。 当 VDA 处于维护模式时，无法为其代理任何新会话。 如果用户在升级窗口期间断开会话连接，则用户将无法重新连接，直到升级完成。

VDA 将继续尝试升级，直到计划升级持续时间完成。 如果在升级期间存在会话，则将取消升级，并且将关闭 VDA 的维护模式。 请考虑延长升级时间以提高 VDA 升级成功率。

注意：

在计划升级之前手动置于维护模式的 VDA 将无法升级。

可用的 VDA 版本

VDA Upgrade Service 为 CR 版本维护 VDA 的 N-2 个版本，为当前支持的所有 LTSR 版本维护 VDA 的 N-2 个 CU 版本。

发布了新 CVAD 版本时，您可以更新 VUS 以包含更新的 VDA 版本，而无需更新整个站点。 VUS 使用 vda_releases.xml 文件来填充可用的 VDA 版本。 vda_releases.xmld 文件可在 CVAD Metainstaller 中的以下位置找到：

<CVAD-ISO>\Support\VdaUpdateServiceMetadata\vda_releases.xml

要将较新的 vda_releases.xml 文件导入 VUS，请运行以下 cmdlet： Import-VusVdaReleasesMetadata -Path '[Path to vda_releases.xml]'

在 Web Studio 中，升级目录或单个计算机时，用户界面会提示您要将 VDA 升级到的版本。

VUS1

要使用 PowerShell 确定可用的 VDA 版本，请使用 Get-VusAvailableVdaVersion cmdlet。

cmdlet 将返回所有升级途径的最新可用版本，无需通过 cmdlet 传递计算机或目录。

要获取资源可用的特定版本，请使用 Get-VusAvailableVdaVersion cmdlet 传递 VDA（-MachineName、-MachineUid 或 -MachineUuid）或目录（-CatalogName、-CatalogUid 或 -CatalogUuid）。

例如： Get-VusAvailableVdaVersion -CatalogName '[您的机器目录名称]'

VUS2

附加组件

按计算机目录或单台计算机升级 VDA 时，可以安装或升级附加组件。 如果不选中某个组件，则不会卸载该组件，但该组件不会作为整体 VDA 升级的一部分进行升级。

VUS3

功能

可以通过 VDA Upgrade Service 在 VDA 上启用或升级功能。 如果不选中某个功能，则不会禁用该功能，但该功能不会作为整体 VDA 升级的一部分进行升级。

默认情况下，启用还原清理复选框处于选中状态。 Citrix 建议启用还原清理功能，以简化管理并改进失败升级的恢复。 启用该功能后，将在升级开始之前创建系统还原点。 如果升级失败，VDA 将还原到系统还原点。 成功安装 VDA 后，将删除还原点。 有关详细信息，请参阅安装或升级失败时还原。

VUS4

注意：

Windows 系统还原仅支持单会话操作系统（例如 Windows 10 和 11）。 必须在 VDA 上启用 Windows 系统还原功能才能使“启用还原清理”功能正常运行。 如果选择“启用还原”或“启用还原清理”，但 VDA 上未配置 Windows 系统还原，升级可能会失败。

并发

升级计算机目录时，VUS 允许您定义同时升级的 VDA 的最大数量。 这有助于减少您的 Internet 连接或文件服务器的负载，并且当与故障阈值结合使用时，如果多个 VDA 升级失败，您可以停止升级。

计划升级开始后，目录中的所有 VDA 都将处于维护模式。 升级将在与定义的最大并发设置相匹配的一定数量的 VDA 上开始进行。 一旦一个 VDA 升级完成，另一个 VDA 将开始升级，以维持同时升级的 VDA 数量。

如果没有为计算机目录计划升级指定并发，Citrix 将根据目录中的 VDA 总数和升级持续时间使用默认并发值。

升级平均需要大约 30 分钟才能完成，但这会根据环境条件而有很大差异。 请考虑将并发数设置为所有 VDA 都可以在提供的升级持续时间内升级的数量。 例如，如果您有 20 个 VDA 设置为在 4 小时内升级，则需要 5 个 VDA 升级一小时。 使用 30 分钟的平均升级持续时间，可以将并发值设置为 3，以满足每小时 5 次 VDA 升级的要求（每 30 分钟升级 3 次，则每小时更新 6 次）。

故障阈值

升级计算机目录时，如果一定数量的 VDA 发生故障，请使用故障阈值来防止升级其他 VDA。 故障阈值可以减少导致升级失败的问题的影响半径，从而减少管理员的故障排除工作量。

故障阈值会阻止任何将来的 VDA 开始升级，但不会停止已经开始升级的 VDA。 例如，如果计算机目录中包含 100 个 VDA，并发数设置为 10 个 VDA，故障阈值设置为 3，则如果所有 VDA 升级都失败，至少有 13 个 VDA 将尝试升级，其余 87 个 VDA 将永远不会启动，升级将取消。

10 个并发 VDA 在计划升级开始时开始升级，如果第一个升级失败，另一个 VDA 将开始升级，以维持 10 个并发同时升级。 如果第二个升级失败，另一个 VDA 将开始升级。 如果第三个升级失败，则当前处于升级过程中的所有 VDA 都将继续，而升级计划中的其余 VDA 的升级将取消。

VDA 安装程序位置

VDA 安装程序必须托管在您环境中的本地文件共享上。 文件共享和 VDA 安装程序的要求如下所列：

文件共享必须满足以下必备条件。

  • 文件共享权限
    • 包含 VDA 安装程序软件包的网络共享必须对作为本地系统（NT AUTHORITY\SYSTEM 主体）运行的 VDA Upgrade Agent 服务具有读取权限。
    • 已加入域的 VDA：
      • 本地系统帐户（VUA 作为本地系统运行）在访问网络共享时使用计算机凭据。
      • 必须授予域计算机对文件共享的读取权限。
      • 在高级共享设置中，必须启用文件和打印机共享。
    • 未加入域的 VDA：
      • 本地系统帐户（VUA 作为本地系统运行）在访问网络共享时使用匿名登录。
      • 在网络和共享中心中，必须禁用“密码保护共享”。
      • 在文件夹权限安全选项卡中，必须向匿名登录授予读取访问权限。
      • 在高级共享设置中，必须启用文件和打印机共享。
      • 必须将共享文件夹名称添加到 Network Access Security Policy（网络访问安全策略）中。
  • VDA 安装程序
    • 必须从 Citrix 下载 Web 站点下载 VDA 安装程序并将其放置在文件共享中。
    • 必须下载计算机目录的相关 VDA 安装程序。
      • 如果目录类型是多会话，请使用多会话操作系统 VDA 安装程序。
      • 如果目录类型是单会话，请使用单会话操作系统 VDA 安装程序。
    • 对于指定的升级，文件共享上的安装程序版本必须与 VUS 发布的版本完全匹配。 使用 Get-VusAvailableVersion PowerShell cmdlet 确定可用的版本。

安装程序的路径应为包含可执行文件的文件路径。 例如，\\hostname\VDA-Packages\VDAWorkstationSetup_2308.exe。

VUS5

通过 PowerShell 使用 VUS 时，请在计划升级时使用 -VdaWorkstationPackageUri（单会话操作系统）或 -VdaServerPackageUri（多会话操作系统）参数。

强制注销会话

为了增加计划升级期间可供升级的 VDA 数量，请考虑在升级过程中强制注销用户会话。 强制注销发生在每个单独的 VDA 开始升级时，而不是在整个计划升级窗口期间开始时。

由于不同的 VDA 在计划期间内开始升级的时间不同，因此只有当特定 VDA 开始升级时，才会注销用户。

要使用 Web Studio 强制注销计划升级期间断开连接的会话，请选择注销断开连接的会话选项。

要使用 Web Studio 进行计划升级期间强制注销活动会话，请选择注销活动会话选项。 如果注销活动会话，用户将在升级开始前 10 分钟在其会话中收到通知，提醒其在自动注销之前保存工作。

VUS6

要使用 PowerShell 在计划升级期间强制注销断开连接的会话，请在计划升级时使用 -LogoffOption 参数。 -LogoffOption 可用的选项如下所示：

  • ActiveSessionsOnly： 如果在计划升级窗口期间 VDA 上存在活动会话，则将注销用户。 用户注销前 10 分钟将显示横幅以发出警告。 会话断开连接的 VDA 在升级窗口期间将不会注销。 如果断开连接的会话在整个升级窗口期间仍然存在，则将取消该 VDA 升级。
  • DisconnectedSessionsOnly： 如果在计划升级窗口期间 VDA 上存在断开连接的会话，则将注销用户。 用户不会收到有关其断开连接的会话将注销的通知。 在升级窗口期间，将不注销具有活动会话的 VDA。 如果活动会话在整个升级窗口期间保持，则将取消该 VDA 升级。
  • ActiveAndDisconnectedSessions： 如果在计划升级窗口期间 VDA 上存在断开连接的会话或活动会话，则将注销用户。 对于活动会话，横幅将在用户注销前 10 分钟显示以发出警告。
  • DoNotLogoff： 不会注销活动会话和断开连接的会话。 如果在升级计划的整个持续时间内 VDA 上都存在会话，则升级将在计划升级窗口结束时取消。

如果可能，Citrix 建议强制注销会话以增加成功升级的 VDA 数量。

重要：

强制注销会话可能会导致用户丢失会话中未保存的工作。

编辑或取消 VDA 工作流程

安排目录升级后，可以编辑升级的开始时间和持续时间，或者完全取消升级。

要使用计算机目录级别的 UI 编辑或取消升级，请右键单击具有现有计划升级的计算机目录，然后单击编辑计划的 VDA 升级。 要使用 PowerShell 编辑现有的计算机目录级别升级，请使用 Set-VusCatalogUpgrade 和 Remove-VusCatalogUpgrade cmdlet。

要在计算机级别编辑或取消升级，请在“搜索”节点中右键单击具有现有计划升级的计算机，然后单击编辑计划的 VDA 升级。 不能同时编辑多台计算机的计划 VDA 升级。 要使用 PowerShell 编辑现有的计算机级升级，请使用 Set-VusMachineUpgrade 和 Remove-VusMachineUpgrade cmdlet。

使用 VDA Upgrade Service 升级 VDA
November 25, 2025
投稿者: 
C
November 25, 2025
投稿者: 
C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.