Update-AzPolicyExemption

Referenz

Modul:: Az.Resources

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>]
      [-ResourceSelector <IResourceSelector[]>]
      [-AssignmentScopeValidation <String>]
      [-BackwardCompatible]
      [-DefaultProfile <PSObject>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

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

Update-AzPolicyExemption
      [-ExemptionCategory <String>]
      [-PolicyDefinitionReferenceId <String[]>]
      [-DisplayName <String>]
      [-Description <String>]
      [-ExpiresOn <DateTime>]
      [-ClearExpiration]
      [-Metadata <String>]
      [-ResourceSelector <IResourceSelector[]>]
      [-AssignmentScopeValidation <String>]
      [-BackwardCompatible]
      -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.

Beispiel 5: Ressourcenauswahl aktualisieren

$ResourceSelector = @{Name = "MyLocationSelector"; Selector = @(@{Kind = "resourceLocation"; NotIn = @("eastus", "eastus2")})}
Update-AzPolicyExemption -Name 'VirtualMachineExemption' -ResourceSelector $ResourceSelector

Der erste Befehl erstellt ein Ressourcenauswahlobjekt, das verwendet wird, um die Ausnahme anzugeben, sollte nur für Ressourcen an anderen Standorten als Ost-US oder Ost-US 2 gelten und in der variablen $ResourceSelector gespeichert werden. Der letzte Befehl aktualisiert die Richtlinienausnahme mit dem Namen VirtualMachineExemption mit der durch $ResourceSelector angegebenen Ressourcenauswahl.

Beispiel 6: [Backcompat] Löschen der Ablaufzeit

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

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

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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

-ResourceSelector

Die Ressourcenauswahlliste zum Filtern von Richtlinien nach Ressourceneigenschaften.

Typ:	IResourceSelector[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
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 passiert, 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