Get-AzPolicyAssignment

Referência

Módulo:: Az.Resources

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

Syntax

Get-AzPolicyAssignment
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   -Name <String>
   [-Scope <String>]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   [-Scope <String>]
   -PolicyDefinitionId <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   [-Scope <String>]
   [-IncludeDescendent]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   -Scope <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   -Id <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<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 -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.

Exemplo 5: [Backcompat] Obtenha 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 -BackwardCompatible | 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

-BackwardCompatible

Faz com que o cmdlet retorne artefatos usando o formato herdado colocando propriedades específicas da política em um objeto do pacote de propriedades.

Tipo:	SwitchParameter
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

O parâmetro DefaultProfile não está funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.

Tipo:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
valor padrão:	None
Obrigatório:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

A ID da atribuição de política a ser obtida. Use o formato '{scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName}'.

Tipo:	String
Aliases:	ResourceId, PolicyAssignmentId
Position:	Named
valor padrão:	None
Obrigatório:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-IncludeDescendent

Obtenha todas as atribuições de política direcionadas à ID de definição de política [totalmente qualificada] fornecida.

Tipo:	SwitchParameter
Position:	Named
valor padrão:	None
Obrigatório:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

O nome da atribuição de política a ser obtida.

Tipo:	String
Aliases:	PolicyAssignmentName
Position:	Named
valor padrão:	None
Obrigatório:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PolicyDefinitionId

Obtenha todas as atribuições de política direcionadas à ID de definição de política [totalmente qualificada] fornecida.

Tipo:	String
Position:	Named
valor padrão:	None
Obrigatório:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Scope

O escopo da atribuição de política. Os escopos válidos são: grupo de gerenciamento (formato: '/providers/Microsoft.Management/managementGroups/{managementGroup}'), assinatura (formato: '/subscriptions/{subscriptionId}'), grupo de recursos (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}' ou recurso (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

Tipo:	String
Position:	Named
valor padrão:	None
Obrigatório:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Entradas

SwitchParameter

String

Saídas

IPolicyAssignment

Compartilhar via