ゼロ トラスト評価の接続エラー、スキップされたチェック、実行速度の低下、依存関係の競合、およびレポートの問題を調査します。 影響を受けるステージから開始し、症状固有のチェックで問題が解決されない場合は診断を収集します。 調査のために PowerShell セッションまたは使用可能な診断を保持します。
開始する前に、アセスメント情報と PowerShell のバージョン、実行スコープ、およびエラーの概要を収集します。 必要な情報については前提条件を参照してください。
Prerequisites
- 利用可能な場合は評価 PowerShell セッション、またはその生成された診断情報。
- 評価と PowerShell のバージョン、選択したピラーとテスト ID、影響を受けるステージ、エラーの概要。
トラブルシューティング チェックリスト
アクセス許可、依存関係、またはタイムアウトを変更する前に、障害ステージを特定します。
該当するステージを特定する
適切な診断を選択できるように、失敗した評価ステージを特定します。
- 接続メッセージと 実行ごとの診断ファイル を確認して、接続、エクスポート、データベースの作成、テスト、またはレポートの処理中に問題が発生したかどうかを特定します。
- 評価バージョン、PowerShell バージョン、選択したピラーとテスト ID、サニタイズされたエラーの概要を記録します。
- resumeを使用する場合は、完了したエクスポートとデータベースを保持します。
アクセスとカバレッジを確認する
症状テーブルを使用して、次のチェックを選択します。 Microsoft Graph接続が成功しても、他のすべてのサービスが確立されるわけではありません。スキップされたチェックは、セキュリティで保護された構成の証拠ではありません。
| 現象 | 確認すべきこと |
|---|---|
| Graph の同意またはロールの検証が失敗します。 | 許可と Get-ZtGraphScopeを比較し、必要なユーザー ロールをアクティブ化するか、アプリのアクセス許可を構成して再接続します。 新しいパッケージには、追加の同意が必要な場合があります。 |
| サービスが接続に失敗するか、テストがスキップされます。 | サービスの役割、ライセンス、プラットフォーム、接続メッセージを確認します。 接続のガイダンスを参照してください。 |
| 保護、ラベル、データ損失防止 (DLP)、またはハンティング チェックでは、承認エラーが返されます。 | Microsoft Entra ID のロール名だけでなく、コマンドまたは API のワークロード ロールの割り当てとデータ スコープを確認します。 アクセス テーブル一覧を使用します。 |
| インフラストラクチャに検出事項はありません。 | Azure の読み取りアクセスとサブスクリプション タグを確認します。 タグ付けされたサブスクリプションまたはアクセス可能なサブスクリプションは、合格した評価ではありません。 |
| 実行時間が長い、リクエストがスロットリングされる、またはメモリ負荷が増大する。 | コレクターとテスト ログを検査します。 構成設定のルックバック、コンカレンシー、キャッシュ、タイムアウトを確認します。 |
| 証明書接続が失敗します。 | 証明書の有効性/秘密キー、アプリの公開キーの登録、テナント GUID、同意、およびサービス プリンシパル ロールを確認します。 SharePoint では、使用中のコネクタにエクスポート可能なキーも必要です。 |
| 制約付き言語モードでは、実行できません。 | 評価をサポートする承認済みのホスト/ポリシーを使用します。 組織の制御をバイパスしないでください。高度なオーバーライドをしても、制限された操作が機能するようにはなりません。 |
原因と解決策
依存関係エラーとレポートエラーには、次の手順を使用します。 回避策を選択する前に、影響を受けるバージョンを確認してください。
Graph アセンブリの競合を解決する
Could not load file or assembly Microsoft.Graph.Authenticationの場合は、共有モジュールを削除するのではなく、クリーン なプロセスから始めます。
- 新しい
pwsh -NoProfileプロセスを開始します。 - 評価で、他のクラウド モジュールの前にピン留めされた依存関係を読み込ませます。
- 問題が解決しない場合は 依存関係キャッシュとクリーン ホストのガイダンス を確認します。
別のインストール済みモジュールが自動的に競合することはありませんが、既に読み込まれているアセンブリに互換性がない可能性があります。 モジュールを削除または再インポートしても、アセンブリが確実にアンロードされません。 既定の解決策として、共有 Graph モジュールとサード パーティ製クリーンアップ スクリプトの一括削除は避けてください。
DuckDB 初期化エラーを解決する
エラー The type initializer for 'DuckDB.NET.Data.DuckDBConnectionStringBuilder' threw an exception には、基になる原因が異なる場合があります。
- 内部例外を確認してください。 Windowsでは、
duckdbのDllNotFoundExceptionはネイティブ依存関係が不足していることを示している可能性があります。 - 不足している場合は、Microsoft Visual C++ 再頒布可能パッケージ (x64) をインストールしてください。
- 新しい PowerShell セッションで再試行してください。 すべてのデータベースエラーに同じ原因があるとは考えないでください。
レポート表示エラーから回復する
古いレポートには Unexpected Application Error! Invalid array lengthが表示される場合があります。 関連レポートには microsoft/zerotrustassessment#1235、microsoft/zerotrustassessment#1272、microsoft/zerotrustassessment#1310、および microsoft/zerotrustassessment#1388 が含まれます。
- お使いのバージョンの問題と リリース履歴 を確認します。 プレリリースが常に必要であると想定しないでください。
- エクスポートとデータベースの作成が完了した場合は、保持します。
- 該当する修正プログラムをインストールした後、再接続し、元のパスと柱で
-Resumeを使用して、評価とレポートの処理を再実行します。 - 正常に生成された場合は、クラシック HTML レポートを使用してください。
評価アクティビティを確認する
PowerShell ソース、進行状況ダッシュボード、実行ごとのログを確認して、評価の動作を把握します。 アップストリームの 高度なトラブルシューティング ガイド では、サポート パッケージの分析について説明します。
高度なトラブルシューティングとデータ収集
診断ごとに取得される段階は異なります。 データを収集または共有する前に、障害が発生した場所に合う場所を選択します。
ログと診断ファイル
<Path> は、Invoke-ZtAssessment -Path に渡すディレクトリ、または既定では .\ZeroTrustReport です。 オプションのサポート パッケージ、実行ごとのファイル、および拡張 PSFramework ログは、3 つの個別の診断場所です。
| 場所 | 内容と使い方 |
|---|---|
<Path>\log\ |
.cliDat によって正常終了間際に作成された、-ExportLog スナップショットを含む PSFramework サポート パッケージ ZIP。 スイッチが使用されなかった場合や、このステージの前に実行に失敗した場合は、存在しない可能性があります。 |
<Path>\zt-export\logs\<run>\1-export_progress.log |
コレクターの進行状況と状態をエクスポートします。 データ収集の問題については、ここから始めます。 |
<Path>\zt-export\logs\<run>\2-database_progress.log |
データベース ビルドの進行状況とタイミング。 再開は、このフェーズをスキップします。 |
<Path>\zt-export\logs\<run>\3-test_progress.log |
評価の実行の進行状況と状態。 |
<Path>\zt-export\logs\<run>\1-Export\export_<Name>.md |
コレクターの状態、期間、タイムスタンプ、エンドポイント/種類、モジュールのバージョン、診断メッセージ。 |
<Path>\zt-export\logs\<run>\2-Tests\<TestID>.md |
テストのタイトル、状態、期間、タイムスタンプ、モジュールのバージョン、詳細なメッセージ (クエリ テキストを含む可能性あり) |
%APPDATA%\PowerShell\PSFramework\Logs\on Windows |
出力パスに依存しない拡張メッセージ ログと XML エラー レコード。 接続/インポートの問題、例外、発生箇所、スタック トレース、個々のテスト外のメッセージに役立ちます。 |
<run> はタイムスタンプ形式として yy-MM-dd-HHmmss を使用します。 ファイルはフェーズの実行時に表示されます。部分的または再開された実行には、すべてのファイルが含まれている必要はありません。 実行ごとのファイルは、 -ExportLogとは別に生成されます。
拡張 PSFramework ファイルには、コンピューター/プロセス識別子、および番号付きセグメント ( <computer>_<pid>_message_0.log や <computer>_<pid>_error_0.xmlなど) が含まれます。 可用性と保持期間は、ログ プロバイダーの構成によって異なります。
Windowsでは、%APPDATA%はユーザーのローミング フォルダー (通常は%USERPROFILE%\AppData\Roaming) を識別します。 PowerShell では、$env:APPDATA を使用します。同等のログ パスは Join-Path $env:APPDATA 'PowerShell\PSFramework\Logs' です。
<Path>\zt-exportの残りの部分は、エクスポートされたエンティティ、ztConfig.json、db\zt.db、ZeroTrustAssessmentReport.json、ZeroTrustWorkshop.jsonなどのログだけでなく、評価データです。 これらのファイルは、実行を再現または再開するのに役立ちますが、機密性の高いテナント データを含めることができます。
<Path>を削除しても、個別の PSFramework ログは削除されません。
サポート パッケージをキャプチャする
オプションのサポート パッケージを作成する前に実行が失敗した場合は、閉じる前に、同じ PowerShell セッションで診断をキャプチャします。
診断パッケージの別の宛先を選択します。 評価の出力パスと一致する必要はありません。 保存先の例を実行時のフォルダーに置き換えます。
New-PSFSupportPackage -Path C:\AssessmentLogs\Run01 -Force生成された ZIP を抽出して、含まれている
.cliDatファイルにアクセスします。共有する前に、診断情報を確認し、機密情報を伏せます。 スナップショットのインポートと調査については、 高度なログ分析ガイドを参照してください。
サポート パッケージは、メッセージとエラー履歴、場合によってはコマンド履歴またはコンソール出力を含む、使用可能なセッション診断のスナップショットです。 エクスポートされたすべてのテナント ファイルの自動アーカイブではありません。
Warning
レポート、エクスポート、サポート パッケージ、および拡張ログには、個人情報、テナント識別子、クエリ値、および構成の詳細を含めることができます。 パブリック GitHub Issue に未確認のままそれらを添付したり、未承認のツールにアップロードしたりしないでください。 受信者と合意した承認済みのプライベート チャネルを介してのみ、追加の診断を共有します。
問題を報告するか、フィードバックを提供する
GitHub issuesを検索するか、起票するか、フィードバック チャネルを使用します。 評価バージョン、PowerShell バージョン、選択した柱とテスト ID、影響を受けるステージ、サニタイズされたエラーの概要を含めます。
評価はコミュニティ プロジェクトであり、公式のMicrosoft製品ではありません。 コミュニティの問題の報告は、サポート 契約でも、応答の保証でもない。 診断を共有する前に 、サポート ポリシー をお読みください。