Bagikan melalui


Set-AzPolicyExemption

Memodifikasi pengecualian kebijakan.

Sintaks

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>]

Deskripsi

Cmdlet Set-AzPolicyExemption memodifikasi pengecualian kebijakan. Tentukan pengecualian menurut ID atau menurut nama dan cakupan.

Contoh

Contoh 1: Memperbarui nama tampilan

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

Perintah pertama mendapatkan grup sumber daya bernama ResourceGroup11 dengan menggunakan cmdlet Get-AzResourceGroup. Perintah menyimpan objek tersebut dalam variabel $ResourceGroup. Perintah kedua mendapatkan pengecualian kebijakan bernama PolicyExemption07 dengan menggunakan cmdlet Get-AzPolicyExemption. Perintah menyimpan objek tersebut dalam variabel $PolicyExemption. Perintah akhir memperbarui nama tampilan pada pengecualian kebijakan pada grup sumber daya yang diidentifikasi oleh properti ResourceId $ResourceGroup.

Contoh 2: Memperbarui waktu tanggal kedaluwarsa

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

Perintah pertama mendapatkan waktu tanggal saat ini dengan menggunakan cmdlet Get-Date dan menambahkan 1 bulan ke waktu tanggal saat ini Perintah menyimpan objek tersebut dalam variabel $NextMonth. Perintah kedua mendapatkan pengecualian kebijakan bernama PolicyExemption07 dengan menggunakan cmdlet Get-AzPolicyExemption. Perintah menyimpan objek tersebut dalam variabel $PolicyExemption. Perintah akhir memperbarui waktu tanggal kedaluwarsa untuk pengecualian kebijakan pada langganan default.

Contoh 3: Hapus waktu tanggal kedaluwarsa

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

Perintah pertama mendapatkan pengecualian kebijakan bernama PolicyExemption07 dengan menggunakan cmdlet Get-AzPolicyExemption. Perintah menyimpan objek tersebut dalam variabel $PolicyExemption. Perintah kedua menghapus waktu tanggal kedaluwarsa untuk pengecualian kebijakan pada langganan default. Pengecualian yang diperbarui tidak akan pernah kedaluwarsa.

Contoh 4: Memperbarui kategori kedaluwarsa

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

Perintah pertama mendapatkan pengecualian kebijakan bernama PolicyExemption07 dengan menggunakan cmdlet Get-AzPolicyExemption. Perintah menyimpan objek tersebut dalam variabel $PolicyExemption. Perintah kedua memperbarui kategori kedaluwarsa untuk pengecualian kebijakan pada langganan default. Pengecualian yang diperbarui tidak akan pernah kedaluwarsa.

Parameter

-ApiVersion

Saat diatur, menunjukkan versi API penyedia sumber daya yang akan digunakan. Jika tidak ditentukan, versi API secara otomatis ditentukan sebagai yang terbaru yang tersedia.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-ClearExpiration

Jika diatur, sakelar ini menghapus tanggal dan waktu kedaluwarsa pada pengecualian kebijakan yang diperbarui.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Jenis:SwitchParameter
Alias:cf
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-DefaultProfile

Kredensial, akun, penyewa, dan langganan yang digunakan untuk komunikasi dengan Azure.

Jenis:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Description

Deskripsi untuk pengecualian kebijakan yang diperbarui.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-DisplayName

Nama tampilan untuk pengecualian kebijakan yang diperbarui.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ExemptionCategory

Kategori pengecualian kebijakan dari pengecualian kebijakan yang diperbarui. Nilai yang mungkin adalah Pengabaian dan Dimitigasi.

Jenis:String
Nilai yang diterima:Waiver, Mitigated
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-ExpiresOn

Tanggal dan waktu kedaluwarsa (dalam format UTC ISO 8601 yyyy-MM-ddTHH:mm:ssZ) dari pengecualian kebijakan yang diperbarui.

Jenis:Nullable<T>[DateTime]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Id

Id pengecualian kebijakan yang sepenuhnya memenuhi syarat untuk diperbarui, termasuk cakupan, misalnya /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Authorization/policyExemptions/{policyExemptionName}.

Jenis:String
Alias:ResourceId
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-InputObject

Objek pengecualian kebijakan untuk memperbarui yang merupakan output dari cmdlet lain.

Jenis:PsPolicyExemption
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-Metadata

Metadata untuk pengecualian kebijakan yang diperbarui. Ini bisa menjadi jalur ke file yang berisi metadata JSON, atau metadata sebagai string JSON.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Name

Nama pengecualian kebijakan yang akan diperbarui.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:True
Terima input alur:True
Terima karakter wildcard:False

-PolicyDefinitionReferenceId

Daftar ID referensi definisi kebijakan saat penetapan kebijakan terkait adalah untuk kumpulan kebijakan (inisiatif).

Jenis:String[]
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-Pre

Saat diatur, menunjukkan bahwa cmdlet harus menggunakan versi API pra-rilis saat secara otomatis menentukan versi mana yang akan digunakan.

Jenis:SwitchParameter
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

-Scope

Cakupan pengecualian kebijakan yang diperbarui, misalnya /providers/managementGroups/{managementGroupName}, default ke langganan saat ini.

Jenis:String
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:True
Terima karakter wildcard:False

-WhatIf

Menunjukkan apa yang akan terjadi jika cmdlet berjalan. Cmdlet tidak dijalankan.

Jenis:SwitchParameter
Alias:wi
Position:Named
Nilai default:None
Diperlukan:False
Terima input alur:False
Terima karakter wildcard:False

Input

String

String[]

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

SwitchParameter

PsPolicyExemption

Output

PsPolicyExemption