Set-AzPolicyExemption

Referensi

Modul:: Az.Resources

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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearExpiration

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Deskripsi untuk pengecualian kebijakan yang diperbarui.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DisplayName

Nama tampilan untuk pengecualian kebijakan yang diperbarui.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ExemptionCategory

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

Type:	String
Accepted values:	Waiver, Mitigated
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ExpiresOn

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

Type:	Nullable<T>[DateTime]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Id

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

Type:	String
Aliases:	ResourceId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InputObject

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

Type:	PsPolicyExemption
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Metadata

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Nama pengecualian kebijakan yang akan diperbarui.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PolicyDefinitionReferenceId

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

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Pre

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Input

String

String[]

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

SwitchParameter

PsPolicyExemption

Output