Get-AzPolicyDefinition

Module:

Az.Resources

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

Syntaxe

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

Description

L’applet de commande Get-AzPolicyDefinition obtient une collection de définitions de jeu 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
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	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
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-DefaultProfile

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

Type:	PSObject
Alias:	AzureRMContext, AzureCredential
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Id

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

Type:	String
Alias:	ResourceId
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-ListVersion

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
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-ManagementGroupName

Nom du groupe d’administration.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Name

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

Type:	String
Alias:	PolicyDefinitionName
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	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
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-SubscriptionId

ID de l’abonnement cible.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Version

Version de la définition de stratégie au format #.#.#.#.

Type:	String
Alias:	PolicyDefinitionVersion
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

Entrées

SwitchParameter

String

Sorties

IPolicyDefinition