使用 TSS 的 xray 功能识别已知问题

xray (全部小写)是一项基于诊断框架的 PowerShell 功能,适用于 TroubleShootingScript (TSS) 工具集。 xray 功能在数据收集过程中扫描已知问题,并创建包含问题信息和解决方案的报告。 xray 功能在屏幕上显示报表,并将报表保存在 TSS 工具创建的.zip文件中。

xray 功能是每周发布的新版本的动态功能。 它不断更新其诊断,以识别新问题并删除过时的问题,以提高性能和减少运行时。 TSS 会在运行 TSS 时提示你自动更新。 请务必使 TSS 保持更新,以便从 TSS 和 xray 获取最新功能和修补程序。 否则,可能无法检测到最近添加到 xray 中的一些问题。

管理员或支持专业人员可以查看报告文件,以检查是否存在已知问题。

下载并运行 xray 功能

xray 功能可以作为 TSS 包一部分下载。

解压缩 TSS 时,TSS 目录中有一个 xray 目录。

也可以通过选择此 链接将 xray 下载为独立包。

默认情况下,xray 功能运行。 只需打开报表、读取报表,然后检查是否存在已知问题。

建议将 xray 作为 TSS 的一部分运行。 如果要直接运行 xray(独立于 TSS),请运行以下命令:

.\xray.ps1 -Area *

如果要运行它来查找特定的已知问题,请运行以下命令:

.\xray.ps1 -Diagnostic <diagnostic name>

查找 xray 报表

在 TSS 生成的.zip文件中,或在 TSS*.zip 文件中的 psSDP*.zip 文件中,可以找到以下报告文件:

  • xray_ISSUES-FOUND_*.txt (检测到已知问题)
  • xray_INFO_*.txt (检测到低影响已知问题)

注意

它还生成以下两个应忽略的日志文件。 它们仅由 xray 团队用来改进诊断。

  • xray_log_*.txt
  • xray_report_*.xml

使用 xray 报表解决问题的示例方案

本部分介绍一个示例 xray 报告,其中列出了在名为DESKTOP_1234的计算机上检测到的已知问题,并详细介绍了如何解决该问题。 文件名为 xray_ISSUES-FOUND_231026-144320_ DESKTOP_1234.txt

xray, v1.0.231018.0
Diagnostic check run on 231026-144320 UTC

**
** Issue 1	Found a potential issue (reported by net_smbcli_KB5027830):
**
Workstation Service is not running, this will prevent you from being able to connect to SMB shares.

This is most likely caused by the missing ComputerName value in registry:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\ComputerName\ActiveComputerName

Please check this registry key and restore the missing ComnputerName value.

Example:
reg add HKLM\SYSTEM\CurrentControlSet\Control\ComputerName\ActiveComputerName /t REG_SZ /v ComputerName /d YourComputerName /f

在此报告中,以下文本显示问题:

Workstation Service is not running, this will prevent you from being able to connect to SMB shares.

以下文本显示了问题的原因:

This is most likely caused by the missing ComputerName value in registry:
 
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\ComputerName\ActiveComputerName

以下文本显示了问题的解决方法:

Please check this registry key and restore the missing ComnputerName value.

Example:
reg add HKLM\SYSTEM\CurrentControlSet\Control\ComputerName\ActiveComputerName /t REG_SZ /v ComputerName /d YourComputerName /f