监视和故障排除

November 25, 2025

投稿者:

监视计划的 VDA 升级

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

VDA 升级
VDA 升级状态

VDA 升级

VDA 升级提供有关 VDA 或计算机目录是否配置了 VDA Upgrade Agent 以及 VDA 是否是最新的或者是否有可用升级的信息。可用的状态如下：

VDA 升级 (Studio)	VDA 升级 (PowerShell)	说明
目录级别
未配置	MissingUpgradeType	尚未为计算机目录选择升级途径（CR、LTSR、CR EAR 或 LTSR EAR）。
计划	UpgradeScheduled	已安排计算机目录的升级。
可用	UpgradeAvailable	目录中的 VDA 不包含在升级途径的最新版本中。建议升级。
最新	UpToDate	目录中的 VDA 包含在升级途径的最新版本中。无需任何操作。
未知	未知	检索最新的 VDA 升级状态。
计算机级别
未配置	MissingUpgradeType	尚未为 VDA 的计算机目录选择升级途径（CR、LTSR、CR EAR 或 LTSR EAR）。
计划	UpgradeScheduled	已安排 VDA 的升级。
可用	UpgradeAvailable	VDA 不包含在升级途径的最新版本中。建议升级。
最新	UpToDate	VDA 包含在升级途径的最新版本中。无需任何操作。
检查状态	未知	检索最新的 VDA 升级状态。

注意：

对于使用 LTSR 途径的 VDA，仅当 VDA 包含在最新长期服务 (LTSR) 版本的最新累积更新 (CU) 中时，目录才会显示为“最新”。如果 VDA 包含在早期 LTSR 版本的最新 CU 中，VDA 升级仍将显示为可用。

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 Installer
VDA 安装的升级日志位于以下位置：
- C:\Windows\Temp\Citrix\XenDesktop Installer 或
- C:\Windows\SystemTemp\Citrix\XenDesktop Installer

VDA Upgrade Agent 版本

通过 VUS 收集数据来排除升级故障时，了解 VDA 上的升级代理的版本非常重要。要检查 VDA Upgrade Agent 版本，请使用以下 cmdlet：Get-VusComponentVersion -ComponentType VUS。它列出了所有 VDA 及其 VDA Upgrade Agent 版本。

要在目录级别检查 VDA Upgrade Agent 版本，可以使用以下脚本：

注意：

该脚本仅作为示例，可能需要进行调整以适合您的特定环境。我们建议您在生产环境中使用该脚本之前对其进行彻底的测试。

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 Upgrade Agent 相关的日志

VDA Upgrade Agent (VUA) 日志可以为解决升级失败以及 VUA 与 VDA Upgrade Service 通信的问题提供重要信息。可以收集的日志包括：

Citrix Diagnostic Facility (CDF) 跟踪信息。 CDF 模块名称为 VdaUpgradeAgent。
Windows 事件日志。在事件查看器 > Windows 日志 > 应用程序 > Citrix VDA Upgrade Agent Service 中查看日志。

注册表设置可用来允许管理员启用捕获故障排除的关键信息的轮换日志文件，同时防止日志文件变得过大。日志文件的总大小上限为 20 MB。请创建以下注册表项以启用文件日志记录：

注册表项： HKLM\SOFTWARE\Citrix\UpdateServices\UpdateAgent\LogToFile
值名称： LogToFile
值类型： REG_DWORD
值数据：
- 0 - 文件跟踪已禁用
- 1 - 文件跟踪已启用

要使用 PowerShell 在 VDA 上创建 LogToFile 注册表项，请使用以下 cmdlet：

New-ItemProperty -Path HKLM\SOFTWARE\Citrix\UpdateServices\UpdateAgent\LogToFile -Name LogToFile -Value 1 -PropertyType DWord -Force

要为大规模计算机组启用 LogToFile，请考虑通过组策略首选项在所有 VDA 组织单位 (OU) 上创建 LogToFile 注册表。

注意：

设置了 LogToFile=1 时，日志仅写入文件。它们不会出现在 CDF 跟踪信息中。

对 VDA 升级下载失败问题进行故障排除

请按照以下步骤排除故障并解决与 VDA 升级功能相关的下载失败问题：

如果已设置 URL 筛选，请确保相关 URL 已添加到允许列表中。请参阅连接。
将必要的 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： 删除“下载”下的 VDA 文件夹，然后安排 VDA 升级。

对 VDA 升级验证失败问题进行故障排除

请按照以下步骤排除故障并解决与 VDA 升级功能相关的下载失败问题：

如果已设置 URL 筛选，请确保已将相关 URL 添加到允许列表中，尤其是吊销检查所需的证书吊销列表 (CRL) 或联机证书状态协议 (OCSP) URL。请参阅 VDA 升级要求。
将必要的 URL 添加到允许列表中后，尝试重新安排 VDA 升级。

我们建议启用 CDF 跟踪或者将 LogToFile 设置为 1 以捕获详细日志进行分析。日志可能包含以下错误：

RevocationStatusUnknown
吊销功能无法检查证书的吊销状态。
由于吊销服务器处于脱机状态，吊销功能无法检查吊销。

VDA Upgrade Agent 依靠 Windows 系统调用来验证证书并执行吊销检查。上述错误表明代理无法与 CRL 或 OCSP URL 建立连接。

Windows CryptoAPI 目前不支持代理设置。请查看具有代理配置的 VDA 部分，以配置您的 VDA 代理来促进出站 CRL 调用。

本内容的正式版本为英文版。部分 Cloud Software Group 文档内容采用了机器翻译，仅供您参考。Cloud Software Group 无法控制机器翻译的内容，这些内容可能包含错误、不准确或不合适的语言。对于从英文原文翻译成任何其他语言的内容的准确性、可靠性、适用性或正确性，或者您的 Cloud Software Group 产品或服务沿用了任何机器翻译的内容，我们均不作任何明示或暗示的保证，并且适用的最终用户许可协议或服务条款或者与 Cloud Software Group 签订的任何其他协议（产品或服务与已进行机器翻译的任何文档保持一致）下的任何保证均不适用。对于因使用机器翻译的内容而引起的任何损害或问题，Cloud Software Group 不承担任何责任。

这是否有帮助？

监视和故障排除

November 25, 2025

投稿者:

November 25, 2025

投稿者:

这是否有帮助？