다음을 통해 공유

Get-AzPolicyDefinition

  • 참조
모듈:
Az.Resources

정책 정의를 가져옵니다.

구문

Get-AzPolicyDefinition
   [-Name <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyDefinition
   [-Name <String>]
   -ManagementGroupName <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyDefinition
   [-Name <String>]
   -SubscriptionId <Guid>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyDefinition
   -Id <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyDefinition
   [-ManagementGroupName <String>]
   [-SubscriptionId <Guid>]
   [-Builtin]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyDefinition
   [-ManagementGroupName <String>]
   [-SubscriptionId <Guid>]
   [-Custom]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Get-AzPolicyDefinition cmdlet은 이름 또는 ID로 식별되는 정책 정의 또는 특정 정책 정의의 컬렉션을 가져옵니다.

예제

예제 1: 모든 정책 정의 가져오기

Get-AzPolicyDefinition

이 명령은 모든 정책 정의를 가져옵니다.

예제 2: 이름으로 현재 구독에서 정책 정의 가져오기

Get-AzPolicyDefinition -Name 'VMPolicyDefinition'

이 명령은 현재 기본 구독에서 VMPolicyDefinition이라는 정책 정의를 가져옵니다.

예제 3: 이름으로 관리 그룹에서 정책 정의 가져오기

Get-AzPolicyDefinition -Name 'VMPolicyDefinition' -ManagementGroupName 'Dept42'

이 명령은 Dept42라는 관리 그룹에서 VMPolicyDefinition이라는 정책 정의를 가져옵니다.

예제 4: 구독에서 모든 기본 제공 정책 정의 가져오기

Get-AzPolicyDefinition -SubscriptionId '3bf44b72-c631-427a-b8c8-53e2595398ca' -Builtin

이 명령은 ID가 3bf44b72-c631-427a-b8c8-53e2595398ca인 구독에서 모든 기본 제공 정책 정의를 가져옵니다.

예제 5: 지정된 범주에서 정책 정의 가져오기

Get-AzPolicyDefinition | Where-Object {$_.Properties.metadata.category -eq 'Tags'}

이 명령은 태그 범주 의 모든 정책 정의를 가져옵니다.

예제 6: 목록으로 서식이 지정된 모든 정책 정의의 표시 이름, 설명, 정책 유형 및 메타데이터 가져오기

Get-AzPolicyDefinition | Select-Object -ExpandProperty properties | Select-Object -Property DisplayName, Description, PolicyType, Metadata | Format-List

이 명령은 Azure Policy 정의의 읽기 친화적인 DisplayName 속성을 찾아야 하는 경우에 유용합니다. 메타데이터 속성을 구문 분석하여 정책 정의의 버전 번호 및 범주 할당을 검색할 수 있습니다.

매개 변수

-ApiVersion

사용할 리소스 공급자 API의 버전을 지정합니다. 버전을 지정하지 않으면 이 cmdlet은 사용 가능한 최신 버전을 사용합니다.

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

-Builtin

결과 목록을 기본 제공 정책 정의로만 제한합니다.

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

-Custom

결과 목록을 사용자 지정 정책 정의로만 제한합니다.

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

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독

형식:IAzureContextContainer
별칭:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Id

이 cmdlet이 가져오는 정책 정의에 대한 정규화된 리소스 ID를 지정합니다.

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

-ManagementGroupName

가져올 정책 정의의 관리 그룹의 이름입니다.

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

-Name

이 cmdlet이 가져오는 정책 정의의 이름을 지정합니다.

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

-Pre

이 cmdlet은 사용할 버전을 자동으로 결정할 때 시험판 API 버전을 고려한다는 것을 나타냅니다.

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

-SubscriptionId

가져올 정책 정의의 구독 ID입니다.

형식:Nullable<T>[Guid]
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

입력

String

Nullable<T>[[System.Guid, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

출력

PSObject