Get-EntraUserOAuth2PermissionGrant

Moduł:
Microsoft.Entra.Users Module v1.3

Pobiera obiekt oAuth2PermissionGrant.

Składnia

Default (domyślnie) 

Get-EntraUserOAuth2PermissionGrant

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

Opis

Polecenie Get-EntraUserOAuth2PermissionGrant cmdlet pobiera obiekt oAuth2PermissionGrant dla określonego użytkownika w Microsoft Entra ID. Określ UserId parametr, aby pobrać obiekt oAuth2PermissionGrant.

W scenariuszach delegowanych z kontami służbowymi zalogowany użytkownik musi mieć przypisaną obsługiwaną rolę Microsoft Entra lub rolę niestandardową z obsługiwanym uprawnieniem roli. Następujące najmniej uprzywilejowane role są obsługiwane dla tej operacji.

  • Administrator aplikacji
  • Programista aplikacji
  • Administrator aplikacji w chmurze
  • Autorzy katalogów
  • Administrator ról uprzywilejowanych
  • Administrator użytkowników
  • Czytelnicy katalogów
  • Globalny czytnik
  • Osoba zapraszająca gości

Przykłady

Przykład 1. Pobieranie uprawnień OAuth2 dla użytkownika przy użyciu parametru identyfikatora obiektu

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

W tym przykładzie są pobierane uprawnienia OAuth2 dla użytkownika przy użyciu parametru identyfikatora obiektu.

  • -UserId parametr określa identyfikator użytkownika.

Przykład 2. Pobieranie uprawnień OAuth2 dla użytkownika przy użyciu parametru Wszystkie

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

W tym przykładzie są pobierane uprawnienia OAuth2 dla użytkownika przy użyciu parametru All.

  • -UserId parametr określa identyfikator użytkownika.

Przykład 3. Pobieranie najwyższego poziomu uprawnień OAuth2

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

W tym przykładzie pobierz pierwsze uprawnienie OAuth2 w Microsoft Entra ID. Możesz użyć -Limit jako aliasu dla -Top.

  • -UserId parametr określa identyfikator użytkownika.

Parametry

-All

Wyświetl listę wszystkich stron.

Właściwości parametru

Typ:System.Management.Automation.SwitchParameter
Domyślna wartość:False
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Property

Określa właściwości, które mają być zwracane

Właściwości parametru

Typ:

System.String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Select

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Top

Określa maksymalną liczbę rekordów do zwrócenia.

Właściwości parametru

Typ:System.Int32
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Ograniczenie

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-UserId

Określa identyfikator (jako główną nazwę użytkownika lub identyfikator objectId) użytkownika w Microsoft Entra ID.

Właściwości parametru

Typ:System.String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:Identyfikator Obiektu, nazwa UPN, Identity, NazwaGłównaUżytkownika

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.