Update-AzPolicyExemption

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>]
      [-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
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	False

-ClearExpiration

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

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

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

Typ:	SwitchParameter
Aliases:	cf
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DisplayName

Der Anzeigename der Richtlinienzuweisung.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-ExemptionCategory

Die Richtlinienausnahmekategorie

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	False

-Id

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

Typ:	String
Aliases:	ResourceId
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InputObject

Typ:	IPolicyExemption
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Der Name der Richtlinienausnahme.

Typ:	String
Aliases:	PolicyExemptionName
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	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
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Typ:	SwitchParameter
Aliases:	wi
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	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