Set-AzPolicyExemption
정책 예외를 수정합니다.
Syntax
Set-AzPolicyExemption
-Name <String>
[-Scope <String>]
[-DisplayName <String>]
[-Description <String>]
[-ExemptionCategory <String>]
[-PolicyDefinitionReferenceId <String[]>]
[-ExpiresOn <DateTime>]
[-ClearExpiration]
[-Metadata <String>]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzPolicyExemption
-Id <String>
[-DisplayName <String>]
[-Description <String>]
[-ExemptionCategory <String>]
[-PolicyDefinitionReferenceId <String[]>]
[-ExpiresOn <DateTime>]
[-ClearExpiration]
[-Metadata <String>]
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzPolicyExemption
[-DisplayName <String>]
[-Description <String>]
[-ExemptionCategory <String>]
[-PolicyDefinitionReferenceId <String[]>]
[-ExpiresOn <DateTime>]
[-ClearExpiration]
[-Metadata <String>]
-InputObject <PsPolicyExemption>
[-ApiVersion <String>]
[-Pre]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Set-AzPolicyExemption cmdlet은 정책 예외를 수정합니다. ID 또는 이름 및 범위별로 예외를 지정합니다.
예제
예제 1: 표시 이름 업데이트
$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07' -Scope $ResourceGroup.ResourceId
Set-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'
Set-AzPolicyExemption -Id $PolicyExemption.ResourceId -ExpiresOn $NextMonth
첫 번째 명령은 Get-Date cmdlet을 사용하여 현재 날짜 시간을 가져오고 현재 날짜 시간에 1개월을 추가합니다. 명령은 해당 개체를 $NextMonth 변수에 저장합니다. 두 번째 명령은 Get-AzPolicyExemption cmdlet을 사용하여 PolicyExemption07이라는 정책 예외를 가져옵니다. 명령은 해당 개체를 $PolicyExemption 변수에 저장합니다. 최종 명령은 기본 구독에 대한 정책 예외의 만료 날짜 시간을 업데이트합니다.
예제 3: 만료 날짜 시간 지우기
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Set-AzPolicyExemption -Id $PolicyExemption.ResourceId -ClearExpiration
첫 번째 명령은 Get-AzPolicyExemption cmdlet을 사용하여 PolicyExemption07이라는 정책 예외를 가져옵니다. 명령은 해당 개체를 $PolicyExemption 변수에 저장합니다. 두 번째 명령은 기본 구독에 대한 정책 예외의 만료 날짜 시간을 지웁니다. 업데이트된 예외는 만료되지 않습니다.
예제 4: 만료 범주 업데이트
$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Set-AzPolicyExemption -Id $PolicyExemption.ResourceId -ExemptionCategory Mitigated
첫 번째 명령은 Get-AzPolicyExemption cmdlet을 사용하여 PolicyExemption07이라는 정책 예외를 가져옵니다. 명령은 해당 개체를 $PolicyExemption 변수에 저장합니다. 두 번째 명령은 기본 구독에서 정책 예외에 대한 만료 범주를 업데이트합니다. 업데이트된 예외는 만료되지 않습니다.
매개 변수
-ApiVersion
설정되면 사용할 리소스 공급자 API의 버전을 나타냅니다. 지정하지 않으면 API 버전이 사용 가능한 최신 버전으로 자동으로 결정됩니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClearExpiration
설정된 경우 이 스위치는 업데이트된 정책 예외의 만료 날짜 및 시간을 지웁니다.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.
Type: | SwitchParameter |
Aliases: | cf |
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 |
-Description
업데이트된 정책 예외에 대한 설명입니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DisplayName
업데이트된 정책 예외의 표시 이름입니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ExemptionCategory
업데이트된 정책 예외의 정책 예외 범주입니다. 가능한 값은 면제 및 완화입니다.
Type: | String |
Accepted values: | Waiver, Mitigated |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ExpiresOn
업데이트된 정책 예외의 만료 날짜 및 시간(UTC ISO 8601 형식 yyyy-MM-ddTHH:mm:ssZ)입니다.
Type: | Nullable<T>[DateTime] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Id
/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Authorization/policyExemptions/{policyExemptionName}을 포함하여 업데이트할 정규화된 정책 예외 ID입니다.
Type: | String |
Aliases: | ResourceId |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InputObject
다른 cmdlet에서 출력된 업데이트할 정책 예외 개체입니다.
Type: | PsPolicyExemption |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Metadata
업데이트된 정책 예외에 대한 메타데이터입니다. 이 경로는 메타데이터 JSON을 포함하는 파일의 경로이거나 메타데이터를 JSON 문자열로 사용할 수 있습니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
업데이트할 정책 예외의 이름입니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PolicyDefinitionReferenceId
연결된 정책 할당이 정책 집합(이니셔티브)에 대한 경우 정책 정의 참조 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
업데이트된 정책 예외의 범위(예: /providers/managementGroups/{managementGroupName})는 기본적으로 현재 구독으로 설정됩니다.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
입력
String[]
Nullable<T>[[System.DateTime, System.Private.CoreLib, Version=5.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]