你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Get-AzPolicyStateSummary

模块:

Az.PolicyInsights

获取资源的最新策略符合性状态摘要。

语法

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：使用 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

资源 ID。

类型:	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

输入

String

输出

PolicyStateSummary

相关链接

• Get-AzPolicyState