次の方法で共有

PowerShell 用診断データ ビューアーの概要

適用対象

  • Windows 11 バージョン 21H2 以降
  • Windows 10 バージョン 1803 以降
  • Windows Server バージョン 1803
  • Windows Server 2019

PowerShell 用診断データ ビューアーは、デバイスから Microsoft に送信される診断データを確認できる PowerShell モジュールです。送信されるデータは、Microsoft がデータを使用する方法に基づいて、わかりやすいカテゴリに分類されます。

注

この PowerShell モジュールを使用するには、そのデバイスの管理者特権が必要です。

PowerShell 用診断データ ビューアーのインストール

PowerShell 用診断データ ビューアーを使用するには、先にモジュールをインストールしておく必要があります。

管理者特権の PowerShell セッションを開く

PowerShell の診断データ ビューアーを使うには、管理者 (昇格された) 特権を管理する必要があります。 管理者特権の PowerShell プロンプトを開く方法は 2 つあります。 いずれかの方法を使うことができます。

  • [Start]>[Windows PowerShell]>[管理者として実行] に移動します。
  • [スタート]>コマンド プロンプト>[管理者として実行]に移動し、コマンドC:\> powershell.exeを実行

PowerShell 用診断データ ビューアーのインストール

ヒント

PowerShell モジュールのインストールの詳細については、「PowerShell ギャラリーの概要」を参照してください。

診断データ ビューアー PowerShell モジュールの最新バージョンをインストールするには、管理者特権の PowerShell セッション内で次のコマンドを実行します。

PS C:\> Install-Module -Name Microsoft.DiagnosticDataViewer

モジュールの詳細については、PowerShell ギャラリーの Microsoft.DiagnosticDataViewer ページを参照してください。

データ表示の有効化

このツールを使用するには、データ表示を有効にしておく必要があります。 データ表示が有効であれば、無効にするまでの間、デバイスの診断データのローカル履歴を Windows に保存し、確認できます。

この設定では、デバイスから診断データを送信するかどうかについては制御されません。 この設定では、送信された診断データのローカル コピーを確認用に Windows デバイスに保存するかどうかを制御します。

データ表示を有効にすると、その時点以降、Microsoft に送信された診断データの履歴は、デバイスに保存されます。

重要

データ表示を有効にすると、システム ドライブで最大 1 GB (既定の設定) のディスク領域が使用されます。 診断データ ビューアーの使用が終わったら、データ表示を無効にするようお勧めします。 データ表示を無効にする方法については、この記事で後述する「データ表示の無効化」セクションを参照してください。

[設定] ページでデータを表示を有効にするには

  1. [スタート] に移動し、[設定]>[プライバシーとセキュリティ]>[診断とフィードバック] の順に選択します。

  2. [診断データの表示] で、[診断データ ビューアーを有効にする] オプションをオンにします。

PowerShell 使ってデータ表示を有効にするには

管理者特権の PowerShell セッション内で次のコマンドを実行します。

PS C:\> Enable-DiagnosticDataViewing

PowerShell 用の診断データ ビューアーの使用を開始する

コマンドレットの使用方法、コマンドレットに渡すパラメーター、使用例を確認するには、管理者特権の PowerShell セッションで次のコマンドを実行します。

PS C:\> Get-Help Get-DiagnosticData

診断データの表示を開始するには、管理者特権の PowerShell セッションから次のコマンドを実行します。

PS C:\> Get-DiagnosticData

イベントの数が多い場合は、Ctrl+C キーを押してコマンドを停止します。

注

データ表示を最近有効にした場合は、上のコマンドを実行しても結果のデータがまったく生成されないか、ほとんど生成されないことがあります。 Windows デバイスから送信された診断データを表示するには、数分かかることもあります。

PowerShell 用診断データ ビューアーの操作

PowerShell 用診断データ ビューアーには、デバイスの診断データを表示およびフィルター処理するための次の機能があります。 このモジュールと共に、他の豊富な PowerShell ツールも使用できます。

ヒント

使用できる PowerShell コマンドの詳細については、「Microsoft.DiagnosticDataViewer モジュールのドキュメント」を参照してください。

診断イベントを表示する

