Start-AzPolicyComplianceScan

サブスクリプションまたはリソース グループ内のすべてのリソースに対してポリシー コンプライアンス評価をトリガーします。

構文

SubscriptionScope (既定)

Start-AzPolicyComplianceScan
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ResourceGroupScope

Start-AzPolicyComplianceScan
    [-ResourceGroupName <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

Start-AzPolicyComplianceScan コマンドレットは、サブスクリプションまたはリソース グループのポリシー コンプライアンス評価を開始します。

そのスコープ内のすべてのリソースのコンプライアンス状態は、割り当てられているすべてのポリシーに対して評価されます。

例 1: サブスクリプション スコープでコンプライアンス スキャンを開始する

Start-AzPolicyComplianceScan

このコマンドは、アクティブなサブスクリプションのポリシー コンプライアンス評価を開始します。

例 2: リソース グループ スコープでコンプライアンス スキャンを開始する

Start-AzPolicyComplianceScan -ResourceGroupName "myRG"

このコマンドは、アクティブなサブスクリプションの "myRG" リソース グループのポリシー コンプライアンス評価を開始します。

例 3: コンプライアンス スキャンを開始し、バックグラウンドで完了するまで待機する

$job = Start-AzPolicyComplianceScan -AsJob
$job | Wait-Job

このコマンドは、アクティブなサブスクリプションのポリシー コンプライアンス評価をジョブとして開始し、スキャンが完了するまで待機します。

パラメーター

-AsJob

コマンドをジョブとして実行します。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Confirm

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DefaultProfile

DefaultProfile パラメーターは機能しません。 別のサブスクリプションに対してコマンドレットを実行する場合は、使用可能な場合は SubscriptionId パラメーターを使用します。

パラメーターのプロパティ

型:PSObject
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:AzureRMContext, AzureCredential

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-NoWait

コマンドを非同期的に実行する

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-PassThru

コマンドが成功したときに true を返します。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ResourceGroupName

リソース グループ名。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

ResourceGroupScope
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SubscriptionId

ターゲット サブスクリプションの ID。 現在のサブスクリプションが指定されていない場合は、現在のサブスクリプションを使用します。

パラメーターのプロパティ

型:String
規定値:(Get-AzContext).Subscription.Id
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

SubscriptionScope
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、about_CommonParametersを参照してください。

出力

Boolean