Get-AzPolicyDefinition

  • Référence
Module:
Az.Resources

Obtient les définitions de stratégie.

Syntax

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

Description

L’applet de commande Get-AzPolicyDefinition obtient une collection de définitions de stratégie ou une définition de stratégie spécifique identifiée par nom ou ID.

Exemples

Exemple 1 : Obtenir toutes les définitions de stratégie

Get-AzPolicyDefinition

Cette commande obtient toutes les définitions de stratégie.

Exemple 2 : Obtenir la définition de stratégie à partir de l’abonnement actuel par nom

Get-AzPolicyDefinition -Name 'VMPolicyDefinition'

Cette commande obtient la définition de stratégie nommée VMPolicyDefinition à partir de l’abonnement par défaut actuel.

Exemple 3 : Obtenir la définition de stratégie à partir du groupe d’administration par nom

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

Cette commande obtient la définition de stratégie nommée VMPolicyDefinition à partir du groupe d’administration nommé Dept42.

Exemple 4 : Obtenir toutes les définitions de stratégie intégrées à partir de l’abonnement

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

Cette commande obtient toutes les définitions de stratégie intégrées de l’abonnement avec l’ID 3bf44b72-c631-427a-b8c8-53e2595398ca.

Exemple 5 : Obtenir des définitions de stratégie à partir d’une catégorie donnée

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

Cette commande obtient toutes les définitions de stratégie dans les balises de catégorie.

Exemple 6 : Obtenir le nom d’affichage, la description, le type de stratégie et les métadonnées de toutes les définitions de stratégie mises en forme sous forme de liste

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

Cette commande est utile lorsque vous devez rechercher la propriété DisplayName conviviale du lecteur d’une définition Azure Policy. Vous pouvez analyser la propriété Metadata pour découvrir le numéro de version et l’attribution de catégorie de la définition de stratégie.

Paramètres

-ApiVersion

Spécifie la version de l’API du fournisseur de ressources à utiliser. Si vous ne spécifiez pas de version, cette applet de commande utilise la dernière version disponible.

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

-Builtin

Limite la liste des résultats aux définitions de stratégie intégrées uniquement.

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

-Custom

Limite la liste des résultats aux définitions de stratégie personnalisées uniquement.

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

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

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

-Id

Spécifie l’ID de ressource complet pour la définition de stratégie que cette applet de commande obtient.

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

-ManagementGroupName

Nom du groupe d’administration des définitions de stratégie à obtenir.

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

-Name

Spécifie le nom de la définition de stratégie que cette applet de commande obtient.

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

-Pre

Indique que cette applet de commande prend en compte les versions d’API en préversion lorsqu’elle détermine automatiquement la version à utiliser.

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

-SubscriptionId

ID d’abonnement de la ou des définitions de stratégie à obtenir.

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

Entrées

String

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

Sorties

PSObject