Get-EntraUserOAuth2PermissionGrant

Modul:
Microsoft.Entra.Users Module v1.3

Hämtar ett oAuth2PermissionGrant-objekt.

Syntax

Default (Standard) 

Get-EntraUserOAuth2PermissionGrant

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

Description

Cmdleten Get-EntraUserOAuth2PermissionGrant hämtar ett oAuth2PermissionGrant-objekt för den angivna användaren i Microsoft Entra ID. Ange UserId parametern för att hämta ett oAuth2PermissionGrant-objekt.

I delegerade scenarier med arbets- eller skolkonton måste den inloggade användaren tilldelas en Microsoft Entra roll som stöds eller en anpassad roll med en rollbehörighet som stöds. Följande minst privilegierade roller stöds för den här åtgärden.

  • Appadministratör
  • Programutvecklare
  • Applikationsadministratör för molnet
  • Katalogförfattare
  • Privilegierad rolladministratör
  • Användaradministratör
  • Katalogläsare
  • Global läsare
  • Gäst inbjudare

Exempel

Exempel 1: Hämta OAuth2-behörighetsbidragen för en användare med hjälp av objekt-ID-parametern

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...

Det här exemplet hämtar OAuth2-behörighetsbidragen för en användare med hjälp av objekt-ID-parametern.

  • -UserId parameter anger användar-ID.

Exempel 2: Hämta OAuth2-behörighetsbidragen för en användare med parametern Alla

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...

Det här exemplet hämtar OAuth2-behörighetsbidragen för en användare med parametern Alla.

  • -UserId parameter anger användar-ID.

Exempel 3: Hämta den översta OAuth2-behörigheten

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...

I det här exemplet Hämtar du den översta behörigheten för OAuth2 i Microsoft Entra ID. Du kan använda -Limit som ett alias för -Top.

  • -UserId parameter anger användar-ID.

Parametrar

-All

Visa en lista över alla sidor.

Parameteregenskaper

Typ:System.Management.Automation.SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Property

Anger egenskaper som ska returneras

Parameteregenskaper

Typ:

System.String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Select

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Top

Anger det maximala antalet poster som ska returneras.

Parameteregenskaper

Typ:System.Int32
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Limit

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-UserId

Anger ID :t (som användarens huvudnamn eller ObjectId) för en användare i Microsoft Entra ID.

Parameteregenskaper

Typ:System.String
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:Objekt-ID, UPN, Identitet, Användarens huvudnamn

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.