PS C:\> Get-DiagnosticData を実行して、診断イベントを確認できます。 これらのイベントは、デバイスで発生して Microsoft に送信されたアクティビティを反映しています。

各イベントは、PowerShell オブジェクトとして表示されます。 各イベントについて、既定で表示される情報は、イベント名、Windows デバイスによって認識された時刻、イベントのデータ診断レベルが [必須] かどうか、イベントの診断イベント カテゴリ、イベントに含まれる情報の詳細な JSON ビューです。このビューでは、Microsoft に送信された時点とまったく同じようにイベントが表示されます。 Microsoft はこの情報を使用して、Windows オペレーティングシステムを継続的に改善しています。

診断イベント カテゴリを表示する

各イベントには、対応する診断イベント カテゴリが示されます。 これらのカテゴリでは、Microsoft によってイベントがどのように使用されるかが定義されます。 カテゴリは、数値識別子として表示されます。

各数値識別子で表された診断カテゴリと、そのカテゴリの意味を確認するには、次のコマンドを実行します。

PS C:\> Get-DiagnosticDataTypes

送信時刻によってイベントをフィルター処理する

各コマンドの開始時刻および終了時刻を指定することで、指定した時間範囲内のイベントを表示できます。 たとえば、12 時間前から 6 時間前までの間に送信されたすべての診断データを表示するには、次のコマンドを実行します。 データは古い方から順に表示されます。

PS C:\> Get-DiagnosticData -StartTime (Get-Date).AddHours(-12) -EndTime (Get-Date).AddHours(-6)

各コマンドの結果をエクスポートする

パイプ | を使用すると、各コマンドの結果を csv などの別ファイルにエクスポートできます。 以下に例を示します。

PS C:\> Get-DiagnosticData | Export-Csv 'mydata.csv'

データ表示の無効化

診断データの確認が終わったら、メモリの消費を回避するためにデータ表示を無効にしておくことをお勧めします。 データ表示を無効にすると、Windows による診断データの履歴保存が停止し、デバイスから既存の診断データ履歴が消去されます。

[設定] ページでデータを表示を無効にするには

  1. [スタート] に移動し、[設定]>[プライバシーとセキュリティ]>[診断とフィードバック] の順に選択します。

  2. [診断データの表示] で、[データの表示が有効になっている場合は、診断データを表示できます] オプションをオフにします。

PowerShell 使ってデータ表示を無効にするには

管理者特権の PowerShell セッション内で次のコマンドを実行します。

PS C:\> Disable-DiagnosticDataViewing

データ履歴のサイズ変更

既定では、ツールは最大で 1 GB または 30 日間のデータを表示します (どちらか早い方)。 時間または領域の制限に達すると、データは古いデータ ポイントから段階的に削除されます。

データ履歴のサイズを変更する

重要

  • ツールで表示可能な診断データの最大量を変更すると、コンピューターのパフォーマンスに影響することがあります。
  • データ履歴の最大サイズを小さくする場合は、ディスク領域を解放するために、データ表示を無効にしてからもう一度有効にする必要があります。

表示可能なデータ履歴の最大サイズ (メガバイト単位) は変更できます。 たとえば、データ履歴の最大サイズを 2,048 MB (2 GB) に設定するには、次のコマンドを実行します。

PS C:\> Set-DiagnosticStoreCapacity -Size 2048

表示可能なデータ履歴の最大時間数 (時間単位) は変更できます。 たとえば、データ履歴の最大時間数を 24 時間に設定するには、次のコマンドを実行します。

PS C:\> Set-DiagnosticStoreCapacity -Time 24

注

  • 新しい設定を有効にするために、コンピューターの再起動が必要になる場合があります。
  • 診断データ ビューアー (Microsoft Store アプリ) が同じデバイスにインストールされている場合は、PowerShell モジュールでデータ履歴のサイズを変更すると、その変更がアプリにも反映されます。

データ履歴のサイズを再設定する

データ履歴の最大サイズを元の 1 GB (既定値) に再設定するには、管理者特権の PowerShell セッションで次のコマンドを実行します。

PS C:\> Set-DiagnosticStoreCapacity -Size 1024 -Time 720

データ履歴のサイズを小さく再設定する場合は、ディスク領域を解放するために、必ずデータ表示を無効にしてからもう一度有効にしてください。