Condividi tramite

Get-AzureADUser

  • Riferimento
Modulo:
AzureADPreview

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 da Azure Active Directory (AD).

Esempio

Esempio 1: Ottenere dieci utenti

PS C:\>Get-AzureADUser -Top 10

Questo comando ottiene dieci 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: Ricerca 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 in base a userPrincipalName

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

Questo comando ottiene l'utente specificato.

Esempio 5: Ottenere un utente in base a userPrincipalName

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

Questo comando ottiene tutti gli utenti che hanno il titolo iniziano con le vendite. ie Sales Manager e Sales Assistant.

Parametri

-All

Se true, restituisce 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 di 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

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 Azure AD.

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