Partilhar via


Get-AzPolicySetDefinition

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

Sintaxe

Get-AzPolicySetDefinition
   [-Name <String>]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicySetDefinition
   [-Name <String>]
   -ManagementGroupName <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicySetDefinition
   [-Name <String>]
   -SubscriptionId <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicySetDefinition
   [-Name <String>]
   [-Id <String>]
   [-BackwardCompatible]
   -Version <String>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicySetDefinition
   [-Name <String>]
   [-Id <String>]
   [-ListVersion]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicySetDefinition
   -Id <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicySetDefinition
   [-SubscriptionId <String>]
   [-ManagementGroupName <String>]
   [-Builtin]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]
Get-AzPolicySetDefinition
   [-SubscriptionId <String>]
   [-ManagementGroupName <String>]
   [-Custom]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Description

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 'aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e'

Este comando obtém a definição de política chamada VMPolicySetDefinition da assinatura com ID aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e.

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: [Backcompat] Obter definições de conjunto de políticas de uma determinada categoria

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

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

Parâmetros

-BackwardCompatible

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Builtin

Faz com que o cmdlet retorne apenas definições de política internas.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Custom

Faz com que o cmdlet retorne apenas definições de política personalizadas.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais: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.

Tipo:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Id

O Id completo da definição de política a ser obtida.

Tipo:String
Aliases:ResourceId
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ListVersion

Faz com que o cmdlet retorne apenas definições de política personalizadas.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ManagementGroupName

O nome do grupo de gerenciamento.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

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

Tipo:String
Aliases:PolicySetDefinitionName
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-SubscriptionId

A ID da assinatura de destino.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Version

A versão de definição de política no formato #.#.#.

Tipo:String
Aliases:PolicySetDefinitionVersion
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Entradas

SwitchParameter

String

Saídas

IPolicySetDefinition