Get-AzPolicyExemption

Obtiene exenciones de directiva.

Syntax

Get-AzPolicyExemption
   [-Name <String>]
   [-Scope <String>]
   [-PolicyAssignmentIdFilter <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyExemption
   [-Scope <String>]
   [-IncludeDescendent]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyExemption
   -Id <String>
   [-PolicyAssignmentIdFilter <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet Get-AzPolicyExemption obtiene todas las exenciones de directiva o exenciones concretas. Identifique una exención de directiva para obtener por nombre y ámbito o por identificador.

Ejemplos

Ejemplo 1 Obtención de todas las exenciones de directiva

Get-AzPolicyExemption

Este comando obtiene todas las exenciones de directiva de la suscripción actual. Si necesita enumerar todas las exenciones relacionadas con el ámbito especificado, incluidas las de ámbitos antecesor y las de ámbitos descendientes, debe pasar el -IncludeDescendent parámetro .

Ejemplo 2: Obtención de una exención de directiva específica

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Get-AzPolicyExemption -Name 'PolicyExemption07' -Scope $ResourceGroup.ResourceId

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 exención de directiva denominada PolicyExemption07 para el ámbito que identifica la propiedad ResourceId de $ResourceGroup.

Ejemplo 3: Obtención de todas las exenciones de directiva asociadas a una asignación de directiva

$Assignment = Get-AzPolicyAssignment -Name 'PolicyAssignment07'
Get-AzPolicyExemption -PolicyAssignmentIdFilter $Assignment.ResourceId

El primer comando obtiene una asignación de directiva denominada PolicyAssignment07. El segundo comando obtiene todas las exenciones de directiva que se asignan a la asignación de directiva.

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.

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

-DefaultProfile

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

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

-Id

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

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

-IncludeDescendent

Hace que la lista de exenciones de directiva devueltas incluya todas las exenciones relacionadas con el ámbito especificado, incluidas las de ámbitos antecesor y las de ámbitos descendientes. Este parámetro no funciona cuando el ámbito solicitado es un ámbito de grupo de administración.

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

-Name

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

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

-PolicyAssignmentIdFilter

Limita la lista de exenciones de directiva devueltas a las que asignan la asignación de directiva identificada por este identificador completo.

Type:String
Position:Named
Default value:None
Required: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.

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

-Scope

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

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

Entradas

String

SwitchParameter

Salidas

PsPolicyExemption