监控和故障排除 VUS

Last published : Oct 24, 2026
Related information
VDA 升级服务 (VUS)

监控计划的 VDA 升级

VDA 和计算机目录有两个属性，可帮助监控 VDA 升级的就绪情况和当前状态，这些属性在 Studio 中或 VDA 或目录的详细信息窗格中显示为可用于筛选的列。
  • VDA 升级
  • VDA 升级状态

VDA 升级

VDA 升级提供有关 VDA 或计算机目录是否已配置 VDA 升级代理以及 VDA 是否为最新版本或是否有可用升级的信息。可用状态如下：
VDA 升级 (Studio) VDA 升级 (Powershell) 描述
目录级别
未配置 缺少升级类型 尚未为计算机目录选择升级轨道（CR、LTSR、CR EAR 或 LTSR EAR）。
已计划 升级已计划 已为计算机目录计划升级。
可用 升级可用 目录中的 VDA 不在升级轨道的最新版本上。建议进行升级。
最新 最新 目录中的 VDA 位于升级轨道的最新版本。无需执行任何操作，或者没有支持 VDA 当前操作系统的可用升级目标。
未知 未知 正在检索最新的 VDA 升级状态。
计算机级别
未配置 缺少升级类型 尚未为 VDA 的计算机目录选择升级轨道（CR、LTSR、CR EAR 或 LTSR EAR）。
已计划 UpgradeScheduled 已为 VDA 安排了升级。
可用 UpgradeAvailable VDA 不在升级轨道的最新版本上。建议进行升级。
最新 UpToDate VDA 位于升级轨道的最新版本。无需执行任何操作，或者没有支持 VDA 当前操作系统的可用升级目标。
正在检查状态 未知 正在检索最新的 VDA 升级状态。
注意：
  • 对于使用 LTSR 轨道的 VDA，只有当 VDA 位于最新长期服务 (LTSR) 版本的最新累积更新 (CU) 上时，目录才会显示为“最新”。如果 VDA 位于以前的 LTSR 版本的最新 CU 上，VDA 升级仍将显示为“可用”。
  • 当没有可用的升级目标支持其当前操作系统时（例如，从 CVAD 2407 开始的 Windows Server 2016），VDA 也会显示为“最新”。此时，“升级 VDA 向导”不会为该 VDA 提供任何目标。要升级它，请将计算机重新映像到支持的操作系统，然后安排升级。请参阅目标版本的系统要求和 CTX224843。

VDA 升级状态

VDA 升级状态提供有关计划升级状态的信息。VDA 升级状态如下：
VDA 升级状态 (Studio) VDA 升级状态 (PowerShell) 描述
目录级别
未计划 NotScheduled 此目录未计划升级。
已计划 UpgradeScheduled 此目录已计划升级。
正在进行 UpgradeInProgress 此目录正在进行升级。
已取消 UpgradeCancelled 目录的升级已取消。这可能是由于手动取消或达到故障阈值。
失败 UpgradeFailed 目录的计划升级失败。
成功 UpgradeSuccessful 目录的计划升级已成功完成。注意：成功的升级并不意味着目录中的所有 VDA 都已成功升级。
- 空 目录未计划升级。
计算机级别
已计划 UpgradeScheduled VDA 已安排升级。
等待升级 UpgradeInUpgradeWindow 已安排的升级处于活动状态，但 VDA 尚未开始升级。有关 VDA 升级如何进行负载平衡的更多信息，请参阅“并发”。
进行中 UpgradeInProgress VDA 正在升级。
已取消 UpgradeCancelled VDA 的计划升级在开始之前已取消。
升级失败 UpgradeFailed VDA 已开始升级，但升级未能成功完成。有关更多信息，请参阅“故障排除”。
成功 UpgradeSuccess VDA 已成功升级。
验证失败 UpgradeValidationFailed 下载 VDA 安装程序的元数据时，证书验证失败。
- 空 未为 VDA 安排升级。

计划的 VDA 升级故障排除

如果遇到升级失败，以下日志可以帮助您识别和解决问题。您还可以与 Citrix 技术支持共享这些日志，以加快协助过程。

VDA 安装日志

排除升级失败故障时，请收集并查看 VDA 初始安装和失败升级的日志。安装和升级日志可在以下位置找到。
  • VDA 安装的安装日志位于：
    • %temp%/Citrix/XenDesktop 安装程序
  • VDA 安装的升级日志位于：
    • C:\Windows\Temp\Citrix\XenDesktop 安装程序 或
    • C:\Windows\SystemTemp\Citrix\XenDesktop 安装程序

VDA 升级代理版本

通过 VUS 收集数据以排查升级失败问题时，了解 VDA 上升级代理的版本非常重要。要检查 VDA 升级代理版本，请使用以下 cmdlet: Get-VusComponentVersion -ComponentType VUS。它会列出所有 VDA 及其 VDA 升级代理版本。
要在目录级别检查 VDA 升级代理版本，可以使用以下脚本：
注意：
此脚本仅供参考，可能需要根据您的特定环境进行调整。我们建议您在生产环境中使用此脚本之前对其进行彻底测试。
Param( [Parameter (Mandatory=$true)] [string] $CatalogName ) try { $Uuids = Get-BrokerMachine -CatalogName $CatalogName | Select-Object -Property UUID
if($Uuids -eq $null) { throw "Cannot find CatalogName " +$CatalogName } Write-Output("Catalog Name passed is "+$CatalogName)
foreach($Uuid in $Uuids) { $compVersion = Get-VusComponentVersion -MachineId $machine.UUID -ComponentType VUS $Machine = Get-BrokerMachine -UUID $compVersion.MachineId Write-Output(“MachineName: “+$Machine.MachineName+”, Machine UUID:”+$machine.MachineId+”, VUA Version:”+$compVersion.Version) } } catch { Write-Output(“Exception Occured”) Write-Host $_ }

