Compartir a través de

Set-AzPolicyExemption

  • Referencia
Módulo:
Az.Resources

Modifica una exención de directiva.

Syntax

Set-AzPolicyExemption
   -Name <String>
   [-Scope <String>]
   [-DisplayName <String>]
   [-Description <String>]
   [-ExemptionCategory <String>]
   [-PolicyDefinitionReferenceId <String[]>]
   [-ExpiresOn <DateTime>]
   [-ClearExpiration]
   [-Metadata <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzPolicyExemption
   -Id <String>
   [-DisplayName <String>]
   [-Description <String>]
   [-ExemptionCategory <String>]
   [-PolicyDefinitionReferenceId <String[]>]
   [-ExpiresOn <DateTime>]
   [-ClearExpiration]
   [-Metadata <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-AzPolicyExemption
   [-DisplayName <String>]
   [-Description <String>]
   [-ExemptionCategory <String>]
   [-PolicyDefinitionReferenceId <String[]>]
   [-ExpiresOn <DateTime>]
   [-ClearExpiration]
   [-Metadata <String>]
   -InputObject <PsPolicyExemption>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-AzPolicyExemption modifica una exención de directiva. Especifique una exención por identificador o por nombre y ámbito.

Ejemplos

Ejemplo 1: Actualización del nombre para mostrar

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
 $PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07' -Scope $ResourceGroup.ResourceId
Set-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'
Set-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'
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á.

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

$PolicyExemption = Get-AzPolicyExemption -Name 'PolicyExemption07'
Set-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á.

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
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-ClearExpiration

Si se establece, este modificador borra la fecha y hora de expiración en la exención de directiva actualizada.

Tipo:SwitchParameter
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Tipo:String
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-DisplayName

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

Tipo:String
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-ExemptionCategory

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

Tipo:String
valores aceptados:Waiver, Mitigated
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-ExpiresOn

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

Tipo:Nullable<T>[DateTime]
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-Id

Identificador de exención de directiva completo que se va a actualizar, incluido el ámbito, por ejemplo, /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Authorization/policyExemptions/{policyExemptionName}.

Tipo:String
Aliases:ResourceId
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

Objeto de exención de directiva que se va a actualizar que se ha generado desde otro cmdlet.

Tipo:PsPolicyExemption
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

-Metadata

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

Tipo:String
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Nombre de la exención de directiva que se va a actualizar.

Tipo:String
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters: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[]
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters: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
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

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

Tipo:String
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

String[]

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

SwitchParameter

PsPolicyExemption

Salidas

PsPolicyExemption