Udostępnij za pośrednictwem


Get-AzADUser

Wyświetla listę jednostek od użytkowników lub pobieranie jednostek od użytkowników według klucza

Składnia

Get-AzADUser
   [-Count]
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-Filter <String>]
   [-Orderby <String[]>]
   [-Search <String>]
   [-ConsistencyLevel <String>]
   [-DefaultProfile <PSObject>]
   [-CountVariable <String>]
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -Mail <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -DisplayName <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -StartsWith <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -ObjectId <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -UserPrincipalName <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [-SignedIn]
   [<CommonParameters>]

Opis

Wyświetla listę jednostek od użytkowników lub pobieranie jednostek od użytkowników według klucza

Przykłady

Przykład 1. Uzyskiwanie użytkownika logowania

Get-AzADUser -SignedIn

Uzyskiwanie użytkownika logowania

Przykład 2. Wyświetlanie listy użytkowników

Get-AzADUser -First 10 -Select 'City' -AppendSelected

Wyświetl pierwszych 10 użytkowników i dołącz właściwość "City" po właściwościach domyślnych: "DisplayName", "Id", "DeletedDateTime", "UserPrincipalName", "UsageLocation", "GivenName", "SurName", "AccountEnabled", "MailNickName", "Mail"

Przykład 3. Pobieranie użytkownika według nazwy wyświetlanej

Get-AzADUser -DisplayName $name

Pobieranie użytkownika według nazwy wyświetlanej

Przykład 4. Pobieranie użytkownika z filtrem

Get-AzADUser -Filter "startsWith(DisplayName,'some-name')"

Pobieranie użytkownika z filtrem

Przykład 5. Przypisywanie zmiennej OdataCount do zmiennej

Get-AzADUser -First 10 -ConsistencyLevel eventual -Count -CountVariable 'result'
$result

Przypisywanie wartości OdataCount do zmiennej

Parametry

-AppendSelected

Dołącz właściwości wybrane z właściwościami domyślnymi, gdy ten przełącznik jest włączony, działa tylko z parametrem "-Select".

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

-ConsistencyLevel

Wskazuje żądany poziom spójności. Adres URL dokumentacji: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

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

-Count

Uwzględnij liczbę elementów

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

-CountVariable

Określa liczbę całkowitej liczby elementów w kolekcji. Domyślnie ta zmienna zostanie ustawiona w zakresie globalnym.

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

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:PSObject
Aliasy:AzContext, AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DisplayName

nazwa wyświetlana użytkownika

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

-Expand

Rozwijanie powiązanych jednostek

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

-Filter

Filtruj elementy według wartości właściwości, aby uzyskać więcej szczegółów na temat zapytania filtru, zobacz: https://learn.microsoft.com/en-us/graph/filter-query-parameter

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

-First

Pobiera tylko pierwsze obiekty "n".

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

-Mail

adres e-mail użytkownika

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

-ObjectId

key: identyfikator użytkownika

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

-Orderby

Porządkowaj elementy według wartości właściwości

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

Wyszukiwanie elementów według fraz wyszukiwania

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

-Select

Wybierz właściwości, które mają zostać zwrócone

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

-SignedIn

adres e-mail użytkownika

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

-Skip

Ignoruje pierwsze obiekty "n", a następnie pobiera pozostałe obiekty.

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

-StartsWith

nazwa wyświetlana użytkownika zaczyna się od

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

-UserPrincipalName

Nazwa główna użytkownika

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

Dane wyjściowe

IMicrosoftGraphUser