Get-AzPolicyAssignment

Référence

Module:: Az.Resources

Obtient les affectations de stratégie.

Syntaxe

Get-AzPolicyAssignment
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   -Name <String>
   [-Scope <String>]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   [-Scope <String>]
   -PolicyDefinitionId <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   [-Scope <String>]
   [-IncludeDescendent]
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   -Scope <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzPolicyAssignment
   -Id <String>
   [-BackwardCompatible]
   [-DefaultProfile <PSObject>]
   [<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 -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.

Exemple 5 : [Backcompat] Obtenir l’étendue, l’identificateur de définition de jeu de stratégies et le nom d’affichage de toutes les affectations de stratégie mises en forme en tant que liste

Get-AzPolicyAssignment -BackwardCompatible | 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

-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

-DefaultProfile

Le paramètre DefaultProfile n’est pas fonctionnel. Utilisez le paramètre SubscriptionId lorsqu’il est disponible si vous exécutez l’applet de commande sur un autre abonnement.

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 de l’affectation de stratégie à obtenir. Utilisez le format « {scope}/providers/Microsoft.Authorization/policyAssignments/{policyAssignmentName} ».

Type:	String
Alias:	ResourceId, PolicyAssignmentId
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	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. S’il n’est pas fourni, seules les affectations au-dessus de l’étendue donnée sont incluses.

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

-Name

Nom de l’affectation de stratégie à obtenir.

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

-PolicyDefinitionId

Obtenez toutes les attributions de stratégie qui ciblent l’ID de définition de stratégie [qualifié complet] donné.

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

-Scope

Étendue de l’attribution de stratégie. Les étendues valides sont les suivantes : groupe d’administration (format : '/providers/Microsoft.Management/managementGroups/{managementGroup}'), abonnement (format : '/subscriptions/{subscriptionId}'), groupe de ressources (format : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', ou ressource (format : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

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

Entrées

SwitchParameter

String

Sorties

IPolicyAssignment

Partager via