다음을 통해 공유

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>]

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: 상위 쿼리 옵션을 사용하여 현재 구독 범위에서 최신 비준수 정책 상태 요약 가져오기

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
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Filter

OData 표기법을 사용하여 식을 필터링합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-From

쿼리할 간격의 시작 시간을 지정하는 ISO 8601 형식의 타임스탬프입니다. 지정하지 않으면 기본적으로 'To' 매개 변수 값에서 1일을 뺀 값으로 설정됩니다.

형식:DateTime
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ManagementGroupName

관리 그룹 이름입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PolicyAssignmentName

정책 할당 이름입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PolicyDefinitionName

정책 정의 이름입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PolicySetDefinitionName

정책 집합 정의 이름입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ResourceGroupName

리소스 그룹 이름입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ResourceId

리소스 ID입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-SubscriptionId

구독 ID입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-To

쿼리할 간격의 종료 시간을 지정하는 ISO 8601 형식 타임스탬프입니다. 지정하지 않으면 기본적으로 요청 시간이 지정됩니다.

형식:DateTime
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Top

반환할 최대 레코드 수입니다.

형식:Int32
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

출력