Condividi tramite


Get-AzureADUser

Ottiene un utente.

Sintassi

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

Descrizione

Il cmdlet Get-AzureADUser ottiene un utente dall'ID di Microsoft Entra.

Esempio

Esempio 1: Ottenere i primi dieci utenti

PS C:\>Get-AzureADUser -Top 10

Questo comando ottiene 10 utenti.

Esempio 2: Ottenere un utente in base all'ID

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

Questo comando ottiene l'utente specificato.

Esempio 3: Cercare tra gli utenti recuperati

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

Questo cmdlet ottiene tutti gli utenti che corrispondono al valore di SearchString rispetto ai primi caratteri in DisplayName o UserPrincipalName.

Esempio 4: Ottenere un utente da userPrincipalName

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

Questo comando ottiene l'utente specificato.

Esempio 5: Ottenere un utente da JobTitle

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

Questo comando ottiene tutti gli utenti il cui titolo del processo inizia con le vendite, ad esempio Sales Manager e Sales Assistant.

Parametri

-All

Se true, restituire tutti gli utenti. Se false, restituire il numero di oggetti specificati dal parametro Top

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Filter

Specifica un'istruzione filtro OData v3.0. Questo parametro controlla quali oggetti vengono restituiti. Per informazioni dettagliate sull'esecuzione di query con OData, vedere qui. http://www.odata.org/documentation/odata-version-3-0/odata-version-3-0-core-protocol/#queryingcollections. Non tutte le funzioni e gli operatori OData v3.0 sono supportati in questo momento.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ObjectId

Specifica l'ID (come UPN o ObjectId) di un utente in Microsoft Entra ID.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SearchString

Specifica una stringa di ricerca.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Top

Specifica il numero massimo di record da restituire.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Note

Vedere la guida alla migrazione per Get-AzureADUser in Microsoft Graph PowerShell.