すべてのゼロ トラスト評価の柱を実行するか、柱と特定のテスト ID を選択します。 既存のエクスポートを再利用して、新しいテナント スナップショットを収集せずに評価とレポートの処理を再実行することもできます。 開始する前に、サービスに接続し、保護された出力ディレクトリを選択します。
次のセクションのオプションと既定値では、開発ソースについて説明します。 発行済みパッケージを使用する場合は、インストールされているバージョンのヘルプを確認してください。
Prerequisites
- 評価 サービスへの接続が完了し、サービス接続は同じ PowerShell セッションで使用できます。
- 十分なディスク領域を持つ保護された出力ディレクトリ。
- Infrastructure scope の Azure 読み取りアクセスとサブスクリプション タグ (該当する場合)。
新しい評価を実行する
Invoke-ZtAssessment は、接続されているテナントを使用します。テナント パラメーターは受け取りません。 コマンドを実行する前に、出力パスとスコープを選択します。
Warning
空でない出力ディレクトリに対して非再開を実行すると、その内容を削除するように求められます。 継続的インテグレーション(CI)環境が検出された場合は、現在の実装ではディレクトリは自動的に消去されます。 関連のないファイルを含むディレクトリに -Path を指定しないでください。
新しい出力ディレクトリを選択します。 既定値は
.\ZeroTrustReportで、現在のディレクトリを基準にしています。次のいずれかの方法を実行します。
現在の 7 つの柱をすべて評価するには、次を使用します。
Invoke-ZtAssessmentデバイスのみを評価し、カスタム パスを使用するには、次を使用します。
Invoke-ZtAssessment -Path C:\MyAssessment01 -Pillar Devices
アクティブな作業と障害を区別する必要がある場合は、進行状況ダッシュボードで進捗を確認し、診断ファイル を確認します。
ランタイムは、テナント サイズ、サービス応答時間、スロットリング、選択したテストによって異なります。
-NoBrowser は、進行状況ダッシュボード サーバーと最終レポートの自動開きの両方を無効にします。
All には、ID、デバイス、ネットワーク、データ、インフラストラクチャ、セキュリティ操作 (SecOps)、AI が含まれます。 これらの柱には、 -Preview スイッチは必要ありません。 そのスイッチがある場合、プレビューのみの機能が有効になり、プレリリース パッケージのインストールとは別です。
既存のエクスポートを再利用する
-Resumeは、現在のテナント データを収集せず、既存のテナント スナップショットとデータベースを再利用する場合にのみ使用します。
既存の出力ディレクトリ、エクスポート、データベースを保持します。
元の柱を使用するか、元のエクスポートで
Allを使用した場合は個々の柱を使用します。 単一柱エクスポートは、Allまたは別の柱として再開することはできません。必要なサービス接続を使用可能な状態に保ち、元のパスに対して再実行します。
Invoke-ZtAssessment -Path C:\MyAssessment01 -Pillar Devices -Resume
再開はエクスポートとデータベースの再構築をスキップしますが、評価とレポートの処理を再実行します。 これは、新しいコレクションでも、完全にオフラインで実行することも保証するものではありません。
インフラストラクチャの対象範囲
インフラストラクチャの調査結果では、Microsoft Defender for Cloud推奨事項が使用されます。 このピラーを評価する前に、対象のサブスクリプションを準備してください。
- 目的のサブスクリプション/リソース スコープごとに、Reader アクセス権または同等の読み取りアクセス許可を設定します。
-
アクセス可能な対象の Azure サブスクリプションに
ZeroTrustAssessment:Infrastructureでタグ付けします。 - インフラストラクチャ ピラーまたは
Allを実行してから、スキップされたチェックを確認します。
必要なタグを持つアクセス可能なサブスクリプションのみが含まれます。 タグ付けされたサブスクリプションが一致しない場合、合格の評価ではなくスキップが生成されます。
Invoke-ZtAssessment パラメーター
次の表を使用して、実行オプションを選択します。 コマンドラインで明示的に指定した値は、サポートされている構成ファイルの設定を上書きします。 すべてのパラメーターが構成ファイルの設定であるわけではありません。
| Parameter | Behavior |
|---|---|
-Path <string> |
出力フォルダー。既定では、現在のディレクトリを基準にした .\ZeroTrustReport です。 |
-Pillar <string> |
既定では All、または Identity、Devices、Network、Data、Infrastructure、SecOps、または AI。 |
-Preview |
プレビューのみの機能が存在する場合は有効にします。 現在の7つの柱には必要ありません。 |
-Resume |
-Pathでエクスポートとデータベースを再利用します。元の柱またはAllエクスポートのサブセットを使用します。 |
-Tests <id[,id...]> |
ワイルドカードを使用しない正確なテスト ID。 それ以外の場合は、選択した柱のテストを実行します。 |
-Days <1-30> |
サインイン ログのルックバックの既定値は 30 日です。 |
-MaximumSignInLogQueryTime <minutes> |
サインイン コレクションの時間予算の既定値は 60 です。
0 は時間制限を削除しますが、エクスポート サイズの制限は引き続き適用されます。 |
-NoBrowser |
進行状況ダッシュボード サーバーを起動したり、最終的なレポートを開いたりしないでください。 |
-ShowLog |
コンソール ログの概要を表示します。 |
-ExportLog |
実行の終わりに近い <Path>\log の下に PSFramework サポート パッケージを作成します。 実行ごとの診断ファイルには、このスイッチは必要ありません。 |
-ConfigurationFile <path> |
サポートされている設定の JSON 構成。 明示的なコマンド ライン値が優先されます。 |
-DisableTelemetry |
評価テレメトリ イベントを無効にします。 データ処理とテレメトリを参照してください。 |
-Timeout <timespan> |
テスト全体の待機時間。既定値は 24 時間です。
12hや3dなどの値を受け入れます。 |
-TestTimeout <minutes/timespan> |
テストごとのタイムアウト。既定値は 60 分です。
0 にすると無効になります。 既定では、合計経過時間ではなく、アクティビティ以降のアイドル時間が測定されます。 外部操作とリモート処理操作の中断は可能な限り行われます。 |
-ExportThrottleLimit <n>、-TestThrottleLimit <n> |
並列エクスポート コレクターとテスト。既定値はそれぞれ 5 です。 |
完全なインターフェイスについては、 Get-Help Invoke-ZtAssessment -Full を使用し、 コマンド ソースを確認します。 構成の永続化と大規模テナント向けの設定については、評価の構成と調整を参照してください。