Share via

Get-AzPolicyStateSummary

  • 參考
模組:
Az.PolicyInsights

取得資源的最新原則合規性狀態摘要。

Syntax

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 通訊的認證、帳戶、租用戶和訂用帳戶。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Filter

使用 OData 表示法篩選表達式。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-From

ISO 8601 格式化時間戳，指定要查詢的間隔開始時間。 未指定時，預設為 『To』 參數值減去 1 天。

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ManagementGroupName

管理組名。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PolicyAssignmentName

原則指派名稱。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PolicyDefinitionName

原則定義名稱。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PolicySetDefinitionName

原則集定義名稱。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

資源組名。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

資源標識碼。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SubscriptionId

訂用帳戶 ID。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-To

ISO 8601 格式化時間戳，指定要查詢之間隔的結束時間。 未指定時，預設為要求時間。

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Top

要傳回的記錄數目上限。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

String

輸出

PolicyStateSummary