다음을 통해 공유

Update-AzPolicyExemption

  • 참조
모듈:
Az.Resources

이 작업은 지정된 범위 및 이름으로 정책 예외를 업데이트합니다.

구문

Update-AzPolicyExemption
      -Name <String>
      [-Scope <String>]
      [-ExemptionCategory <String>]
      [-PolicyDefinitionReferenceId <String[]>]
      [-DisplayName <String>]
      [-Description <String>]
      [-ExpiresOn <DateTime>]
      [-ClearExpiration]
      [-Metadata <String>]
      [-ResourceSelector <IResourceSelector[]>]
      [-AssignmentScopeValidation <String>]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzPolicyExemption
      [-ExemptionCategory <String>]
      [-PolicyDefinitionReferenceId <String[]>]
      -Id <String>
      [-DisplayName <String>]
      [-Description <String>]
      [-ExpiresOn <DateTime>]
      [-ClearExpiration]
      [-Metadata <String>]
      [-ResourceSelector <IResourceSelector[]>]
      [-AssignmentScopeValidation <String>]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzPolicyExemption
      [-ExemptionCategory <String>]
      [-PolicyDefinitionReferenceId <String[]>]
      [-DisplayName <String>]
      [-Description <String>]
      [-ExpiresOn <DateTime>]
      [-ClearExpiration]
      [-Metadata <String>]
      [-ResourceSelector <IResourceSelector[]>]
      [-AssignmentScopeValidation <String>]
      [-BackwardCompatible]
      -InputObject <IPolicyExemption>
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

이 작업은 지정된 범위 및 이름으로 정책 예외를 업데이트합니다.

예제

예제 1: 표시 이름 업데이트

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
 $PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07' -Scope $ResourceGroup.ResourceId
Update-AzPolicyExemption -Id $PolicyExemption.ResourceId -DisplayName 'Exempt VM creation limit'

첫 번째 명령은 Get-AzResourceGroup cmdlet을 사용하여 ResourceGroup11이라는 리소스 그룹을 가져옵니다. 명령은 해당 개체를 $ResourceGroup 변수에 저장합니다. 두 번째 명령은 Get-AzPolicyExemption cmdlet을 사용하여 PolicyExemption07이라는 정책 예외를 가져옵니다. 명령은 해당 개체를 $PolicyExemption 변수에 저장합니다. 최종 명령은 $ResourceGroup ResourceId 속성으로 식별된 리소스 그룹의 정책 예외에 대한 표시 이름을 업데이트합니다.

예제 2: 만료 날짜 시간 업데이트

$NextMonth = (Get-Date).AddMonths(1)
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Update-AzPolicyExemption -Id $PolicyExemption.ResourceId -ExpiresOn $NextMonth

첫 번째 명령은 Get-Date cmdlet을 사용하여 현재 날짜 시간을 가져오고 현재 날짜 시간에 1개월을 추가합니다. 명령은 해당 개체를 $NextMonth 변수에 저장합니다. 두 번째 명령은 Get-AzPolicyExemption cmdlet을 사용하여 PolicyExemption07이라는 정책 예외를 가져옵니다. 명령은 해당 개체를 $PolicyExemption 변수에 저장합니다. 최종 명령은 기본 구독에 대한 정책 예외의 만료 날짜 시간을 업데이트합니다.

예제 3: 만료 날짜 시간 지우기

$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Update-AzPolicyExemption -Id $PolicyExemption.ResourceId -ClearExpiration

첫 번째 명령은 Get-AzPolicyExemption cmdlet을 사용하여 PolicyExemption07이라는 정책 예외를 가져옵니다. 명령은 해당 개체를 $PolicyExemption 변수에 저장합니다. 두 번째 명령은 기본 구독에 대한 정책 예외의 만료 날짜 시간을 지웁니다. 업데이트된 예외는 만료되지 않습니다.

예제 4: 만료 범주 업데이트

$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Update-AzPolicyExemption -Id $PolicyExemption.ResourceId -ExemptionCategory Mitigated

