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>] Description
取得各種範圍中最新原則合規性狀態編號的摘要檢視，細分為原則指派和原則定義。 它只包含不符合規範的原則狀態。
範例
範例 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：使用 Top 查詢選項取得目前訂用帳戶範圍中的最新不符合規範的原則狀態摘要
Get-AzPolicyStateSummary -Top 5取得目前會話內容中訂用帳戶內所有資源最後一天所產生的最新原則合規性狀態摘要檢視。 命令會依不符合規範的資源計數，依遞減順序排序結果中的原則指派摘要，而且只會採用這些原則指派摘要的前 5 名。
範例 15：取得目前訂用帳戶範圍中最新的不符合規範的原則狀態摘要，以及 [從] 和 [到] 查詢選項
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 |
| 別名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Filter
使用 OData 表示法篩選表達式。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-From
ISO 8601 格式化時間戳，指定要查詢的間隔開始時間。 未指定時，預設為 『To』 參數值減去 1 天。
| 類型: | DateTime |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ManagementGroupName
管理組名。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-PolicyAssignmentName
原則指派名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-PolicyDefinitionName
原則定義名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-PolicySetDefinitionName
原則集定義名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ResourceGroupName
資源組名。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-ResourceId
資源標識碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-SubscriptionId
訂用帳戶 ID。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-To
ISO 8601 格式化時間戳，指定要查詢之間隔的結束時間。 未指定時，預設為要求時間。
| 類型: | DateTime |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Top
要傳回的記錄數目上限。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |