Get-AzPolicyExemption

Obtém isenções de apólices.

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

O cmdlet Get-AzPolicyExemption obtém todas as isenções de política ou isenções específicas. Identifique uma isenção de política para obter por nome e escopo ou por ID.

Exemplos

Exemplo 1: Obter todas as isenções de apólice

Get-AzPolicyExemption

Este comando obtém todas as isenções de política na assinatura atual. Se você precisar listar todas as isenções relacionadas ao escopo determinado, incluindo as de escopos ancestrais e as de escopos descendentes, você precisará passar o -IncludeDescendent parâmetro.

Exemplo 2: Obter uma isenção de apólice específica

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

O primeiro comando obtém um grupo de recursos chamado ResourceGroup11 usando o cmdlet Get-AzResourceGroup e o armazena na variável $ResourceGroup. O segundo comando obtém a isenção de política chamada PolicyExemption07 para o escopo que a propriedade ResourceId de $ResourceGroup identifica.

Exemplo 3: Obter todas as isenções de política associadas a uma atribuição de política

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

O primeiro comando obtém uma atribuição de política chamada PolicyAssignment07. O segundo comando obtém todas as isenções de política atribuídas com a atribuição de política.

Parâmetros

-ApiVersion

Quando definido, indica a versão da API do provedor de recursos a ser usada. Se não for especificada, a versão da API será determinada automaticamente como a mais recente disponível.

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

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

-Id

O ID de isenção de política totalmente qualificado a ser obtido, incluindo o escopo, por exemplo, /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

Faz com que a lista de isenções de política retornadas inclua todas as isenções relacionadas ao escopo determinado, incluindo aquelas de escopos ancestrais e de escopos descendentes. Esse parâmetro não funciona quando o escopo solicitado é um escopo de grupo de gerenciamento.

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

-Name

O nome da isenção de apólice a obter.

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

-PolicyAssignmentIdFilter

Limita a lista de isenções de política retornadas àqueles que atribuem a atribuição de política identificada por essa ID totalmente qualificada.

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

-Pre

Quando definido, indica que o cmdlet deve usar versões de API de pré-lançamento ao determinar automaticamente qual versão usar.

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

-Scope

O escopo da isenção de política para obter, por exemplo, /providers/managementGroups/{managementGroupName}, assume como padrão a assinatura atual.

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

Entradas

String

SwitchParameter

Saídas

PsPolicyExemption