Get-EntraUserOAuth2PermissionGrant

Module:
Microsoft.Entra.Users Module v1.3

Obtient un objet oAuth2PermissionGrant.

Syntaxe

Default (Par défaut) 

Get-EntraUserOAuth2PermissionGrant

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

Description

L’applet Get-EntraUserOAuth2PermissionGrant de commande obtient un objet oAuth2PermissionGrant pour l’utilisateur spécifié dans Microsoft Entra ID. Spécifiez le UserId paramètre pour récupérer un objet oAuth2PermissionGrant.

Dans les scénarios délégués avec des comptes professionnels ou scolaires, l’utilisateur connecté doit recevoir un rôle Microsoft Entra pris en charge ou un rôle personnalisé avec une autorisation de rôle prise en charge. Les rôles les moins privilégiés suivants sont pris en charge pour cette opération.

  • Administrateur d’application
  • Développeur d’applications
  • Administrateur d’applications cloud
  • Rédacteurs d'annuaires
  • Administrateur de rôle privilégié
  • Administrateur d’utilisateurs
  • Lecteurs d’annuaire
  • Lecteur global
  • Invitant

Exemples

Exemple 1 : Récupérer les octrois d’autorisations OAuth2 pour un utilisateur à l’aide du paramètre ID d’objet

Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraUserOAuth2PermissionGrant -UserId 'SawyerM@contoso.com'

Id                                                               ClientId                             ConsentType ExpiryTime
--                                                               --------                             ----------- ----------
HXFXwKLgoUC4rwbZbCDIdffW8XpadQNIoHik9aQxrVHR6StBYBRhQI7tzKID_LIV 00001111-aaaa-2222-bbbb-3333cccc4444 Principal   08-01-2024 10:0...
9uBzRwC0s0CFCDQN6O4Ik_fW8XpadQNIoHik9aQxrVHR6StBYBRhQI7tzKID_LIV 11112222-bbbb-3333-cccc-4444dddd5555 Principal   13-01-2024 08:0...

Cet exemple récupère les octrois d’autorisations OAuth2 pour un utilisateur à l’aide du paramètre ID d’objet.

  • -UserId spécifie l’ID utilisateur.

Exemple 2 : Récupérer les octrois d’autorisations OAuth2 pour un utilisateur à l’aide de tous les paramètres

Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraUserOAuth2PermissionGrant -UserId 'SawyerM@contoso.com' -All

Id                                                               ClientId                             ConsentType ExpiryTime
--                                                               --------                             ----------- ----------
HXFXwKLgoUC4rwbZbCDIdffW8XpadQNIoHik9aQxrVHR6StBYBRhQI7tzKID_LIV 00001111-aaaa-2222-bbbb-3333cccc4444 Principal   08-01-2024 10:0...
9uBzRwC0s0CFCDQN6O4Ik_fW8XpadQNIoHik9aQxrVHR6StBYBRhQI7tzKID_LIV 11112222-bbbb-3333-cccc-4444dddd5555 Principal   13-01-2024 08:0...

Cet exemple récupère les octrois d’autorisations OAuth2 pour un utilisateur à l’aide du paramètre All.

  • -UserId spécifie l’ID utilisateur.

Exemple 3 : Récupérer un octroi d’autorisation OAuth2 supérieur

Connect-Entra -Scopes 'Directory.Read.All'
Get-EntraUserOAuth2PermissionGrant -ObjectId 'SawyerM@contoso.com' -Top 1

Id                                                               ClientId                             ConsentType ExpiryTime
--                                                               --------                             ----------- ----------
HXFXwKLgoUC4rwbZbCDIdffW8XpadQNIoHik9aQxrVHR6StBYBRhQI7tzKID_LIV 00001111-aaaa-2222-bbbb-3333cccc4444 Principal   08-01-2024 10:0...

Cet exemple récupère le premier octroi d’autorisation OAuth2 dans Microsoft Entra ID. Vous pouvez utiliser -Limit comme alias pour -Top.

  • -UserId spécifie l’ID utilisateur.

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 (en tant que nom d’utilisateur principal ou ObjectId) d’un utilisateur 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.