Get-AzPolicyStateSummary
リソースの最新のポリシー コンプライアンス状態の概要を取得します。
構文
Get-AzPolicyStateSummary
[-SubscriptionId <String>]
[-Top <Int32>]
[-From <DateTime>]
[-To <DateTime>]
[-Filter <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzPolicyStateSummary
-ManagementGroupName <String>
[-Top <Int32>]
[-From <DateTime>]
[-To <DateTime>]
[-Filter <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzPolicyStateSummary
[-SubscriptionId <String>]
-ResourceGroupName <String>
[-Top <Int32>]
[-From <DateTime>]
[-To <DateTime>]
[-Filter <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzPolicyStateSummary
[-SubscriptionId <String>]
-PolicySetDefinitionName <String>
[-Top <Int32>]
[-From <DateTime>]
[-To <DateTime>]
[-Filter <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzPolicyStateSummary
[-SubscriptionId <String>]
-PolicyDefinitionName <String>
[-Top <Int32>]
[-From <DateTime>]
[-To <DateTime>]
[-Filter <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzPolicyStateSummary
[-SubscriptionId <String>]
-PolicyAssignmentName <String>
[-Top <Int32>]
[-From <DateTime>]
[-To <DateTime>]
[-Filter <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzPolicyStateSummary
[-SubscriptionId <String>]
-ResourceGroupName <String>
-PolicyAssignmentName <String>
[-Top <Int32>]
[-From <DateTime>]
[-To <DateTime>]
[-Filter <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzPolicyStateSummary
-ResourceId <String>
[-Top <Int32>]
[-From <DateTime>]
[-To <DateTime>]
[-Filter <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] 説明
ポリシーの割り当てとポリシー定義に分けて、さまざまなスコープでの最新のポリシー コンプライアンス状態番号の概要ビューを取得します。 非準拠ポリシーの状態のみが含まれます。
例
例 1: 現在のサブスクリプション スコープで最新の非準拠ポリシー状態の概要を取得する
Get-AzPolicyStateSummary現在のセッション コンテキスト内のサブスクリプション内のすべてのリソースについて、最後の日に生成された最新のポリシー コンプライアンス状態の概要ビューを取得します。
例 2: 指定されたサブスクリプション スコープで最新の非準拠ポリシー状態の概要を取得する
Get-AzPolicyStateSummary -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5"指定したサブスクリプション内のすべてのリソースについて、最終日に生成された最新のポリシー コンプライアンス状態の概要ビューを取得します。
例 3: 管理グループ スコープで最新の非準拠ポリシー状態の概要を取得する
Get-AzPolicyStateSummary -ManagementGroupName "myManagementGroup"指定した管理グループ内のすべてのリソースについて、最終日に生成された最新のポリシー コンプライアンス状態の概要ビューを取得します。
例 4: 現在のサブスクリプションのリソース グループ スコープで最新の非準拠ポリシー状態の概要を取得する
Get-AzPolicyStateSummary -ResourceGroupName "myResourceGroup"指定したリソース グループ内のすべてのリソース (現在のセッション コンテキストのサブスクリプション内) について、最終日に生成された最新のポリシー コンプライアンス状態の概要ビューを取得します。
例 5: 指定したサブスクリプションのリソース グループ スコープで最新の非準拠ポリシー状態の概要を取得する
Get-AzPolicyStateSummary -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5" -ResourceGroupName "myResourceGroup"指定したリソース グループ (指定したサブスクリプション内) 内のすべてのリソースについて、最終日に生成された最新のポリシー コンプライアンス状態の概要ビューを取得します。
例 6: リソースの最新の非準拠ポリシー状態の概要を取得する
Get-AzPolicyStateSummary -ResourceId "/subscriptions/fff10b27-fff3-fff5-fff8-fffbe01e86a5/resourceGroups/myResourceGroup/providers/Microsoft.EventHub/namespaces/myns1/eventhubs/eh1/consumergroups/cg1"指定したリソースの最後の日に生成された最新のポリシー コンプライアンス状態の概要ビューを取得します。
例 7: 現在のサブスクリプションのポリシー セット定義の最新の非準拠ポリシー状態の概要を取得する
Get-AzPolicyStateSummary -PolicySetDefinitionName "fff58873-fff8-fff5-fffc-fffbe7c9d697"指定されたポリシー セット定義 (現在のセッション コンテキストのサブスクリプションに存在する) によって影響を受けるすべてのリソース (現在のセッション コンテキスト内のテナント内) について、最終日に生成された最新のポリシー コンプライアンス状態の概要ビューを取得します。
例 8: 指定されたサブスクリプションのポリシー セット定義の最新の非準拠ポリシー状態の概要を取得する
Get-AzPolicyStateSummary -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5" -PolicySetDefinitionName "fff58873-fff8-fff5-fffc-fffbe7c9d697"指定したポリシー セット定義 (指定したサブスクリプションに存在する) によって影響を受けるすべてのリソース (現在のセッション コンテキスト内のテナント内) について、最終日に生成された最新のポリシー コンプライアンス状態の概要ビューを取得します。
例 9: 現在のサブスクリプションのポリシー定義の最新の非準拠ポリシー状態の概要を取得する
Get-AzPolicyStateSummary -PolicyDefinitionName "fff58873-fff8-fff5-fffc-fffbe7c9d697"指定されたポリシー定義 (現在のセッション コンテキストのサブスクリプションに存在する) によって影響を受けるすべてのリソース (現在のセッション コンテキスト内のテナント内) について、最終日に生成された最新のポリシー コンプライアンス状態の概要ビューを取得します。
例 10: 指定したサブスクリプション内のポリシー定義の最新の非準拠ポリシー状態の概要を取得する
Get-AzPolicyStateSummary -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5" -PolicyDefinitionName "fff58873-fff8-fff5-fffc-fffbe7c9d697"指定したポリシー定義 (指定したサブスクリプションに存在する) によって影響を受けるすべてのリソース (現在のセッション コンテキスト内のテナント内) について、最終日に生成された最新のポリシー コンプライアンス状態の概要ビューを取得します。
例 11: 現在のサブスクリプションのポリシー割り当ての最新の非準拠ポリシー状態の概要を取得する
Get-AzPolicyStateSummary -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"指定されたポリシー割り当て (現在のセッション コンテキストのサブスクリプションに存在する) によって影響を受けるすべてのリソース (現在のセッション コンテキスト内のテナント内) について、最後の日に生成された最新のポリシー コンプライアンス状態の概要ビューを取得します。
例 12: 指定したサブスクリプションのポリシー割り当ての最新の非準拠ポリシー状態の概要を取得する
Get-AzPolicyStateSummary -SubscriptionId "fff10b27-fff3-fff5-fff8-fffbe01e86a5" -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"指定したポリシーの割り当て (指定したサブスクリプションに存在する) によって影響を受けるすべてのリソース (現在のセッション コンテキスト内のテナント内) について、最終日に生成された最新のポリシー コンプライアンス状態の概要ビューを取得します。
例 13: 現在のサブスクリプションの指定されたリソース グループ内のポリシー割り当ての最新の非準拠ポリシー状態の概要を取得する
Get-AzPolicyStateSummary -ResourceGroupName "myResourceGroup" -PolicyAssignmentName "ddd8ef92e3714a5ea3d208c1"指定されたポリシー割り当て (現在のセッション コンテキストのリソース グループ内に存在する) によって影響を受けるすべてのリソース (現在のセッション コンテキスト内のテナント内) について、最終日に生成された最新のポリシー コンプライアンス状態の概要ビューを取得します。
例 14: 現在のサブスクリプション スコープで最新の非準拠ポリシー状態の概要を取得する (上位クエリ オプションを使用)
Get-AzPolicyStateSummary -Top 5現在のセッション コンテキスト内のサブスクリプション内のすべてのリソースについて、最後の日に生成された最新のポリシー コンプライアンス状態の概要ビューを取得します。 このコマンドは、ポリシー割り当ての概要を結果の非準拠リソース数で降順に並べ替え、ポリシー割り当てサマリーの上位 5 件のみを取得します。
例 15: 現在のサブスクリプション スコープの最新の非準拠ポリシー状態の概要を取得し、From クエリと To クエリ オプションを使用する
Get-AzPolicyStateSummary -From "2018-03-08 00:00:00Z" -To "2018-03-15 00:00:00Z"現在のセッション コンテキストのサブスクリプション内のすべてのリソースに対して指定された日付範囲内に生成された、最新のポリシー コンプライアンス状態の概要ビューを取得します。
例 16: フィルター クエリ オプションを使用して、現在のサブスクリプション スコープで最新の非準拠ポリシー状態の概要を取得する
Get-AzPolicyStateSummary -Filter "(PolicyDefinitionAction eq 'deny' or PolicyDefinitionAction eq 'audit') and ResourceLocation ne 'eastus'"現在のセッション コンテキスト内のサブスクリプション内のすべてのリソースについて、最後の日に生成された最新のポリシー コンプライアンス状態の概要ビューを取得します。 このコマンドは、ポリシー定義アクション (拒否または監査アクションを含む) とリソースの場所 (eastus の場所を除く) に基づいてフィルター処理によって返される結果を制限します。
パラメーター
-DefaultProfile
Azure との通信のために使用される資格情報、アカウント、テナント、サブスクリプションです。
| 型: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Filter
OData 表記を使用して式をフィルター処理します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-From
クエリする間隔の開始時刻を指定する ISO 8601 形式のタイムスタンプ。 指定しない場合、既定値は "To" パラメーター値から 1 日を引いた値になります。
| 型: | DateTime |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ManagementGroupName
管理グループ名。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-PolicyAssignmentName
ポリシーの割り当て名。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-PolicyDefinitionName
ポリシー定義名。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-PolicySetDefinitionName
ポリシー セット定義名。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ResourceGroupName
リソース グループ名。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ResourceId
リソース ID。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-SubscriptionId
[サブスクリプション ID] が表示されます。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-To
クエリする間隔の終了時刻を指定する ISO 8601 形式のタイムスタンプ。 指定しない場合、既定では要求の時刻が設定されます。
| 型: | DateTime |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Top
返す最大レコード数。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
出力
関連リンク
Azure PowerShell