Get-EntraUserAppRoleAssignment

Module:
Microsoft.Entra.Users Module v1.3

Obtenir une attribution de rôle d’application utilisateur.

Syntaxe

Default (Par défaut) 

Get-EntraUserAppRoleAssignment

    -UserId <String>
    [-All]
    [-Top <Int32>]
    [-Property <String[]>]
    [<CommonParameters>]

Description

L’applet Get-EntraUserAppRoleAssignment de commande obtient une attribution de rôle d’application utilisateur.

Pour effectuer cette opération dans des scénarios délégués à l’aide de comptes professionnels ou scolaires, l’utilisateur connecté doit disposer de l’un des rôles les moins privilégiés suivants ou d’un rôle personnalisé avec les autorisations nécessaires :

  • Inviteur d’invités - Lire les attributions de rôles d’application pour les utilisateurs uniquement
  • Lecteurs d’annuaire
  • Comptes de synchronisation d’annuaires : pour Microsoft Entra Connect et Microsoft Entra services de synchronisation cloud
  • Éditeur de répertoires
  • Administrateur d’identité hybride
  • Administrateur de la Gouvernance de l'Identité
  • Administrateur de rôle privilégié
  • Administrateur d’utilisateurs
  • Administrateur d’application
  • Administrateur d’applications cloud

Exemples

Exemple 1 : Obtenir une attribution de rôle d’application utilisateur

Connect-Entra -Scopes 'AppRoleAssignment.ReadWrite.All', 'Directory.Read.All'
Get-EntraUserAppRoleAssignment -UserId 'SawyerM@contoso.com'

DeletedDateTime   Id                                        AppRoleId                              CreatedDateTime       PrincipalDisplayName  PrincipalId                          PrincipalType  ResourceDisplayName
---------------   --                                        ---------                              ---------------       --------------------  -----------                          -------------  -------------------
                  0ekrQWAUYUCO7cyiA_A1bC2dE3fH4i            00001111-aaaa-2222-bbbb-3333cccc4444  31-07-2023 04:29:57  Sawyer Miller         aaaaaaaa-bbbb-cccc-1111-222222222222 User           Test-App-1
                  0ekrQWAUYUCO7cyiA_C2dE3fH4iJ5k            11112222-bbbb-3333-cccc-4444dddd5555  12-07-2023 10:09:17  Sawyer Miller         aaaaaaaa-bbbb-cccc-1111-222222222222 User           Test-App-2
                  0ekrQWAUYUCO7cyiA_H4iJ5kL6mN7o            22223333-cccc-4444-dddd-5555eeee6666  13-09-2023 16:41:53  Sawyer Miller         aaaaaaaa-bbbb-cccc-1111-222222222222 User           Test-App-5
                  0ekrQWAUYUCO7cyiA_J5kL6mN7oP8q            33334444-dddd-5555-eeee-6666ffff7777  13-09-2023 17:28:17  Sawyer Miller         aaaaaaaa-bbbb-cccc-1111-222222222222 User           Test-App-7

Cet exemple récupère une attribution de rôle d’application utilisateur pour l’utilisateur dans $UserId. Vous pouvez utiliser la commande Get-EntraUser pour obtenir l’ID d’objet du principal de service.

  • -UserId spécifie l’ID d’objet d’un utilisateur(en tant que UserPrincipalName ou ObjectId).

Exemple 2 : Obtenir toutes les attributions de rôles d’application

Connect-Entra -Scopes 'AppRoleAssignment.ReadWrite.All', 'Directory.Read.All'
Get-EntraUserAppRoleAssignment -UserId 'SawyerM@contoso.com' -All

