Get-AzPolicyDefinition

모듈:

Az.Resources

정책 집합 정의를 가져옵니다.

구문

Get-AzPolicyDefinition
   [-Name <String>]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-Name <String>]
   -ManagementGroupName <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-Name <String>]
   -SubscriptionId <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-Name <String>]
   [-Id <String>]
   [-BackwardCompatible]
   -Version <String>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-Name <String>]
   [-Id <String>]
   [-ListVersion]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   -Id <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-SubscriptionId <String>]
   [-ManagementGroupName <String>]
   [-Builtin]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-SubscriptionId <String>]
   [-ManagementGroupName <String>]
   [-Custom]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-SubscriptionId <String>]
   [-ManagementGroupName <String>]
   [-Static]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<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 -Property DisplayName, Description, PolicyType, Metadata | Format-List

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

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

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

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

매개 변수

-BackwardCompatible

cmdlet이 속성 모음 개체에 정책별 속성을 배치하는 레거시 형식을 사용하여 아티팩트를 반환하도록 합니다.

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

-Builtin

cmdlet이 기본 제공 정책 정의만 반환하도록 합니다.

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

-Custom

cmdlet이 사용자 지정 정책 정의만 반환하도록 합니다.

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

-DefaultProfile

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

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

-Id

가져올 정책 정의의 전체 ID입니다.

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

-ListVersion

cmdlet이 사용자 지정 정책 정의만 반환하도록 합니다.

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

-ManagementGroupName

관리 그룹의 이름입니다.

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

-Name

가져올 정책 정의의 이름입니다.

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

-Static

cmdlet이 정적 정책 정의만 반환하도록 합니다.

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

-SubscriptionId

대상 구독의 ID입니다.

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

-Version

#.#.# 형식의 정책 정의 버전입니다.

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

입력

SwitchParameter

String

출력

IPolicyDefinition