Set-AzPolicyExemption
Ä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 $NextMonthDer 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 -ClearExpirationDer 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 MitigatedDer 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClearExpiration
Wenn diese Option festgelegt ist, wird das Ablaufdatum und die Uhrzeit für die aktualisierte Richtlinienausnahme gelöscht.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
| Type: | IAzureContextContainer |
| Aliases: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
Die Beschreibung für die aktualisierte Richtlinienausnahme.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-DisplayName
Der Anzeigename für die aktualisierte Richtlinienausnahme.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ExemptionCategory
Die Richtlinienfreistellungskategorie der aktualisierten Richtlinienausnahme. Mögliche Werte sind Verzicht und Entschärfung.
| Type: | String |
| Accepted values: | Waiver, Mitigated |
| Position: | Named |
| Default value: | None |
| Required: | 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 aktualisierten Richtlinienausnahme.
| Type: | Nullable<T>[DateTime] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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}.
| Type: | String |
| Aliases: | ResourceId |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-InputObject
Das Richtlinienausnahmeobjekt, das aktualisiert werden soll, das von einem anderen Cmdlet ausgegeben wurde.
| Type: | PsPolicyExemption |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Der Name der Richtlinie, die aktualisiert werden soll.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | 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.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Pre
Wenn festgelegt, gibt an, dass das Cmdlet Vorabversionen von API-Versionen verwenden soll, wenn automatisch bestimmt wird, welche Version verwendet werden soll.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Scope
Der Umfang der aktualisierten Richtlinienausnahme, z. B. "/providers/managementGroups/{managementGroupName}", ist standardmäßig auf das aktuelle Abonnement festgelegt.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | 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.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Eingaben
String[]
Nullable<T>[[System.DateTime, System.Private.CoreLib, Version=5.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]
Ausgaben
Azure PowerShell
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für