Get-AzureADUser

  • Referenz
Modul:
AzureAD

Ruft einen Benutzer ab.

Syntax

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

Beschreibung

Das Cmdlet Get-AzureADUser ruft einen Benutzer aus der Microsoft Entra-ID ab.

Beispiele

Beispiel 1: Abrufen der zehn besten Benutzer

PS C:\>Get-AzureADUser -Top 10

Dieser Befehl ruft 10 Benutzer ab.

Beispiel 2: Abrufen eines Benutzers nach ID

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

Mit diesem Befehl wird der angegebene Benutzer abgerufen.

Beispiel 3: Suchen zwischen abgerufenen Benutzern

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

Dieses Cmdlet ruft alle Benutzer ab, die dem Wert von SearchString mit den ersten Zeichen in DisplayName oder UserPrincipalName übereinstimmen.

Beispiel 4: Abrufen eines Benutzers nach userPrincipalName

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

Mit diesem Befehl wird der angegebene Benutzer abgerufen.

Beispiel 5: Abrufen eines Benutzers nach JobTitle

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

Mit diesem Befehl werden alle Benutzer abgerufen, deren Jobtitel mit "Sales" beginnt, z. B. "Sales Manager" und "Sales Assistant".

Parameter

-All

Wenn true, geben Sie alle Benutzer zurück. Wenn false, geben Sie die Anzahl der Objekte zurück, die vom Top-Parameter angegeben sind.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Filter

Gibt eine OData v3.0-Filteranweisungen an. Dieser Parameter steuert, welche Objekte zurückgegeben werden. Details zur Abfrage mit OData finden Sie hier. http://www.odata.org/documentation/odata-version-3-0/odata-version-3-0-core-protocol/#queryingcollections. Derzeit werden nicht alle OData v3.0-Funktionen und -Operatoren unterstützt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ObjectId

Gibt die ID (als UPN oder ObjectId) eines Benutzers in Microsoft Entra ID an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-SearchString

Gibt eine Suchzeichenfolge an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Top

Gibt die maximale Anzahl von Datensätzen an, die zurückgegeben werden sollen.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Hinweise

Weitere Informationen finden Sie im Migrationsleitfaden für Get-AzureADUser zu Microsoft Graph PowerShell.