xray (すべて小文字) は、 TroubleShootingScript (TSS) ツールセットの診断フレームワークベースの PowerShell 機能です。 xray 機能は、データ収集中に既知の問題をスキャンし、問題情報と解決策を含むレポートを作成します。 xray 機能は、画面にレポートを表示し、レポートをデータセット内の TSS ツールによって作成された.zip ファイルに保存します。
xray 機能は、毎週リリースされる新しいバージョンを備えた動的な機能です。 診断を絶えず更新して新しい問題を特定し、古い問題を削除してパフォーマンスを向上させ、ランタイムを削減します。 TSS では、実行時に自動的に更新するように求められます。 TSS と xray から最新の機能と修正プログラムを入手するには、必ず TSS を更新してください。 そうしないと、最近 xray に追加された問題を検出できない場合があります。
管理者またはサポート担当者は、レポート ファイルを確認して、既知の問題が発生したかどうかを確認できます。
xray 機能をダウンロードして実行する
xray 機能は、 TSS パッケージの一部としてダウンロードできます。
TSS が解凍されると、TSS ディレクトリ内に xray ディレクトリがあります。
この リンクを選択して、スタンドアロン パッケージとして xray をダウンロードすることもできます。
xray 機能は既定で実行されます。 必要なのは、レポートを開いて読み、既知の問題が発生したかどうかを確認するだけです。
TSS の一部として xray を実行することをお勧めします。 xray を直接 (TSS とは別に) 実行する場合は、次のコマンドを実行します。
.\xray.ps1 -Area *
特定の既知の問題を探すために実行する場合は、次のコマンドを実行します。
.\xray.ps1 -Diagnostic <diagnostic name>
xray レポートを検索する
TSS によって生成された.zip ファイル、または TSS*.zip ファイル内の psSDP*.zip ファイルには、次のレポート ファイルがあります。
- xray_ISSUES-FOUND_*.txt (既知の問題が検出されました)
- xray_INFO_*.txt (影響が少ない既知の問題が検出されました)
Note
また、無視する必要がある次の 2 つのログ ファイルも生成されます。 これらは、xray チームが診断を改善するためにのみ使用されます。
- xray_log_*.txt
- xray_report_*.xml
xray レポートを使用して問題を解決するシナリオの例
このセクションでは、DESKTOP_1234という名前のコンピューターで検出された既知の問題を一覧表示する xray レポートの例と、その解決方法について詳しく説明します。 ファイル名は 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