Get-AzPolicyAssignment

  • Referência
Módulo:
Az.Resources

Obtém atribuições de política.

Syntax

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

Description

O cmdlet Get-AzPolicyAssignment obtém todas as atribuições de política ou atribuições específicas. Identifique uma atribuição de política a ser obtida por nome e escopo ou por ID.

Exemplos

Exemplo 1: Obter todas as atribuições de política

Get-AzPolicyAssignment

Esse comando obtém todas as atribuições de política.

Exemplo 2: Obter uma atribuição de política específica

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Get-AzPolicyAssignment -Name 'PolicyAssignment07' -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 atribuição de política chamada PolicyAssignment07 para o escopo que a propriedade ResourceId de $ResourceGroup identifica.

Exemplo 3: Obter todas as atribuições de política atribuídas a um grupo de gerenciamento

$mgId = 'myManagementGroup'
Get-AzPolicyAssignment -Scope '/providers/Microsoft.Management/managementgroups/$mgId'

O primeiro comando especifica a ID do grupo de gerenciamento a ser consultado. O segundo comando obtém todas as atribuições de política atribuídas ao grupo de gerenciamento com a ID 'myManagementGroup'.

Exemplo 4: Obter o escopo, o identificador de definição do conjunto de políticas e o nome de exibição de todas as atribuições de política formatadas como uma lista

Get-AzPolicyAssignment | Select-Object -ExpandProperty properties | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-List

Esse comando é útil quando você precisa localizar a propriedade DisplayName amigável para o leitor de uma atribuição de Política do Azure.

Parâmetros

-ApiVersion

Especifica a versão da API do provedor de recursos a ser usada. Se você não especificar uma versão, esse cmdlet usará a versão 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

Especifica a ID de recurso totalmente qualificada para a atribuição de política que esse cmdlet obtém.

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 atribuições de política retornadas inclua todas as atribuições relacionadas ao escopo especificado, incluindo aquelas de escopos ancestrais e aquelas de escopos descendentes.

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

-Name

Especifica o nome da atribuição de política que esse cmdlet obtém.

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

-PolicyDefinitionId

Especifica a ID da definição de política das atribuições de política que esse cmdlet obtém.

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

-Pre

Indica que esse cmdlet considera versões de API de pré-lançamento quando determina automaticamente qual versão usar.

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

-Scope

Especifica o escopo no qual a política é aplicada para a atribuição que esse cmdlet obtém.

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

Entradas

String

SwitchParameter

Saídas

PsPolicyAssignment