Get-AzureADUser
Ruft einen Benutzer ab.
Syntax
GetQuery (Standardwert)
Get-AzureADUser
[-All <Boolean>]
[-Top <Int32>]
[-Filter <String>]
[<CommonParameters>]
GetVague
Get-AzureADUser
[-SearchString <String>]
[-All <Boolean>]
[<CommonParameters>]
GetById
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: Suche unter 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
Mit diesem Cmdlet werden alle Benutzer abgerufen, die den Wert von SearchString mit den ersten Zeichen in DisplayName oder UserPrincipalName abgleichen.
Beispiel 4: Abrufen eines Benutzers anhand von userPrincipalName
PS C:\>Get-AzureADUser -Filter "userPrincipalName eq 'jondoe@contoso.com'"
Mit diesem Befehl wird der angegebene Benutzer abgerufen.
Beispiel 5: Abrufen eines Benutzers anhand von JobTitle
PS C:\>Get-AzureADUser -Filter "startswith(JobTitle,'Sales')"
Mit diesem Befehl werden alle Benutzer abgerufen, deren Berufsbezeichnung mit "Vertrieb" beginnt, z. B. "Sales Manager" und "Sales Assistant".
Parameter
-All
Wenn true, werden alle Benutzer zurückgegeben. Bei false wird die Anzahl der Objekte zurückgegeben, die durch den Top-Parameter angegeben wird
Parametereigenschaften
| Typ: | Boolean |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Filter
Gibt eine OData v3.0-Filteranweisung 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 Funktionen und Operatoren von OData v3.0 unterstützt.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
GetQuery
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-ObjectId
Gibt die ID (als UPN oder ObjectId) eines Benutzers in Microsoft Entra ID an.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
GetById
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-SearchString
Gibt eine Suchzeichenfolge an.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
GetVague
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Top
Gibt die maximale Anzahl von Datensätzen an, die zurückgegeben werden sollen.
Parametereigenschaften
| Typ: | Int32 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
GetQuery
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Hinweise
Weitere Informationen finden Sie im Migrationsleitfaden für Get-AzureADUser zu Microsoft Graph PowerShell.