New-AzPolicyExemption

Módulo:

Az.Resources

Crea una exención de directiva.

Sintaxis

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

Description

El cmdlet New-AzPolicyExemption crea una exención de directiva. Especifique una asignación de directiva, una categoría de exención y un ámbito.

Ejemplos

Ejemplo 1: Exención de directiva en el nivel de suscripción

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

El primer comando obtiene una suscripción denominada Subscription01 mediante el cmdlet Get-AzSubscription y la almacena en la variable $Subscription. El segundo comando obtiene la asignación de directiva denominada VirtualMachinePolicyAssignment mediante el cmdlet Get-AzPolicyAssignment y la almacena en la variable $Assignment. El comando final excluye la asignación de directiva en $Assignment en el nivel de la suscripción identificada por la cadena de ámbito de la suscripción.

Ejemplo 2: Exención de directiva en el nivel de grupo de recursos

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

El primer comando obtiene un grupo de recursos denominado ResourceGroup11 mediante el cmdlet Get-AzResourceGroup y lo almacena en la variable $ResourceGroup. El segundo comando obtiene la asignación de directiva denominada VirtualMachinePolicyAssignment mediante el cmdlet Get-AzPolicyAssignment y la almacena en la variable $Assignment. El comando final excluye la asignación de directiva en $Assignment en el nivel del grupo de recursos identificado por la propiedad ResourceId de $ResourceGroup.

Parámetros

-ApiVersion

Cuando se establece, indica la versión de la API del proveedor de recursos que se va a usar. Si no se especifica, la versión de la API se determina automáticamente como la más reciente disponible.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Tipo:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Description

Descripción de la nueva exención de directiva.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-DisplayName

Nombre para mostrar de la nueva exención de directiva.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-ExemptionCategory

Categoría de exención de directiva de la nueva exención de directiva. Los valores posibles son Renuncia y Mitigado.

Tipo:	String
Valores aceptados:	Waiver, Mitigated
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-ExpiresOn

Fecha y hora de expiración (en formato ISO 8601 UTC aaaa-MM-ddTHH:mm:ssZ) de la nueva exención de directiva.

Tipo:	Nullable<T>[DateTime]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Metadata

Metadatos de la nueva exención de directiva. Puede ser una ruta de acceso a un archivo que contiene el JSON de metadatos o los metadatos como una cadena JSON.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Name

Nombre de la nueva exención de directiva.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-PolicyAssignment

Identificador de asignación de directiva al que se hace referencia para la nueva exención de directiva.

Tipo:	PsPolicyAssignment
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-PolicyDefinitionReferenceId

Lista de identificadores de referencia de definición de directiva cuando la asignación de directiva asociada es para un conjunto de directivas (iniciativa).

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-Pre

Cuando se establece, indica que el cmdlet debe usar versiones de API de versión preliminar al determinar automáticamente qué versión se va a usar.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Scope

El ámbito de la nueva exención de directiva, por ejemplo, /providers/managementGroups/{managementGroupName}, tiene como valor predeterminado la suscripción actual.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

String

PsPolicyAssignment

String[]

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

Salidas

PsPolicyExemption