Delen via

Get-AzureADUser

  • Referentie
Module:
AzureAD

Hiermee wordt een gebruiker opgehaald.

Syntaxis

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

Description

Met de cmdlet Get-AzureADUser wordt een gebruiker opgehaald uit de Microsoft Entra ID.

Voorbeelden

Voorbeeld 1: de tien beste gebruikers ophalen

PS C:\>Get-AzureADUser -Top 10

Met deze opdracht krijgt u 10 gebruikers.

Voorbeeld 2: Een gebruiker ophalen op id

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

Met deze opdracht wordt de opgegeven gebruiker ophaalt.

Voorbeeld 3: Zoeken tussen opgehaalde gebruikers

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

Met deze cmdlet worden alle gebruikers opgehaald die de waarde van SearchString vergelijken met de eerste tekens in DisplayName of UserPrincipalName.

Voorbeeld 4: Een gebruiker ophalen op userPrincipalName

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

Met deze opdracht wordt de opgegeven gebruiker ophaalt.

Voorbeeld 5: Een gebruiker ophalen met JobTitle

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

Met deze opdracht haalt u alle gebruikers op waarvan de functie begint met verkoop, bijvoorbeeld Verkoopmanager en Verkoopassistent.

Parameters

-All

Als dit waar is, retourneert u alle gebruikers. Als onwaar, retourneert u het aantal objecten dat is opgegeven door de topparameter

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Filter

Hiermee geeft u een OData v3.0-filterinstructie. Deze parameter bepaalt welke objecten worden geretourneerd. Meer informatie over het uitvoeren van query's met OData vindt u hier. http://www.odata.org/documentation/odata-version-3-0/odata-version-3-0-core-protocol/#queryingcollections. Op dit moment worden niet alle OData v3.0-functies en -operators ondersteund.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ObjectId

Hiermee geeft u de id (als een UPN of ObjectId) van een gebruiker in Microsoft Entra ID.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-SearchString

Hiermee geeft u een zoektekenreeks op.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Top

Hiermee geeft u het maximum aantal records dat moet worden geretourneerd.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Notities

Zie de migratiehandleiding voor Get-AzureADUser naar Microsoft Graph PowerShell.