Udostępnij za pośrednictwem


Get-AzureADUser

Pobiera użytkownika.

Składnia

Get-AzureADUser
   [-All <Boolean>]
   [-Top <Int32>]
   [-Filter <String>]
   [<CommonParameters>]
Get-AzureADUser
   [-SearchString <String>]
   [-All <Boolean>]
   [<CommonParameters>]
Get-AzureADUser
   -ObjectId <String>
   [-All <Boolean>]
   [<CommonParameters>]

Opis

Polecenie cmdlet Get-AzureADUser pobiera użytkownika z identyfikatora Entra firmy Microsoft.

Przykłady

Przykład 1. Uzyskiwanie dziesięciu najlepszych użytkowników

PS C:\>Get-AzureADUser -Top 10

To polecenie pobiera 10 użytkowników.

Przykład 2. Pobieranie użytkownika według identyfikatora

PS C:\>Get-AzureADUser -ObjectId "testUpn@tenant.com"

To polecenie pobiera określonego użytkownika.

Przykład 3. Wyszukiwanie wśród pobranych użytkowników

PS C:\> Get-AzureADUser -SearchString "New"

ObjectId                             DisplayName UserPrincipalName                   UserType
--------                             ----------- -----------------                   --------
5e8b0f4d-2cd4-4e17-9467-b0f6a5c0c4d0 New user    NewUser@contoso.onmicrosoft.com     Member
2b450b8e-1db6-42cb-a545-1b05eb8a358b New user    NewTestUser@contoso.onmicrosoft.com Member

To polecenie cmdlet pobiera wszystkich użytkowników, którzy są zgodni z wartością SearchString względem pierwszych znaków w displayName lub UserPrincipalName.

Przykład 4. Pobieranie użytkownika według userPrincipalName

PS C:\>Get-AzureADUser -Filter "userPrincipalName eq 'jondoe@contoso.com'"

To polecenie pobiera określonego użytkownika.

Przykład 5. Pobieranie użytkownika według elementu JobTitle

PS C:\>Get-AzureADUser -Filter "startswith(JobTitle,'Sales')"

To polecenie pobiera wszystkich użytkowników, których stanowisko rozpoczyna się od sprzedaży, np. Menedżera sprzedaży i Asystenta sprzedaży.

Parametry

-All

Jeśli wartość true, zwróć wszystkich użytkowników. Jeśli wartość false, zwróć liczbę obiektów określonych przez parametr Top

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Filter

Określa instrukcję filtru OData w wersji 3.0. Ten parametr określa, które obiekty są zwracane. Szczegółowe informacje na temat wykonywania zapytań za pomocą protokołu OData można znaleźć tutaj. http://www.odata.org/documentation/odata-version-3-0/odata-version-3-0-core-protocol/#queryingcollections. Obecnie nie wszystkie funkcje i operatory OData w wersji 3.0 są obsługiwane.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ObjectId

Określa identyfikator (jako upN lub ObjectId) użytkownika w identyfikatorze Entra firmy Microsoft.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SearchString

Określa ciąg wyszukiwania.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Top

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

Typ:Int32
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Uwagi

Zobacz przewodnik migracji dla polecenia Get-AzureADUser do programu Microsoft Graph PowerShell.