첫 번째 명령은 Get-AzPolicyExemption cmdlet을 사용하여 PolicyExemption07이라는 정책 예외를 가져옵니다. 명령은 해당 개체를 $PolicyExemption 변수에 저장합니다. 두 번째 명령은 기본 구독에서 정책 예외에 대한 만료 범주를 업데이트합니다. 업데이트된 예외는 만료되지 않습니다.

첫 번째 명령은 Get-Date cmdlet을 사용하여 현재 날짜 시간을 가져오고 현재 날짜 시간에 1개월을 추가합니다. 명령은 해당 개체를 $NextMonth 변수에 저장합니다. 두 번째 명령은 Get-AzPolicyExemption cmdlet을 사용하여 PolicyExemption07이라는 정책 예외를 가져옵니다. 명령은 해당 개체를 $PolicyExemption 변수에 저장합니다. 최종 명령은 기본 구독에 대한 정책 예외의 만료 날짜 시간을 업데이트합니다.

예제 5: 리소스 선택기 업데이트

$ResourceSelector = @{Name = "MyLocationSelector"; Selector = @(@{Kind = "resourceLocation"; NotIn = @("eastus", "eastus2")})}
Update-AzPolicyExemption -Name 'VirtualMachineExemption' -ResourceSelector $ResourceSelector

첫 번째 명령은 예외를 지정하는 데 사용할 리소스 선택기 개체를 만들어 미국 동부 또는 미국 동부 2 이외의 위치에 있는 리소스에만 적용하고 $ResourceSelector 변수에 저장합니다. 최종 명령은 VirtualMachineExemption이라는 정책 예외를 $ResourceSelector 지정된 리소스 선택기로 업데이트합니다.

예제 6: [Backcompat] 만료 날짜 시간 지우기

$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Set-AzPolicyExemption -Id $PolicyExemption.ResourceId -ClearExpiration

첫 번째 명령은 Get-AzPolicyExemption cmdlet을 사용하여 PolicyExemption07이라는 정책 예외를 가져옵니다. 명령은 해당 개체를 $PolicyExemption 변수에 저장합니다. 두 번째 명령은 기본 구독에 대한 정책 예외의 만료 날짜 시간을 지웁니다. 업데이트된 예외는 만료되지 않습니다.

매개 변수

-AssignmentScopeValidation

예외의 유효성을 검사할지 아니면 할당 범위 아래에 있는지 여부 옵션입니다.

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

-BackwardCompatible

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

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

-ClearExpiration

정책 예외의 만료 날짜 및 시간을 지울지 여부를 나타냅니다.

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

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

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

-DefaultProfile

DefaultProfile 매개 변수가 작동하지 않습니다. 다른 구독에 대해 cmdlet을 실행하는 경우 사용 가능한 경우 SubscriptionId 매개 변수를 사용합니다.

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

-Description

이 메시지는 정책 위반의 경우 응답의 일부가 됩니다.

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

-DisplayName

정책 할당의 표시 이름입니다.

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

-ExemptionCategory

정책 예외 범주

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

-ExpiresOn

정책 예외의 만료 날짜 및 시간(UTC ISO 8601 형식 yyyy-MM-ddTHH:mm:ssZ)입니다.

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

-Id

삭제할 정책 할당의 ID입니다. '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}' 형식을 사용합니다.

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

-InputObject

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

-Metadata

정책 할당 메타데이터입니다. 메타데이터는 열려 있는 종료된 개체이며 일반적으로 키 값 쌍의 컬렉션입니다.

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

-Name

정책 예외의 이름입니다.

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

-PolicyDefinitionReferenceId

연결된 정책 할당이 정책 집합(이니셔티브)에 대한 경우 정책 정의 참조 ID 목록입니다.

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

-ResourceSelector

리소스 속성별로 정책을 필터링할 리소스 선택기 목록입니다.

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

-Scope

정책 예외의 범위입니다. 유효한 범위는 관리 그룹(형식: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), 구독(형식: '/subscriptions/{subscriptionId}'), 리소스 그룹(형식: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', 또는 리소스(형식: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

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

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

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

입력

IPolicyExemption

SwitchParameter

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

String

String[]

출력

IPolicyExemption

참고

별칭

Set-AzPolicyExemption