Condividi tramite


Get-AzPolicySetDefinition

Ottiene le definizioni dei set di criteri.

Sintassi

Get-AzPolicySetDefinition
   [-Name <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicySetDefinition
   [-Name <String>]
   -ManagementGroupName <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicySetDefinition
   [-Name <String>]
   -SubscriptionId <Guid>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicySetDefinition
   -Id <String>
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicySetDefinition
   [-ManagementGroupName <String>]
   [-SubscriptionId <Guid>]
   [-Builtin]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicySetDefinition
   [-ManagementGroupName <String>]
   [-SubscriptionId <Guid>]
   [-Custom]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Descrizione

Il cmdlet Get-AzPolicySetDefinition ottiene una raccolta di definizioni di set di criteri o una definizione di set di criteri specifica identificata dal nome o dall'ID.

Esempio

Esempio 1: Ottenere tutte le definizioni dei set di criteri

Get-AzPolicySetDefinition

Questo comando ottiene tutte le definizioni dei set di criteri.

Esempio 2: Ottenere la definizione del set di criteri dalla sottoscrizione corrente in base al nome

Get-AzPolicySetDefinition -Name 'VMPolicySetDefinition'

Questo comando ottiene la definizione del set di criteri denominata VMPolicySetDefinition dalla sottoscrizione predefinita corrente.

Esempio 3: Ottenere la definizione del set di criteri dalla sottoscrizione in base al nome

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

Questo comando ottiene la definizione di criteri denominata VMPolicySetDefinition dalla sottoscrizione con ID 3bf44b72-c631-427a-b8c8-53e2595398ca.

Esempio 4: Ottenere tutte le definizioni dei set di criteri personalizzati dal gruppo di gestione

Get-AzPolicySetDefinition -ManagementGroupName 'Dept42' -Custom

Questo comando ottiene tutte le definizioni dei set di criteri personalizzati dal gruppo di gestione denominato Dept42.

Esempio 5: Ottenere le definizioni dei set di criteri da una determinata categoria

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

Questo comando ottiene tutte le definizioni dei set di criteri nella categoria "Macchina virtuale".

Parametri

-ApiVersion

Se impostato, indica la versione dell'API del provider di risorse da usare. Se non specificato, la versione dell'API viene determinata automaticamente come la versione più recente disponibile.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Builtin

Limita l'elenco dei risultati solo alle definizioni predefinite dei set di criteri.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Custom

Limita l'elenco dei risultati solo alle definizioni dei set di criteri personalizzati.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Id

ID definizione del set di criteri completo, inclusa la sottoscrizione. ad esempio /subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}

Tipo:String
Alias:ResourceId
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ManagementGroupName

Nome del gruppo di gestione delle definizioni dei set di criteri da ottenere.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Nome della definizione del set di criteri.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Pre

Se impostato, indica che il cmdlet deve usare versioni API non definitive quando si determina automaticamente quale versione usare.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SubscriptionId

ID sottoscrizione delle definizioni dei set di criteri da ottenere.

Tipo:Nullable<T>[Guid]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

String

Nullable<T>[[System.Guid, System.Private.CoreLib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Output

PSObject