Get-AzPolicyAssignment
정책 할당을 가져옵니다.
Syntax
Get-AzPolicyAssignment
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzPolicyAssignment
[-Name <String>]
[-Scope <String>]
[-PolicyDefinitionId <String>]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzPolicyAssignment
[-Scope <String>]
[-IncludeDescendent]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Get-AzPolicyAssignment
-Id <String>
[-PolicyDefinitionId <String>]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Description
Get-AzPolicyAssignment cmdlet은 모든 정책 할당 또는 특정 할당을 가져옵니다. 이름 및 범위 또는 ID별로 가져올 정책 할당을 식별합니다.
예제
예제 1: 모든 정책 할당 가져오기
Get-AzPolicyAssignment이 명령은 모든 정책 할당을 가져옵니다.
예제 2: 특정 정책 할당 가져오기
$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Get-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId첫 번째 명령은 Get-AzResourceGroup cmdlet을 사용하여 ResourceGroup11이라는 리소스 그룹을 가져오고 $ResourceGroup 변수에 저장합니다. 두 번째 명령은 $ResourceGroup ResourceId 속성이 식별하는 범위에 대해 PolicyAssignment07이라는 정책 할당을 가져옵니다.
예제 3: 관리 그룹에 할당된 모든 정책 할당 가져오기
$mgId = 'myManagementGroup'
Get-AzPolicyAssignment -Scope '/providers/Microsoft.Management/managementgroups/$mgId'첫 번째 명령은 쿼리할 관리 그룹의 ID를 지정합니다. 두 번째 명령은 ID가 'myManagementGroup'인 관리 그룹에 할당된 모든 정책 할당을 가져옵니다.
예제 4: 목록으로 서식이 지정된 모든 정책 할당의 범위, 정책 집합 정의 식별자 및 표시 이름 가져오기
Get-AzPolicyAssignment | Select-Object -ExpandProperty properties | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-List이 명령은 Azure Policy 할당의 읽기 친화적인 DisplayName 속성을 찾아야 하는 경우에 유용합니다.
매개 변수
-ApiVersion
사용할 리소스 공급자 API의 버전을 지정합니다. 버전을 지정하지 않으면 이 cmdlet은 사용 가능한 최신 버전을 사용합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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
이 cmdlet이 가져오는 정책 할당에 대한 정규화된 리소스 ID를 지정합니다.
| Type: | String |
| Aliases: | ResourceId |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-IncludeDescendent
반환된 정책 할당 목록에 상위 범위 및 하위 범위의 할당을 포함하여 지정된 범위와 관련된 모든 할당이 포함되도록 합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
이 cmdlet이 가져오는 정책 할당의 이름을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PolicyDefinitionId
이 cmdlet이 가져오는 정책 할당의 정책 정의 ID를 지정합니다.
| 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 |
-Scope
이 cmdlet이 가져오는 할당에 대해 정책이 적용되는 범위를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |