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