与 VDA 升级代理相关的日志

VDA 升级代理 (VUA) 日志可以提供重要信息，用于排查升级失败以及 VUA 与 VDA 升级服务通信问题。您可以收集的日志包括：
  • Citrix 诊断工具 (CDF) 跟踪。CDF 模块名称为 VdaUpgradeAgent。
  • Windows 事件日志。在“事件查看器”>“Windows 日志”>“应用程序”>“Citrix VDA 升级代理服务”中查看日志。

对于 VUA 7.44 及更高版本

在 VDA 升级服务代理 7.44 版（包含在 2503 版本中）中，提供了一个注册表设置，允许管理员启用循环日志文件，该文件可捕获用于故障排除的关键信息，同时防止日志文件过大。日志文件总大小上限为 20 MB。创建以下注册表项以启用文件日志记录：
  • 键：
    New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\UpdateServices\UpdateAgent -Name LogToFile -Value 1 -PropertyType DWord -Force
  • 值名称： LogToFile
  • 值类型： REG_DWORD
  • 值数据：
    • 0 - 文件跟踪已禁用
    • 1 - 文件跟踪已启用
要在 VDA 上使用 PowerShell 创建 LogToFile 注册表项，请使用以下 cmdlet：
New-ItemProperty -Path HKLM:\SOFTWARE\Citrix\UpdateServices\UpdateAgent -Name LogToFile -Value 1 -PropertyType DWord -Force
若要大规模为计算机组启用 LogToFile，请考虑通过组策略首选项在所有 VDA 组织单位 (OU) 上创建 LogToFile 注册表。
注意：
  • 当 LogToFile=1 设置时，日志仅写入文件。它们不会出现在 CDF 跟踪中。
  • 注册表更改生效需要重新启动 VDA 升级代理服务
  • 日志文件在 C:\ProgramData\Citrix\Update Services\Logs 文件夹中创建

适用于 7.43 之前的 VUA 版本

如果需要，您可以修改 VDA 升级代理配置文件，以便日志持续写入文件。要启用日志记录到文件，请按照以下步骤操作：
  1. 转到文件夹 C:\Program Files\Citrix\CitrixUpgradeAgent。
  2. 打开文件 Citrix.UpdateServices.UpdateAgent.exe.config。
  3. 将 LogToFile 的值更改为 1。
  4. 重新启动 Citrix VDA 升级代理服务。这会在 C:\ProgramData\Citrix\Update Services\Logs 创建一个日志文件。
注意：
  • 通过 .config 文件启用日志记录到文件会持续写入日志，这可能会占用存储空间。请记住在问题解决后禁用日志记录。要禁用日志记录，请首先将 LogToFile 设置为 0，然后重新启动 Citrix VDA 升级代理服务。
  • 当 LogToFile=1 设置时，日志仅写入文件。它们不会出现在 CDF 跟踪中。

排查 VDA 升级下载失败问题

请按照以下步骤排查并解决与 VDA 升级功能相关的下载失败问题：
  1. 如果启用了 URL 过滤，请确保已将相关 URL 添加到允许列表中。请参阅 VDA 升级要求。
  2. 将必要的 URL 添加到允许列表后，请尝试重新安排 VDA 升级。
您可以启用 CDF 跟踪或将 LogToFile 设置为 1 以捕获详细日志进行分析。如果下载失败问题仍然存在，请检查错误。如果您看到以下错误消息“Download Failed: This access control list is not in canonical form and therefore cannot be modified”，则表示文件夹 C:\ProgramData\Citrix\UpgradeServices\Downloads\VDA 上的权限不正确。
要解决此问题，请执行以下任一操作：
  • 选项 1： 使用以下命令重置文件夹上的访问控制列表 (ACL)。(该命令使用所有匹配文件的默认继承 ACL 重置 ACL。)
    • icacls.exe "C:\ProgramData\Citrix\UpgradeServices\Downloads\VDA" /reset /T /C /L /Q
  • **选项 2：**删除 Downloads 文件夹下的 VDA 文件夹，然后安排 VDA 升级。

排查 VDA 升级验证失败

请按照以下步骤操作，以排查并解决与 VDA 升级功能相关的下载失败问题：
  1. 如果启用了 URL 过滤，请确保已将相关 URL 添加到允许列表中，特别是撤销检查所需的证书吊销列表 (CRL) 或在线证书状态协议 (OCSP) URL。请参阅 VDA 升级要求。
  2. 将必要的 URL 添加到允许列表后，请尝试重新安排 VDA 升级。
我们建议启用 CDF 跟踪或将 LogToFile 设置为 1 以捕获详细日志进行分析。日志可能包含以下错误：
  • RevocationStatusUnknown
  • 吊销功能无法检查证书的吊销状态。
  • 吊销功能无法检查吊销，因为吊销服务器处于脱机状态。
VDA 升级代理依赖 Windows 系统调用来验证证书并执行吊销检查。上述错误表明代理无法建立与 CRL 或 OCSP URL 的连接。
Windows CryptoAPI 目前不支持代理设置。请查阅具有代理配置的 VDA 部分，以配置 VDA 代理以方便出站 CRL 调用。