Update-AzPolicyExemption

Modulo:

Az.Resources

Questa operazione aggiorna un'esenzione dei criteri con l'ambito e il nome specificati.

Sintassi

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

Descrizione

Questa operazione aggiorna un'esenzione dei criteri con l'ambito e il nome specificati.

Esempio

Esempio 1: Aggiornare il nome visualizzato

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

Il primo comando ottiene un gruppo di risorse denominato ResourceGroup11 usando il cmdlet Get-AzResourceGroup. Il comando archivia l'oggetto nella variabile $ResourceGroup. Il secondo comando ottiene l'esenzione dei criteri denominata PolicyExemption07 usando il cmdlet Get-AzPolicyExemption. Il comando archivia l'oggetto nella variabile $PolicyExemption. Il comando finale aggiorna il nome visualizzato per l'esenzione dei criteri nel gruppo di risorse identificato dalla proprietà ResourceId di $ResourceGroup.

Esempio 2: Aggiornare l'ora di scadenza

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

Il primo comando ottiene la data corrente usando il cmdlet Get-Date e aggiunge 1 mese all'ora corrente Il comando archivia l'oggetto nella variabile $NextMonth. Il secondo comando ottiene l'esenzione dei criteri denominata PolicyExemption07 usando il cmdlet Get-AzPolicyExemption. Il comando archivia l'oggetto nella variabile $PolicyExemption. Il comando finale aggiorna l'ora di scadenza per l'esenzione dei criteri nella sottoscrizione predefinita.

Esempio 3: Cancellare l'ora di scadenza

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

Il primo comando ottiene l'esenzione dei criteri denominata PolicyExemption07 usando il cmdlet Get-AzPolicyExemption. Il comando archivia l'oggetto nella variabile $PolicyExemption. Il secondo comando cancella la data di scadenza per l'esenzione dei criteri nella sottoscrizione predefinita. L'esenzione aggiornata non scadrà mai.

Esempio 4: Aggiornare la categoria di scadenza

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

Il primo comando ottiene l'esenzione dei criteri denominata PolicyExemption07 usando il cmdlet Get-AzPolicyExemption. Il comando archivia l'oggetto nella variabile $PolicyExemption. Il secondo comando aggiorna la categoria di scadenza per l'esenzione dei criteri nella sottoscrizione predefinita. L'esenzione aggiornata non scadrà mai.

Il primo comando ottiene la data corrente usando il cmdlet Get-Date e aggiunge 1 mese all'ora corrente Il comando archivia l'oggetto nella variabile $NextMonth. Il secondo comando ottiene l'esenzione dei criteri denominata PolicyExemption07 usando il cmdlet Get-AzPolicyExemption. Il comando archivia l'oggetto nella variabile $PolicyExemption. Il comando finale aggiorna l'ora di scadenza per l'esenzione dei criteri nella sottoscrizione predefinita.

Esempio 5: Aggiornare il selettore di risorse

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

Il primo comando crea un oggetto selettore di risorse che verrà usato per specificare l'esenzione deve essere applicato solo alle risorse in località diverse da Stati Uniti orientali o Stati Uniti orientali 2 e le archivia nella variabile $ResourceSelector. Il comando finale aggiorna l'esenzione dei criteri denominata VirtualMachineExemption con il selettore di risorse specificato da $ResourceSelector.

Esempio 6: [Backcompat] Cancellare la data di scadenza

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

Il primo comando ottiene l'esenzione dei criteri denominata PolicyExemption07 usando il cmdlet Get-AzPolicyExemption. Il comando archivia l'oggetto nella variabile $PolicyExemption. Il secondo comando cancella la data di scadenza per l'esenzione dei criteri nella sottoscrizione predefinita. L'esenzione aggiornata non scadrà mai.

Parametri

-AssignmentScopeValidation

Opzione che indica se convalidare l'esenzione si trova nell'ambito dell'assegnazione o meno.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-BackwardCompatible

Fa sì che il cmdlet restituisca artefatti usando il formato legacy inserendo proprietà specifiche dei criteri in un oggetto contenitore delle proprietà.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ClearExpiration

Indica se cancellare la data e l'ora di scadenza dell'esenzione dei criteri.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DefaultProfile

Il parametro DefaultProfile non è funzionale. Usare il parametro SubscriptionId quando disponibile se si esegue il cmdlet su una sottoscrizione diversa.

Tipo:	PSObject
Alias:	AzureRMContext, AzureCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Description

Questo messaggio farà parte della risposta in caso di violazione dei criteri.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-DisplayName

Nome visualizzato dell'assegnazione dei criteri.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-ExemptionCategory

Categoria di esenzione dei criteri

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-ExpiresOn

Data e ora di scadenza (in formato UTC ISO 8601 aaaa-MM-ggTHH:mm:ssZ) dell'esenzione dei criteri.

Tipo:	Nullable<T>[DateTime]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Id

ID dell'assegnazione di criteri da eliminare. Usare il formato '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'.

Tipo:	String
Alias:	ResourceId
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-InputObject

Tipo:	IPolicyExemption
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Metadata

Metadati dell'assegnazione dei criteri. I metadati sono un oggetto aperto terminato ed è in genere una raccolta di coppie chiave-valore.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Name

Nome dell'esenzione dei criteri.

Tipo:	String
Alias:	PolicyExemptionName
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-PolicyDefinitionReferenceId

Elenco ID riferimento definizione criteri quando l'assegnazione di criteri associata è per un set di criteri (iniziativa).

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-ResourceSelector

Elenco di selettore di risorse per filtrare i criteri in base alle proprietà delle risorse.

Tipo:	IResourceSelector[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Scope

Ambito dell'esenzione dei criteri. Gli ambiti validi sono: gruppo di gestione (formato: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), sottoscrizione (formato: '/subscriptions/{subscriptionId}'), gruppo di risorse (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', o risorsa (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:	SwitchParameter
Alias:	wi
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

IPolicyExemption

SwitchParameter

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

String

String[]

Output

IPolicyExemption

Note

ALIAS

Set-AzPolicyExemption