New-AzPolicyExemption

  • Riferimento
Modulo:
Az.Resources

Crea un'esenzione dai criteri.

Sintassi

New-AzPolicyExemption
   -Name <String>
   [-Scope <String>]
   [-DisplayName <String>]
   [-Description <String>]
   -ExemptionCategory <String>
   -PolicyAssignment <PsPolicyAssignment>
   [-PolicyDefinitionReferenceId <String[]>]
   [-ExpiresOn <DateTime>]
   [-Metadata <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet New-AzPolicyExemption crea un'esenzione dei criteri. Specificare un'assegnazione di criteri, una categoria di esenzione e un ambito.

Esempio

Esempio 1: Esenzione dei criteri a livello di sottoscrizione

$Subscription = Get-AzSubscription -SubscriptionName 'Subscription01'
$Assignment = Get-AzPolicyAssignment -Name 'VirtualMachinePolicyAssignment'
New-AzPolicyExemption -Name 'VirtualMachinePolicyExemption' -PolicyAssignment $Assignment -Scope "/subscriptions/$($Subscription.Id)" -ExemptionCategory Waiver

Il primo comando ottiene una sottoscrizione denominata Subscription01 usando il cmdlet Get-AzSubscription e la archivia nella variabile $Subscription. Il secondo comando ottiene l'assegnazione di criteri denominata VirtualMachinePolicyAssignment usando il cmdlet Get-AzPolicyAssignment e la archivia nella variabile $Assignment. Il comando finale esenta l'assegnazione dei criteri in $Assignment al livello della sottoscrizione identificata dalla stringa di ambito della sottoscrizione.

Esempio 2: Esenzione dei criteri a livello di gruppo di risorse

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
$Assignment = Get-AzPolicyAssignment -Name 'VirtualMachinePolicyAssignment'
New-AzPolicyExemption -Name 'VirtualMachinePolicyAssignment' -PolicyAssignment $Assignment -Scope $ResourceGroup.ResourceId -ExemptionCategory Mitigated

Il primo comando ottiene un gruppo di risorse denominato ResourceGroup11 usando il cmdlet Get-AzResourceGroup e lo archivia nella variabile $ResourceGroup. Il secondo comando ottiene l'assegnazione di criteri denominata VirtualMachinePolicyAssignment usando il cmdlet Get-AzPolicyAssignment e la archivia nella variabile $Assignment. Il comando finale esenta l'assegnazione dei criteri in $Assignment a livello del gruppo di risorse identificato dalla proprietà ResourceId di $ResourceGroup.

Parametri

-ApiVersion

Se impostato, indica la versione dell'API del provider di risorse da usare. Se non specificato, la versione dell'API viene determinata automaticamente come la versione più recente disponibile.

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

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

-Description

Descrizione per la nuova esenzione dei criteri.

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

-DisplayName

Nome visualizzato per la nuova esenzione dei criteri.

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

-ExemptionCategory

Categoria di esenzione dei criteri della nuova esenzione dei criteri. I valori possibili sono Rinuncia e Attenuazione.

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

-ExpiresOn

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

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

-Metadata

Metadati per la nuova esenzione dei criteri. Può trattarsi di un percorso di un file contenente i metadati JSON o dei metadati come stringa JSON.

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

-Name

Nome della nuova esenzione dei criteri.

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

-PolicyAssignment

ID assegnazione criteri di riferimento per la nuova esenzione dei criteri.

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

-PolicyDefinitionReferenceId

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

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

-Pre

Se impostato, indica che il cmdlet deve usare versioni API non definitive quando si determina automaticamente quale versione usare.

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

-Scope

L'ambito della nuova esenzione dei criteri, ad esempio /providers/managementGroups/{managementGroupName}, usa per impostazione predefinita la sottoscrizione corrente.

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

-WhatIf

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

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

Input

String

PsPolicyAssignment

String[]

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

Output

PsPolicyExemption