Set-AzPolicyExemption

Hiermee wijzigt u een beleidsvrijstelling.

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

Description

De cmdlet Set-AzPolicyExemption wijzigt een beleidsuitzondering. Geef een uitzondering op id of op naam en bereik op.

Voorbeelden

Voorbeeld 1: De weergavenaam bijwerken

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

Met de eerste opdracht wordt een resourcegroep met de naam ResourceGroup11 ophaalt met behulp van de cmdlet Get-AzResourceGroup. Met de opdracht wordt dat object opgeslagen in de variabele $ResourceGroup. Met de tweede opdracht wordt de beleidsvrijstelling met de naam PolicyExemption07 ophaalt met behulp van de cmdlet Get-AzPolicyExemption. Met de opdracht wordt dat object opgeslagen in de $PolicyExemption variabele. Met de laatste opdracht wordt de weergavenaam bijgewerkt voor de beleidsuitzondering voor de resourcegroep die is geïdentificeerd door de eigenschap ResourceId van $ResourceGroup.

Voorbeeld 2: De vervaldatum bijwerken

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

Met de eerste opdracht wordt de huidige datum/tijd opgehaald met behulp van de cmdlet Get-Date en voegt u 1 maand toe aan de huidige datum/tijd. De opdracht slaat dat object op in de $NextMonth variabele. Met de tweede opdracht wordt de beleidsvrijstelling met de naam PolicyExemption07 ophaalt met behulp van de cmdlet Get-AzPolicyExemption. Met de opdracht wordt dat object opgeslagen in de $PolicyExemption variabele. Met de laatste opdracht wordt de vervaldatum voor de beleidsvrijstelling voor het standaardabonnement bijgewerkt.

Voorbeeld 3: De vervaldatum wissen

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

Met de eerste opdracht wordt de beleidsvrijstelling met de naam PolicyExemption07 ophaalt met behulp van de cmdlet Get-AzPolicyExemption. Met de opdracht wordt dat object opgeslagen in de $PolicyExemption variabele. Met de tweede opdracht wordt de vervaldatum voor de beleidsvrijstelling voor het standaardabonnement gewist. De bijgewerkte uitzondering verloopt nooit.

Voorbeeld 4: De vervaldatumcategorie bijwerken

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

Met de eerste opdracht wordt de beleidsvrijstelling met de naam PolicyExemption07 ophaalt met behulp van de cmdlet Get-AzPolicyExemption. Met de opdracht wordt dat object opgeslagen in de $PolicyExemption variabele. Met de tweede opdracht wordt de vervaldatumcategorie voor de beleidsvrijstelling voor het standaardabonnement bijgewerkt. De bijgewerkte uitzondering verloopt nooit.

Parameters

-ApiVersion

Wanneer deze is ingesteld, geeft u de versie van de resourceprovider-API aan die moet worden gebruikt. Als deze niet is opgegeven, wordt de API-versie automatisch bepaald als de meest recente beschikbare versie.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClearExpiration

Als deze optie is ingesteld, wordt de vervaldatum en -tijd van de bijgewerkte beleidsvrijstelling gewist.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

De beschrijving voor de bijgewerkte beleidsvrijstelling.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DisplayName

De weergavenaam voor de bijgewerkte beleidsvrijstelling.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ExemptionCategory

De beleidsvrijstellingscategorie van de bijgewerkte beleidsvrijstelling. Mogelijke waarden zijn Afstandsverklaring en Beperkt.

Type:String
Accepted values:Waiver, Mitigated
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ExpiresOn

De vervaldatum en -tijd (in UTC ISO 8601-indeling jjjj-MM-ddTHH:mm:ssZ) van de bijgewerkte beleidsvrijstelling.

Type:Nullable<T>[DateTime]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Id

De volledig gekwalificeerde beleidsuitzonderings-id die moet worden bijgewerkt, inclusief het bereik, bijvoorbeeld /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

Het object voor beleidsuitzondering om de uitvoer van een andere cmdlet bij te werken.

Type:PsPolicyExemption
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Metadata

De metagegevens voor de bijgewerkte beleidsvrijstelling. Dit kan een pad zijn naar een bestand met de JSON-metagegevens of de metagegevens als een JSON-tekenreeks.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

De naam van de beleidsvrijstelling die moet worden bijgewerkt.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PolicyDefinitionReferenceId

De lijst met referentie-id's voor beleidsdefinities wanneer de gekoppelde beleidstoewijzing voor een beleidsset (initiatief) is.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Pre

Wanneer deze is ingesteld, geeft u aan dat de cmdlet api-versies van de voorlopige versie moet gebruiken wanneer automatisch wordt bepaald welke versie moet worden gebruikt.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Het bereik van de bijgewerkte beleidsuitzondering, bijvoorbeeld /providers/managementGroups/{managementGroupName}, is standaard ingesteld op het huidige abonnement.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

String

String[]

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

SwitchParameter

PsPolicyExemption

Uitvoerwaarden

PsPolicyExemption