Dela via


Get-AzureADUser

Hämtar en användare.

Syntax

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

Description

Cmdleten Get-AzureADUser hämtar en användare från Microsoft Entra-ID:t.

Exempel

Exempel 1: Hämta de tio främsta användarna

PS C:\>Get-AzureADUser -Top 10

Det här kommandot hämtar 10 användare.

Exempel 2: Hämta en användare efter ID

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

Det här kommandot hämtar den angivna användaren.

Exempel 3: Sök bland hämtade användare

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

Den här cmdleten hämtar alla användare som matchar värdet för SearchString mot de första tecknen i DisplayName eller UserPrincipalName.

Exempel 4: Hämta en användare efter userPrincipalName

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

Det här kommandot hämtar den angivna användaren.

Exempel 5: Hämta en användare via JobTitle

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

Det här kommandot hämtar alla användare vars befattning börjar med försäljning, t.ex. Försäljningsansvarig och Försäljningsassistent.

Parametrar

-All

Om det är sant returnerar du alla användare. Om värdet är falskt returnerar du antalet objekt som anges av parametern Top

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Filter

Anger en OData v3.0-filtersats. Den här parametern styr vilka objekt som returneras. Information om frågor med OData finns här. http://www.odata.org/documentation/odata-version-3-0/odata-version-3-0-core-protocol/#queryingcollections. För närvarande stöds inte alla OData v3.0-funktioner och operatorer.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-ObjectId

Anger ID :t (som ett UPN eller ObjectId) för en användare i Microsoft Entra-ID.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-SearchString

Anger en söksträng.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Top

Anger det maximala antalet poster som ska returneras.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Kommentarer

Se migreringsguiden för Get-AzureADUser till Microsoft Graph PowerShell.