Udostępnij przez

Get-AzADUser

Moduł:
Az.Resources Module

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

Składnia

List (Domyślne) 

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

MailParameterSet 

Get-AzADUser
    -Mail <String>
    [-Expand <String[]>]
    [-Select <String[]>]
    [-First <UInt64>]
    [-Skip <UInt64>]
    [-AppendSelected]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

DisplayNameParameterSet 

Get-AzADUser
    -DisplayName <String>
    [-Expand <String[]>]
    [-Select <String[]>]
    [-First <UInt64>]
    [-Skip <UInt64>]
    [-AppendSelected]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

StartsWithParameterSet 

Get-AzADUser
    -StartsWith <String>
    [-Expand <String[]>]
    [-Select <String[]>]
    [-First <UInt64>]
    [-Skip <UInt64>]
    [-AppendSelected]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

ObjectIdParameterSet 

Get-AzADUser
    -ObjectId <String>
    [-Expand <String[]>]
    [-Select <String[]>]
    [-AppendSelected]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

UPNParameterSet 

Get-AzADUser
    -UserPrincipalName <String>
    [-Expand <String[]>]
    [-Select <String[]>]
    [-AppendSelected]
    [-DefaultProfile <PSObject>]
    [<CommonParameters>]

SignedInUser 

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

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów: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/

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

List
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Count

Uwzględnij liczbę elementów

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

List
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-CountVariable

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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

List
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-DefaultProfile

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

Właściwości parametrów

Typ:PSObject
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zbiory parametrów

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

-DisplayName

nazwa wyświetlana użytkownika

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

DisplayNameParameterSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Expand

Rozwijanie powiązanych jednostek

Właściwości parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

(All)
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów: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

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

List
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-First

Pobiera tylko pierwsze obiekty "n".

Właściwości parametrów

Typ:UInt64
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

List
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
MailParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
DisplayNameParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
StartsWithParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Mail

adres e-mail użytkownika

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

MailParameterSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-ObjectId

key: identyfikator użytkownika

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

ObjectIdParameterSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Orderby

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

Właściwości parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

List
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Search

Wyszukiwanie elementów według fraz wyszukiwania

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

List
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Select

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

Właściwości parametrów

Typ:

String[]

Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

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

-SignedIn

adres e-mail użytkownika

Właściwości parametrów

Typ:SwitchParameter
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

SignedInUser
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-Skip

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

Właściwości parametrów

Typ:UInt64
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False

Zbiory parametrów

List
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
MailParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
DisplayNameParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False
StartsWithParameterSet
Pozycja:Named
Obowiązkowy:False
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-StartsWith

nazwa wyświetlana użytkownika zaczyna się od

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:Ciąg wyszukiwania

Zbiory parametrów

StartsWithParameterSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość pozostałych argumentów:False

-UserPrincipalName

główna nazwa użytkownika

Właściwości parametrów

Typ:String
Wartość domyślna:None
Wspiera dzikie karty:False
DontShow:False
Aliasy:nazwa UPN

Zbiory parametrów

UPNParameterSet
Pozycja:Named
Obowiązkowy:True
Wartość z pipeline:False
Wartość z pipeline według nazwy właściwości:False
Wartość 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.

Wyjść

IMicrosoftGraphUser