Get-AzADUser

  • Referenz
Modul:
Az.Resources

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://video2.skills-academy.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

-Mail

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

IMicrosoftGraphUser

Hinweise

ALIASE