Get-AzPolicySetDefinition

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

Syntax

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

Description

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

예제

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

Get-AzPolicySetDefinition

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

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

Get-AzPolicySetDefinition -Name 'VMPolicySetDefinition'

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

예제 3: 이름으로 구독에서 정책 집합 정의 가져오기

Get-AzPolicySetDefinition -Name 'VMPolicySetDefinition' -subscriptionId '3bf44b72-c631-427a-b8c8-53e2595398ca'

이 명령은 ID가 3bf44b72-c631-427a-b8c8-53e2595398ca인 구독에서 VMPolicySetDefinition이라는 정책 정의를 가져옵니다.

예제 4: 관리 그룹에서 모든 사용자 지정 정책 집합 정의 가져오기

Get-AzPolicySetDefinition -ManagementGroupName 'Dept42' -Custom

이 명령은 Dept42라는 관리 그룹에서 모든 사용자 지정 정책 집합 정의를 가져옵니다.

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

Get-AzPolicySetDefinition | Where-Object {$_.Properties.metadata.category -eq "Virtual Machine"}

이 명령은 범주 "Virtual Machine"의 모든 정책 집합 정의를 가져옵니다.

매개 변수

-ApiVersion

설정되면 사용할 리소스 공급자 API의 버전을 나타냅니다. 지정하지 않으면 API 버전이 사용 가능한 최신 버전으로 자동으로 결정됩니다.

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

-Builtin

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

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

-Custom

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

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

-DefaultProfile

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

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

-Id

구독을 포함하여 정규화된 정책 집합 정의 ID입니다. 예: /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}

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

-ManagementGroupName

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

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

-Name

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

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

-Pre

설정되면 cmdlet이 사용할 버전을 자동으로 결정할 때 시험판 API 버전을 사용해야 임을 나타냅니다.

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

-SubscriptionId

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

Type:Nullable<T>[Guid]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

입력

String

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

출력

PSObject