Get-AzPolicySetDefinition

Módulo:
Az.Resources Module

Obtém definições de conjunto de políticas.

Sintaxe

Name (Predefinição) 

Get-AzPolicySetDefinition
    [-Name <String>]
    [-ListVersion]
    [-Expand <String>]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

ManagementGroupName 

Get-AzPolicySetDefinition
    -ManagementGroupName <String>
    [-Name <String>]
    [-ListVersion]
    [-Expand <String>]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

SubscriptionId 

Get-AzPolicySetDefinition
    -SubscriptionId <String>
    [-Name <String>]
    [-ListVersion]
    [-Expand <String>]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Builtin 

Get-AzPolicySetDefinition
    [-SubscriptionId <String>]
    [-ManagementGroupName <String>]
    [-Builtin]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Custom 

Get-AzPolicySetDefinition
    [-SubscriptionId <String>]
    [-ManagementGroupName <String>]
    [-Custom]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Id 

Get-AzPolicySetDefinition
    -Id <String>
    [-ListVersion]
    [-Expand <String>]
    [-Version <String>]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

Descrição

O cmdlet Get-AzPolicySetDefinition obtém uma coleção de definições de conjunto de políticas ou uma definição de conjunto de políticas específica identificada por nome ou ID.

Exemplos

Exemplo 1: Obter todas as definições de conjunto de políticas

Get-AzPolicySetDefinition

Este comando obtém todas as definições do conjunto de políticas.

Exemplo 2: Obter definição de conjunto de políticas da assinatura atual por nome

Get-AzPolicySetDefinition -Name 'VMPolicySetDefinition'

Este comando obtém a definição do conjunto de políticas chamada VMPolicySetDefinition da assinatura padrão atual.

Exemplo 3: Obter definição de conjunto de políticas da assinatura por nome

Get-AzPolicySetDefinition -Name 'VMPolicySetDefinition' -subscriptionId '3bf44b72-c631-427a-b8c8-53e2595398ca'

Este comando obtém a definição de política chamada VMPolicySetDefinition da assinatura com ID 3bf44b72-c631-427a-b8c8-53e2595398ca.

Exemplo 4: Obter todas as definições de conjunto de políticas personalizadas do grupo de gerenciamento

Get-AzPolicySetDefinition -ManagementGroupName 'Dept42' -Custom

Este comando obtém todas as definições personalizadas do conjunto de políticas do grupo de gerenciamento chamado Dept42.

Exemplo 5: Obter definições de conjunto de políticas de uma determinada categoria

Get-AzPolicySetDefinition | Where-Object {$_.metadata.category -eq "Virtual Machine"}

Este comando obtém todas as definições do conjunto de políticas na categoria "Máquina Virtual".

Exemplo 6: Obter a versão da definição do conjunto de políticas por id

Get-AzPolicySetDefinition -Id '/providers/Microsoft.Authorization/policySetDefinitions/1bb84455-9e6e-434c-8db6-fa6d03a67e87' -Version "1.1.1"

Este comando recebe a versão 1.1.1 da definição de políticas com ID /providers/Microsoft. Authorization/policySetDefinitions/1bb84455-9e6e-434c-8db6-fa6d03a67e87.

Exemplo 7: Obter todas as versões de definição de conjunto de políticas de uma definição de conjunto de políticas por nome

Get-AzPolicySetDefinition -Name 'VMPolicySetDefinition' -ListVersion

Este comando obtém todas as versões de definição do conjunto de políticas chamada VMPolicySetDefinition da subscrição padrão atual.

Parâmetros

-Builtin

Faz com que o cmdlet devolva apenas definições de conjuntos de políticas incorporadas.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Builtin
Posto:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Custom

Faz com que o cmdlet devolva apenas definições personalizadas de conjuntos de políticas.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Custom
Posto:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-DefaultProfile

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

Propriedades dos parâmetros

Tipo:PSObject
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzureRMContext, AzureCredential

Conjuntos de parâmetros

(All)
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Expand

Lista separada por vírgulas de propriedades adicionais a serem incluídas na resposta. Os valores suportados são 'LatestDefinitionVersion, EffectiveDefinitionVersion'.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Name
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
ManagementGroupName
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
SubscriptionId
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
Id
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Id

O ID completo da definição do conjunto de políticas a obter.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:ResourceId

Conjuntos de parâmetros

Id
Posto:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ListVersion

Faz com que o cmdlet devolva apenas versões personalizadas de definição do conjunto de políticas.

Propriedades dos parâmetros

Tipo:SwitchParameter
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

Name
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
ManagementGroupName
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
SubscriptionId
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
Id
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ManagementGroupName

O nome do grupo de gerenciamento.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

ManagementGroupName
Posto:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Name

O nome da definição do conjunto de políticas a obter.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:PolicySetDefinitionName

Conjuntos de parâmetros

Name
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
ManagementGroupName
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
SubscriptionId
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-SubscriptionId

O ID da assinatura de destino.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SubscriptionId
Posto:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Version

A versão de definição do conjunto de políticas no formato #.#.#.

Propriedades dos parâmetros

Tipo:String
Valor predefinido:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:PolicySetDefinitionVersion

Conjuntos de parâmetros

Name
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
ManagementGroupName
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
SubscriptionId
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False
Id
Posto:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

SwitchParameter

String

Saídas

IPolicySetDefinition