Set-AzPolicyExemption

Modul:

Az.Resources

Ändert eine Richtlinienausnahme.

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

Beschreibung

Das Cmdlet Set-AzPolicyExemption ändert eine Richtlinienausnahme. Geben Sie eine Ausnahme nach ID oder nach Name und Bereich an.

Beispiele

Beispiel 1: Aktualisieren des Anzeigenamens

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

Der erste Befehl ruft eine Ressourcengruppe namens ResourceGroup11 mithilfe des Cmdlets "Get-AzResourceGroup" ab. Der Befehl speichert dieses Objekt in der $ResourceGroup Variablen. Der zweite Befehl ruft die Richtlinienausnahme mit dem Namen "PolicyExemption07" mithilfe des Cmdlets "Get-AzPolicyExemption" ab. Der Befehl speichert dieses Objekt in der $PolicyExemption Variablen. Der letzte Befehl aktualisiert den Anzeigenamen für die Richtlinienausnahme für die Ressourcengruppe, die durch die ResourceId-Eigenschaft von $ResourceGroup identifiziert wird.

Beispiel 2: Aktualisieren der Ablaufzeit

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

Der erste Befehl ruft die aktuelle Datumszeit mithilfe des Cmdlets "Get-Date" ab und fügt 1 Monat zur aktuellen Datumszeit hinzu. Der Befehl speichert dieses Objekt in der $NextMonth Variablen. Der zweite Befehl ruft die Richtlinienausnahme mit dem Namen "PolicyExemption07" mithilfe des Cmdlets "Get-AzPolicyExemption" ab. Der Befehl speichert dieses Objekt in der $PolicyExemption Variablen. Der letzte Befehl aktualisiert die Ablaufdatumszeit für die Richtlinienausnahme für das Standardabonnement.

Beispiel 3: Löschen der Ablaufzeit

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

Der erste Befehl ruft die Richtlinienausnahme mit dem Namen "PolicyExemption07" mithilfe des Cmdlets "Get-AzPolicyExemption" ab. Der Befehl speichert dieses Objekt in der $PolicyExemption Variablen. Der zweite Befehl löscht die Ablaufdatumszeit für die Richtlinienausnahme für das Standardabonnement. Die aktualisierte Ausnahme läuft nie ab.

Beispiel 4: Aktualisieren der Ablaufkategorie

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

Der erste Befehl ruft die Richtlinienausnahme mit dem Namen "PolicyExemption07" mithilfe des Cmdlets "Get-AzPolicyExemption" ab. Der Befehl speichert dieses Objekt in der $PolicyExemption Variablen. Der zweite Befehl aktualisiert die Ablaufkategorie für die Richtlinienausnahme für das Standardabonnement. Die aktualisierte Ausnahme läuft nie ab.

Parameter

-ApiVersion

Wenn festgelegt, gibt die Version der zu verwendenden Ressourcenanbieter-API an. Wenn nicht angegeben, wird die API-Version automatisch als neueste verfügbare Version bestimmt.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ClearExpiration

Wenn diese Option festgelegt ist, wird das Ablaufdatum und die Uhrzeit für die aktualisierte Richtlinienausnahme gelöscht.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:	IAzureContextContainer
Aliase:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Description

Die Beschreibung für die aktualisierte Richtlinienausnahme.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-DisplayName

Der Anzeigename für die aktualisierte Richtlinienausnahme.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-ExemptionCategory

Die Richtlinienfreistellungskategorie der aktualisierten Richtlinienausnahme. Mögliche Werte sind Verzicht und Entschärfung.

Typ:	String
Zulässige Werte:	Waiver, Mitigated
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-ExpiresOn

Das Ablaufdatum und die Uhrzeit (im UTC ISO 8601-Format yyyy-MM-ddTHH:mm:ssZ) der aktualisierten Richtlinienausnahme.

Typ:	Nullable<T>[DateTime]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Id

Die vollqualifizierte Richtlinienausnahme-ID, die aktualisiert werden soll, einschließlich des Umfangs, z. B. /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Authorization/policyExemptions/{policyExemptionName}.

Typ:	String
Aliase:	ResourceId
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-InputObject

Das Richtlinienausnahmeobjekt, das aktualisiert werden soll, das von einem anderen Cmdlet ausgegeben wurde.

Typ:	PsPolicyExemption
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Metadata

Die Metadaten für die aktualisierte Richtlinienausnahme. Dies kann entweder ein Pfad zu einer Datei sein, die die Metadaten-JSON enthält, oder die Metadaten als JSON-Zeichenfolge.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Name

Der Name der Richtlinie, die aktualisiert werden soll.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-PolicyDefinitionReferenceId

Die Liste der Richtliniendefinitionsreferenz-ID, wenn die zugeordnete Richtlinienzuweisung für einen Richtliniensatz (Initiative) vorgesehen ist.

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Pre

Wenn festgelegt, gibt an, dass das Cmdlet Vorabversionen von API-Versionen verwenden soll, wenn automatisch bestimmt wird, welche Version verwendet werden soll.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Scope

Der Umfang der aktualisierten Richtlinienausnahme, z. B. "/providers/managementGroups/{managementGroupName}", ist standardmäßig auf das aktuelle Abonnement festgelegt.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

String

String[]

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

SwitchParameter

PsPolicyExemption

Ausgaben

PsPolicyExemption