大网数据广告活动
启动与系统组件

Use the xray feature of TSS to identify known issues

· 52CE 我爱测

Introduces the xray feature of TSS. This feature is used to identify known issues.

xray (all lowercase) is a diagnostic framework-based PowerShell feature of the TroubleShootingScript (TSS) toolset. The xray feature scans for known issues during data collection and creates reports with issue information and solutions. The xray feature displays the reports on the screen and also saves the reports in the dataset in a .zip file created by the TSS tool.

The xray feature is a dynamic feature with new versions released every week. It constantly updates its diagnostics to identify new problems and removes outdated ones to enhance performance and reduce runtime. TSS prompts you to update automatically when you run it. Be sure to keep TSS updated to get the latest features and fixes from TSS and xray. Otherwise, you might not able to detect some issues that were recently added to xray.

An administrator or support professional can review the report files to check if a known issue occurs.

Download and run the xray feature

The xray feature can be downloaded as part of the TSS package.

When TSS is unzipped, there's an xray directory within the TSS directory.

You can also download xray as a standalone package by selecting this link.

The xray feature runs by default. All you need to do is open the report, read it, and then check if a known issue occurs.

We recommend that you run xray as part of TSS. If you want to run xray directly (separately from TSS), run the following command:

.\xray.ps1 -Area *

If you want to run it to look for a specific known issue, run the following command:

.\xray.ps1 -Diagnostic <diagnostic name>

Find the xray report

In the .zip file generated by TSS, or in the psSDP*.zip file within the TSS*.zip file, you can find these report files:

  • xray_ISSUES-FOUND_*.txt (known issue detected)
  • xray_INFO_*.txt (known issue with low impact detected)

Note: It also generates the following two log files that should be ignored. They're only used by the xray team to improve diagnostics.

  • xray_log_*.txt
  • xray_report_*.xml

Example scenario of using the xray report to resolve an issue

This section introduces an example xray report listing a known issue detected on a computer named DESKTOP_1234 and detailing how to resolve it. The filename is 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

In this report, the following text shows the issue:

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

The following text shows the cause of the issue:

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

The following text shows the resolution for the issue:

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

Source: Microsoft Learn / IT Pro troubleshooting by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / IT Pro troubleshooting
适用范围
- Supported versions of Windows Client · Source date 02/12/2026
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。