Delen via

Update-AzPolicyExemption

  • Referentie
Module:
Az.Resources

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

Syntaxis

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

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: Resourceselector bijwerken

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

Met de eerste opdracht maakt u een resourceselectorobject dat wordt gebruikt om de uitzondering op te geven, alleen van toepassing op resources op andere locaties dan VS - oost of VS - oost 2 en slaat het op in de variabele $ResourceSelector. Met de laatste opdracht wordt de beleidsuitzondering VirtualMachineExemption bijgewerkt met de resourceselector die is opgegeven door $ResourceSelector.

Voorbeeld 6: [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
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ClearExpiration

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

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Confirm

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

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Aliassen:AzureRMContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Description

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

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DisplayName

De weergavenaam van de beleidstoewijzing.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ExemptionCategory

De categorie beleidsvrijstelling

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren: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
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Id

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

Type:String
Aliassen:ResourceId
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-InputObject

Type:IPolicyExemption
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Metadata

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

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

De naam van de beleidsvrijstelling.

Type:String
Aliassen:PolicyExemptionName
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren: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
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceSelector

De lijst met resourcekiezers om beleidsregels te filteren op resource-eigenschappen.

Type:IResourceSelector[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

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

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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