Get-AzPolicyDefinition

Module:

Az.Resources

Obtient les définitions de jeu de stratégies.

Syntax

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

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

Description

L’applet de commande Get-AzPolicySetDefinition obtient une collection de définitions d’ensembles de stratégies ou une définition de jeu de stratégies 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 -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.

Exemple 7 : [Backcompat] 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 -BackwardCompatible | 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

-BackwardCompatible

Provoque le retour d’artefacts à l’aide d’un format hérité plaçant des propriétés propres à une stratégie dans un objet de conteneur de propriétés.

Type:	SwitchParameter
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Builtin

Provoque le retour de l’applet de commande uniquement aux définitions de stratégie intégrées.

Type:	SwitchParameter
Position:	Named
valeur par défaut:	None
Obligatoire:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Custom

Provoque le retour des définitions de stratégie personnalisées uniquement par l’applet de commande.

Type:	SwitchParameter
Position:	Named
valeur par défaut:	None
Obligatoire:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

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

Type:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

ID complet de la définition de stratégie à obtenir.

Type:	String
Aliases:	ResourceId
Position:	Named
valeur par défaut:	None
Obligatoire:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ManagementGroupName

Nom du groupe d’administration.

Type:	String
Position:	Named
valeur par défaut:	None
Obligatoire:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Nom de la définition de stratégie à obtenir.

Type:	String
Aliases:	PolicyDefinitionName
Position:	Named
valeur par défaut:	None
Obligatoire:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Static

Provoque le retour des définitions de stratégie statique uniquement par l’applet de commande.

Type:	SwitchParameter
Position:	Named
valeur par défaut:	None
Obligatoire:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-SubscriptionId

ID de l’abonnement cible.

Type:	String
Position:	Named
valeur par défaut:	None
Obligatoire:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Entrées

SwitchParameter

String

Sorties

IPolicyDefinition