Get-AzPolicyExemption
Obtiene exenciones de directiva.
Sintaxis
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.
Tipo: | String |
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 |
-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}.
Tipo: | String |
Alias: | ResourceId |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | 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.
Tipo: | SwitchParameter |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-Name
Nombre de la exención de directiva que se va a obtener.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-PolicyAssignmentIdFilter
Limita la lista de exenciones de directiva devueltas a las que asignan la asignación de directiva identificada por este identificador completo.
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 exención de directiva que se va a obtener, 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 |