Get-AzPolicyDefinition

  • Riferimento
Modulo:
Az.Resources

Ottiene le definizioni dei criteri.

Sintassi

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

Descrizione

Il cmdlet Get-AzPolicyDefinition ottiene una raccolta di definizioni di criteri o una definizione 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 -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

-ApiVersion

Specifica la versione dell'API del provider di risorse da usare. Se non si specifica una versione, questo cmdlet usa la versione più recente disponibile.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Builtin

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Custom

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

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Specifica l'ID risorsa completo per la definizione di criteri che ottiene questo cmdlet.

Type:String
Aliases:ResourceId
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ManagementGroupName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Specifica il nome della definizione di criteri che ottiene questo cmdlet.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Pre

Indica che questo cmdlet considera le versioni api non definitive quando determina automaticamente la versione da usare.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubscriptionId

ID sottoscrizione delle definizioni dei criteri da ottenere.

Type:Nullable<T>[Guid]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Input

String

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

Output

PSObject