DeletedDateTime   Id                                        AppRoleId                              CreatedDateTime       PrincipalDisplayName  PrincipalId                          PrincipalType  ResourceDisplayName
---------------   --                                        ---------                              ---------------       --------------------  -----------                          -------------  -------------------
                  0ekrQWAUYUCO7cyiA_A1bC2dE3fH4i            00001111-aaaa-2222-bbbb-3333cccc4444  31-07-2023 04:29:57  Sawyer Miller         aaaaaaaa-bbbb-cccc-1111-222222222222 User           Test-App-1
                  0ekrQWAUYUCO7cyiA_C2dE3fH4iJ5k            11112222-bbbb-3333-cccc-4444dddd5555  12-07-2023 10:09:17  Sawyer Miller         aaaaaaaa-bbbb-cccc-1111-222222222222 User           Test-App-2
                  0ekrQWAUYUCO7cyiA_H4iJ5kL6mN7o            22223333-cccc-4444-dddd-5555eeee6666  13-09-2023 16:41:53  Sawyer Miller         aaaaaaaa-bbbb-cccc-1111-222222222222 User           Test-App-5
                  0ekrQWAUYUCO7cyiA_J5kL6mN7oP8q            33334444-dddd-5555-eeee-6666ffff7777  13-09-2023 17:28:17  Sawyer Miller         aaaaaaaa-bbbb-cccc-1111-222222222222 User           Test-App-7

Cet exemple montre comment récupérer toutes les attributions de rôle d’application pour l’utilisateur spécifié.

  • -UserId spécifie l’ID d’objet d’un utilisateur(en tant que UserPrincipalName ou ObjectId).

Exemple 3 : Obtenir les deux premières attributions de rôles d’application

Connect-Entra -Scopes 'AppRoleAssignment.ReadWrite.All', 'Directory.Read.All'
Get-EntraUserAppRoleAssignment -UserId 'SawyerM@contoso.com' -Top 2

DeletedDateTime   Id                                        AppRoleId                              CreatedDateTime       PrincipalDisplayName  PrincipalId                          PrincipalType  ResourceDisplayName
---------------   --                                        ---------                              ---------------       --------------------  -----------                          -------------  -------------------
                  0ekrQWAUYUCO7cyiA_A1bC2dE3fH4i            00001111-aaaa-2222-bbbb-3333cccc4444  31-07-2023 04:29:57  Sawyer Miller         aaaaaaaa-bbbb-cccc-1111-222222222222 User           Test-App-1
                  0ekrQWAUYUCO7cyiA_C2dE3fH4iJ5k            11112222-bbbb-3333-cccc-4444dddd5555  12-07-2023 10:09:17  Sawyer Miller         aaaaaaaa-bbbb-cccc-1111-222222222222 User           Test-App-2

Cet exemple montre comment récupérer la première attribution de rôle d’application pour l’utilisateur spécifié. Vous pouvez utiliser -Limit comme alias pour -Top.

  • -UserId spécifie l’ID d’objet d’un utilisateur(en tant que UserPrincipalName ou ObjectId).

Exemple 4 : Obtenir des attributions de rôle d’application avec des propriétés sélectionnées

Connect-Entra -Scopes 'AppRoleAssignment.ReadWrite.All', 'Directory.Read.All'
Get-EntraUserAppRoleAssignment -UserId 'SawyerM@contoso.com' -Property Id,
    CreatedDateTime, PrincipalDisplayName, PrincipalType |
    Select-Object Id, CreatedDateTime, PrincipalDisplayName, PrincipalType

Id                                          CreatedDateTime        PrincipalDisplayName  PrincipalType
--                                          ----------------        -------------------- --------------
0ekrQWAUYUCO7cyiA_A1bC2dE3fH4i              7/30/2024 5:59:16 PM    Sawyer Miller         User
0ekrQWAUYUCO7cyiA_C2dE3fH4iJ5k              9/19/2024 7:13:24 AM    Contoso IT Support    Group

Cet exemple montre comment récupérer des attributions de rôles d’application pour l’utilisateur spécifié avec des propriétés sélectionnées.

  • -UserId spécifie l’ID d’objet d’un utilisateur(en tant que UserPrincipalName ou ObjectId).

Paramètres

-All

Répertorier toutes les pages.

Propriétés du paramètre

Type:System.Management.Automation.SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Property

Spécifie les propriétés à retourner.

Propriétés du paramètre

Type:

System.String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Sélectionnez

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Top

Spécifie le nombre maximal d’enregistrements à retourner.

Propriétés du paramètre

Type:System.Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Limite

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-UserId

Spécifie l’ID d’un utilisateur (en tant que UserPrincipalName ou ObjectId) dans Microsoft Entra ID.

Propriétés du paramètre

Type:System.String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Identifiant d'objet (ObjectId), UPN, Identité, Nom Principal de l'Utilisateur

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.