Delen via


Update-AzPolicyExemption

Met deze bewerking wordt een beleidsvrijstelling bijgewerkt met het opgegeven bereik en de opgegeven naam.

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

Description

Met deze bewerking wordt een beleidsvrijstelling bijgewerkt met het opgegeven bereik en de opgegeven naam.

Voorbeelden

Voorbeeld 1: De weergavenaam bijwerken

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

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

Parameters

-AssignmentScopeValidation

De optie of de uitzondering zich op of onder het toewijzingsbereik bevindt.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-BackwardCompatible

Zorgt ervoor dat cmdlet artefacten retourneert met behulp van verouderde indeling waarbij beleidsspecifieke eigenschappen in een eigenschapsverzamelingsobject worden geplaatst.

Type:SwitchParameter
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-ClearExpiration

Geeft aan of de vervaldatum en -tijd van de beleidsvrijstelling moeten worden gewist.

Type:SwitchParameter
Position:Named
standaardwaarde:None
Vereist: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
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

De parameter DefaultProfile is niet functioneel. Gebruik de parameter SubscriptionId indien beschikbaar als u de cmdlet uitvoert voor een ander abonnement.

Type:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Dit bericht maakt deel uit van het antwoord in het geval van een schending van het beleid.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-DisplayName

De weergavenaam van de beleidstoewijzing.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-ExemptionCategory

De categorie beleidsvrijstelling

Type:String
Position:Named
standaardwaarde:None
Vereist: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 beleidsvrijstelling.

Type:Nullable<T>[DateTime]
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-Id

De id van de beleidstoewijzing die moet worden verwijderd. Gebruik de indeling {scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}.

Type:String
Aliases:ResourceId
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

Type:IPolicyExemption
Position:Named
standaardwaarde:None
Vereist:True
Accept pipeline input:True
Accept wildcard characters:False

-Metadata

De metagegevens van de beleidstoewijzing. Metagegevens zijn een geopend object en zijn meestal een verzameling sleutel-waardeparen.

Type:String
Position:Named
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

De naam van de beleidsvrijstelling.

Type:String
Aliases:PolicyExemptionName
Position:Named
standaardwaarde:None
Vereist: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
standaardwaarde:None
Vereist:False
Accept pipeline input:True
Accept wildcard characters:False

-Scope

Het bereik van de beleidsvrijstelling. Geldige bereiken zijn: beheergroep (indeling: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), abonnement (indeling: '/subscriptions/{subscriptionId}'), resourcegroep (indeling: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', of resource (indeling: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

Type:String
Position:Named
standaardwaarde:None
Vereist: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
standaardwaarde:None
Vereist:False
Accept pipeline input:False
Accept wildcard characters:False

Invoerwaarden

IPolicyExemption

SwitchParameter

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

String

String[]

Uitvoerwaarden

IPolicyExemption

Notities

ALIASSEN

Set-AzPolicyExemption