Freigeben über


Update-AzPolicyExemption

Dieser Vorgang aktualisiert eine Richtlinienausnahme mit dem angegebenen Bereich und Namen.

Syntax

Update-AzPolicyExemption
      -Name <String>
      [-Scope <String>]
      [-ExemptionCategory <String>]
      [-PolicyDefinitionReferenceId <String[]>]
      [-DisplayName <String>]
      [-Description <String>]
      [-ExpiresOn <DateTime>]
      [-ClearExpiration]
      [-Metadata <String>]
      [-BackwardCompatible]
      [-AssignmentScopeValidation <String>]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzPolicyExemption
      [-ExemptionCategory <String>]
      [-PolicyDefinitionReferenceId <String[]>]
      -Id <String>
      [-DisplayName <String>]
      [-Description <String>]
      [-ExpiresOn <DateTime>]
      [-ClearExpiration]
      [-Metadata <String>]
      [-BackwardCompatible]
      [-AssignmentScopeValidation <String>]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzPolicyExemption
      [-ExemptionCategory <String>]
      [-PolicyDefinitionReferenceId <String[]>]
      [-DisplayName <String>]
      [-Description <String>]
      [-ExpiresOn <DateTime>]
      [-ClearExpiration]
      [-Metadata <String>]
      [-BackwardCompatible]
      [-AssignmentScopeValidation <String>]
      -InputObject <IPolicyExemption>
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Dieser Vorgang aktualisiert eine Richtlinienausnahme mit dem angegebenen Bereich und Namen.

Beispiele

Beispiel 1: Aktualisieren des Anzeigenamens

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
 $PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07' -Scope $ResourceGroup.ResourceId
Update-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'
Update-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'
Update-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'
Update-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.

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 5: [Backcompat] 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.

Parameter

-AssignmentScopeValidation

Die Option, ob die Freistellung im Zuordnungsbereich oder unter dem Zuordnungsbereich liegt.

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

-BackwardCompatible

Bewirkt, dass cmdlet Artefakte mithilfe von richtlinienspezifischen Eigenschaften im Legacyformat in einem Eigenschaftenbehälterobjekt zurückgibt.

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

-ClearExpiration

Gibt an, ob das Ablaufdatum und die Uhrzeit der Richtlinienfreistellung gelöscht werden sollen.

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

Der Parameter DefaultProfile ist nicht funktionsfähig. Verwenden Sie den Parameter "SubscriptionId", wenn sie verfügbar ist, wenn Sie das Cmdlet für ein anderes Abonnement ausführen.

Typ:PSObject
Aliase:AzureRMContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Diese Nachricht wird teil der Antwort im Falle eines Richtlinienverstoßes sein.

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

-DisplayName

Der Anzeigename der Richtlinienzuweisung.

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

-ExemptionCategory

Die Richtlinienausnahmekategorie

Typ:String
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 Richtlinienausnahme.

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

-Id

Die ID der zu löschenden Richtlinienzuweisung. Verwenden Sie das Format "{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}".

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

-InputObject

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

-Metadata

Die Metadaten der Richtlinienzuweisung. Metadaten sind ein offenes beendetes Objekt und sind in der Regel eine Sammlung von Schlüsselwertpaaren.

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

-Name

Der Name der Richtlinienausnahme.

Typ:String
Aliase:PolicyExemptionName
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

-Scope

Der Anwendungsbereich der Richtlinienfreistellung. Gültige Bereiche sind: Verwaltungsgruppe (Format: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), Abonnement (Format: '/subscriptions/{subscriptionId}'), Ressourcengruppe (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', oder Ressource (Format: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

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

IPolicyExemption

SwitchParameter

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

String

String[]

Ausgaben

IPolicyExemption

Hinweise

ALIASE

Set-AzPolicyExemption