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 $NextMonthPerintah 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 -ClearExpirationPerintah 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 MitigatedPerintah 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[]
Nullable<T>[[System.DateTime, System.Private.CoreLib, Version=5.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]