Update-AzPolicyExemption

Módulo:

Az.Resources

Esta operación actualiza una exención de directiva con el ámbito y el nombre especificados.

Sintaxis

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

Esta operación actualiza una exención de directiva con el ámbito y el nombre especificados.

Ejemplos

Ejemplo 1: Actualización del nombre para mostrar

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

El primer comando obtiene un grupo de recursos denominado ResourceGroup11 mediante el cmdlet Get-AzResourceGroup. El comando almacena ese objeto en la variable $ResourceGroup. El segundo comando obtiene la exención de directiva denominada PolicyExemption07 mediante el cmdlet Get-AzPolicyExemption. El comando almacena ese objeto en la variable $PolicyExemption. El comando final actualiza el nombre para mostrar en la exención de directiva en el grupo de recursos identificado por la propiedad ResourceId de $ResourceGroup.

Ejemplo 2: Actualización de la fecha y hora de expiración

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

El primer comando obtiene la fecha y hora actual mediante el cmdlet Get-Date y agrega 1 mes a la fecha y hora actual El comando almacena ese objeto en la variable $NextMonth. El segundo comando obtiene la exención de directiva denominada PolicyExemption07 mediante el cmdlet Get-AzPolicyExemption. El comando almacena ese objeto en la variable $PolicyExemption. El comando final actualiza la fecha de expiración de la exención de directiva en la suscripción predeterminada.

Ejemplo 3: Borrar la fecha y hora de expiración

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

El primer comando obtiene la exención de directiva denominada PolicyExemption07 mediante el cmdlet Get-AzPolicyExemption. El comando almacena ese objeto en la variable $PolicyExemption. El segundo comando borra la fecha de expiración de la exención de directiva en la suscripción predeterminada. La exención actualizada nunca expirará.

Ejemplo 4: Actualización de la categoría de expiración

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

El primer comando obtiene la exención de directiva denominada PolicyExemption07 mediante el cmdlet Get-AzPolicyExemption. El comando almacena ese objeto en la variable $PolicyExemption. El segundo comando actualiza la categoría de expiración de la exención de directiva en la suscripción predeterminada. La exención actualizada nunca expirará.

El primer comando obtiene la fecha y hora actual mediante el cmdlet Get-Date y agrega 1 mes a la fecha y hora actual El comando almacena ese objeto en la variable $NextMonth. El segundo comando obtiene la exención de directiva denominada PolicyExemption07 mediante el cmdlet Get-AzPolicyExemption. El comando almacena ese objeto en la variable $PolicyExemption. El comando final actualiza la fecha de expiración de la exención de directiva en la suscripción predeterminada.

Ejemplo 5: Actualización del selector de recursos

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

El primer comando crea un objeto selector de recursos que se usará para especificar la exención solo se debe aplicar a los recursos de ubicaciones que no sean Este de EE. UU. o Este de EE. UU. 2 y los almacena en la variable $ResourceSelector. El comando final actualiza la exención de directiva denominada VirtualMachineExemption con el selector de recursos especificado por $ResourceSelector.

Ejemplo 6: [Backcompat] Borrar la fecha y hora de expiración

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

El primer comando obtiene la exención de directiva denominada PolicyExemption07 mediante el cmdlet Get-AzPolicyExemption. El comando almacena ese objeto en la variable $PolicyExemption. El segundo comando borra la fecha de expiración de la exención de directiva en la suscripción predeterminada. La exención actualizada nunca expirará.

Parámetros

-AssignmentScopeValidation

Opción si la validación de la exención está en o en el ámbito de asignación.

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

-BackwardCompatible

Hace que el cmdlet devuelva artefactos mediante la colocación de propiedades específicas de la directiva en un objeto contenedor de propiedades.

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

-ClearExpiration

Indica si se va a borrar la fecha y hora de expiración de la exención de directiva.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
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

El parámetro DefaultProfile no es funcional. Use el parámetro SubscriptionId cuando esté disponible si ejecuta el cmdlet en otra suscripción.

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

-Description

Este mensaje formará parte de la respuesta en caso de infracció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 asignació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

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
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 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

-Id

Identificador de la asignación de directiva que se va a eliminar. Use el formato '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'.

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

-InputObject

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

-Metadata

Metadatos de asignación de directiva. Los metadatos son un objeto terminado abierto y normalmente es una colección de pares clave-valor.

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 exención de directiva.

Tipo:	String
Alias:	PolicyExemptionName
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

-ResourceSelector

Lista del selector de recursos para filtrar las directivas por propiedades de recursos.

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

-Scope

Ámbito de la exención de directiva. Los ámbitos válidos son: grupo de administración (formato: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), suscripción (formato: '/subscriptions/{subscriptionId}'), grupo de recursos (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', o recurso (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

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

IPolicyExemption

SwitchParameter

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

String

String[]

Salidas

IPolicyExemption

Notas

ALIAS

Set-AzPolicyExemption