Get-AzPolicyExemption
Obtém isenções de política.
Sintaxe
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 política
Get-AzPolicyExemption
Esse comando obtém todas as isenções de política na assinatura atual. Se você precisar listar todas as isenções relacionadas ao escopo especificado, incluindo aquelas de escopos ancestrais e de escopos descendentes, será necessário passar o -IncludeDescendent
parâmetro.
Exemplo 2: Obter uma isenção de política 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.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.
Tipo: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Id
A ID de isenção de política totalmente qualificada a ser obtida, incluindo o escopo, por exemplo, /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Authorization/policyExemptions/{policyExemptionName}.
Tipo: | String |
Aliases: | ResourceId |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-IncludeDescendent
Faz com que a lista de isenções de política retornadas inclua todas as isenções relacionadas ao escopo especificado, 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.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |
-Name
O nome da isenção de política a ser obtida.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | 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.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | 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.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Scope
O escopo da isenção de política a ser obtida, por exemplo, /providers/managementGroups/{managementGroupName}, é padronizado para a assinatura atual.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | True |
Aceitar caracteres curinga: | False |