Get-AzPolicyAssignment

  • Référence
Module:
Az.Resources

Obtient les affectations de stratégie.

Syntax

Get-AzPolicyAssignment
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyAssignment
   [-Name <String>]
   [-Scope <String>]
   [-PolicyDefinitionId <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyAssignment
   [-Scope <String>]
   [-IncludeDescendent]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzPolicyAssignment
   -Id <String>
   [-PolicyDefinitionId <String>]
   [-ApiVersion <String>]
   [-Pre]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

L’applet de commande Get-AzPolicyAssignment obtient toutes les affectations de stratégie ou affectations particulières. Identifiez une affectation de stratégie pour obtenir par nom et étendue ou par ID.

Exemples

Exemple 1 : Obtenir toutes les attributions de stratégie

Get-AzPolicyAssignment

Cette commande obtient toutes les attributions de stratégie.

Exemple 2 : Obtenir une attribution de stratégie spécifique

$ResourceGroup = Get-AzResourceGroup -Name 'ResourceGroup11'
Get-AzPolicyAssignment -Name 'PolicyAssignment07' -Scope $ResourceGroup.ResourceId

La première commande obtient un groupe de ressources nommé ResourceGroup11 à l’aide de l’applet de commande Get-AzResourceGroup et le stocke dans la variable $ResourceGroup. La deuxième commande obtient l’affectation de stratégie nommée PolicyAssignment07 pour l’étendue que la propriété ResourceId de $ResourceGroup identifie.

Exemple 3 : Obtenir toutes les attributions de stratégie affectées à un groupe d’administration

$mgId = 'myManagementGroup'
Get-AzPolicyAssignment -Scope '/providers/Microsoft.Management/managementgroups/$mgId'

La première commande spécifie l’ID du groupe d’administration à interroger. La deuxième commande obtient toutes les affectations de stratégie affectées au groupe d’administration avec l’ID « myManagementGroup ».

Exemple 4 : Obtenir l’étendue, l’identificateur de définition de jeu de stratégies et le nom complet de toutes les affectations de stratégie mises en forme sous forme de liste

Get-AzPolicyAssignment | Select-Object -ExpandProperty properties | Select-Object -Property Scope, PolicyDefinitionID, DisplayName | Format-List

Cette commande est utile lorsque vous devez rechercher la propriété DisplayName conviviale du lecteur d’une affectation Azure Policy.

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

-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 de l’affectation 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

-IncludeDescendent

Provoque la liste des affectations de stratégie retournées pour inclure toutes les affectations liées à l’étendue donnée, y compris celles provenant d’étendues ancêtres et celles provenant d’étendues descendantes.

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

-Name

Spécifie le nom de l’affectation 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

-PolicyDefinitionId

Spécifie l’ID de la définition de stratégie des affectations 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

-Scope

Spécifie l’étendue à laquelle la stratégie est appliquée pour l’affectation que cette applet de commande obtient.

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

Entrées

String

SwitchParameter

Sorties

PsPolicyAssignment