Condividi tramite


Get-AzPolicySetDefinition

Ottiene le definizioni dei set di criteri.

Sintassi

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>]

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 {$_.metadata.category -eq "Virtual Machine"}

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

Esempio 6: [Backcompat] Ottenere le definizioni dei set di criteri da una determinata categoria

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

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

Parametri

-BackwardCompatible

Fa sì che il cmdlet restituisca artefatti usando il formato legacy inserendo proprietà specifiche dei criteri in un oggetto contenitore delle proprietà.

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

-Builtin

Fa sì che il cmdlet restituisca solo definizioni di criteri predefinite.

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

-Custom

Fa sì che il cmdlet restituisca solo definizioni di criteri personalizzate.

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

-DefaultProfile

Il parametro DefaultProfile non è funzionale. Usare il parametro SubscriptionId quando disponibile se si esegue il cmdlet su una sottoscrizione diversa.

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

-Id

ID completo della definizione di criteri da ottenere.

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

-ListVersion

Fa sì che il cmdlet restituisca solo definizioni di criteri personalizzate.

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

-ManagementGroupName

Nome del gruppo di gestione.

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

-Name

Nome della definizione di criteri da ottenere.

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

-SubscriptionId

ID della sottoscrizione di destinazione.

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

-Version

Versione della definizione dei criteri in formato #.#.# .

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

Input

SwitchParameter

String

Output

IPolicySetDefinition