Get-AzADUser
Listet Entitäten von Benutzern auf oder ruft entitäten von Benutzern anhand des Schlüssels ab.
Syntax
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>]
Beschreibung
Listet Entitäten von Benutzern auf oder ruft entitäten von Benutzern anhand des Schlüssels ab.
Beispiele
Beispiel 1: Abrufen eines Anmeldebenutzers
Get-AzADUser -SignedIn
Anmeldebenutzer abrufen
Beispiel 2: Benutzer auflisten
Get-AzADUser -First 10 -Select 'City' -AppendSelected
Listet zuerst 10 Benutzer auf und fügt die Eigenschaft "City" nach Standardeigenschaften an: 'DisplayName', 'Id', 'DeletedDateTime', 'UserPrincipalName', 'UsageLocation', 'GivenName', 'SurName', 'AccountEnabled', 'MailNickName', 'Mail'
Beispiel 3: Abrufen eines Benutzers nach Anzeigename
Get-AzADUser -DisplayName $name
Benutzer nach Anzeigename abrufen
Beispiel 4: Abrufen von Benutzern mit Filter
Get-AzADUser -Filter "startsWith(DisplayName,'some-name')"
Benutzer mit Filter abrufen
Beispiel 5: Zuweisen von OdataCount zu einer Variablen
Get-AzADUser -First 10 -ConsistencyLevel eventual -Count -CountVariable 'result'
$result
Zuweisen von OdataCount zu einer Variablen
Parameter
-AppendSelected
Eigenschaften anfügen, die mit Standardeigenschaften ausgewählt sind, wenn dieser Schalter aktiviert ist, funktioniert nur mit dem Parameter "-Select".
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ConsistencyLevel
Gibt die angeforderte Konsistenzstufe an. Dokumentations-URL: https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Count
Anzahl der Elemente einschließen
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-CountVariable
Gibt eine Anzahl der Gesamtanzahl der Elemente in einer Auflistung an. Diese Variable wird standardmäßig im globalen Bereich festgelegt.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
Typ: | PSObject |
Aliase: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-DisplayName
Anzeigename des Benutzers
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Expand
Erweitern verwandter Entitäten
Typ: | String[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Filter
Filtern von Elementen nach Eigenschaftswerten, weitere Details zur Filterabfrage finden Sie unter: https://learn.microsoft.com/en-us/graph/filter-query-parameter
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-First
Ruft nur die ersten n -Objekte ab.
Typ: | UInt64 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Benutzer-E-Mail-Adresse
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ObjectId
key: ID des Benutzers
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Orderby
Elemente nach Eigenschaftswerten sortieren
Typ: | String[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Search
Durchsuchen von Elementen nach Suchbegriffen
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Select
Eigenschaften auswählen, die zurückgegeben werden sollen
Typ: | String[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SignedIn
Benutzer-E-Mail-Adresse
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Skip
Ignoriert die ersten n-Objekte und ruft dann die verbleibenden Objekte ab.
Typ: | UInt64 |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-StartsWith
Der Anzeigename des Benutzers beginnt mit
Typ: | String |
Aliase: | SearchString |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-UserPrincipalName
Benutzerprinzipalname
Typ: | String |
Aliase: | UPN |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Ausgaben
Hinweise
ALIASE
Azure PowerShell