Get-AzPolicyDefinition

Modulo:

Az.Resources

Ottiene le definizioni dei set di criteri.

Sintassi

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

Get-AzPolicyDefinition
   [-Name <String>]
   -ManagementGroupName <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-Name <String>]
   -SubscriptionId <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-Name <String>]
   [-Id <String>]
   [-BackwardCompatible]
   -Version <String>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   [-Name <String>]
   [-Id <String>]
   [-ListVersion]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyDefinition
   -Id <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

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

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

Get-AzPolicyDefinition
   [-SubscriptionId <String>]
   [-ManagementGroupName <String>]
   [-Static]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Descrizione

Il cmdlet Get-AzPolicyDefinition 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 criteri

Get-AzPolicyDefinition

Questo comando ottiene tutte le definizioni dei criteri.

Esempio 2: Ottenere la definizione dei criteri dalla sottoscrizione corrente in base al nome

Get-AzPolicyDefinition -Name 'VMPolicyDefinition'

Questo comando ottiene la definizione di criteri denominata VMPolicyDefinition dalla sottoscrizione predefinita corrente.

Esempio 3: Ottenere la definizione dei criteri dal gruppo di gestione in base al nome

Get-AzPolicyDefinition -Name 'VMPolicyDefinition' -ManagementGroupName 'Dept42'

Questo comando ottiene la definizione di criteri denominata VMPolicyDefinition dal gruppo di gestione denominato Dept42.

Esempio 4: Ottenere tutte le definizioni di criteri predefiniti dalla sottoscrizione

Get-AzPolicyDefinition -SubscriptionId '3bf44b72-c631-427a-b8c8-53e2595398ca' -Builtin

Questo comando ottiene tutte le definizioni di criteri predefinite dalla sottoscrizione con ID 3bf44b72-c631-427a-b8c8-53e2595398ca.

Esempio 5: Ottenere definizioni di criteri da una determinata categoria

Get-AzPolicyDefinition | Where-Object {$_.Properties.metadata.category -eq 'Tags'}

Questo comando ottiene tutte le definizioni dei criteri nella categoria Tag.

Esempio 6: Ottenere il nome visualizzato, la descrizione, il tipo di criteri e i metadati di tutte le definizioni dei criteri formattate come elenco

Get-AzPolicyDefinition | Select-Object -Property DisplayName, Description, PolicyType, Metadata | Format-List

Questo comando è utile quando è necessario trovare la proprietà DisplayName descrittiva per il lettore di una definizione di Criteri di Azure. È possibile analizzare la proprietà Metadata per individuare il numero di versione e l'assegnazione di categoria della definizione dei criteri.

Esempio 7: [Backcompat] Ottenere il nome visualizzato, la descrizione, il tipo di criteri e i metadati di tutte le definizioni dei criteri formattate come elenco

Get-AzPolicyDefinition -BackwardCompatible | Select-Object -ExpandProperty properties | Select-Object -Property DisplayName, Description, PolicyType, Metadata | Format-List

Questo comando è utile quando è necessario trovare la proprietà DisplayName descrittiva per il lettore di una definizione di Criteri di Azure. È possibile analizzare la proprietà Metadata per individuare il numero di versione e l'assegnazione di categoria della definizione dei criteri.

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

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

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:	PolicyDefinitionName
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-Static

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	True
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:	PolicyDefinitionVersion
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

Input

SwitchParameter

String

Output

IPolicyDefinition