Partager via

Get-AzureADUser

  • Référence
Module:
AzureAD

Obtient un utilisateur.

Syntaxe

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

Description

L’applet de commande Get-AzureADUser obtient un utilisateur à partir de l’ID Microsoft Entra.

Exemples

Exemple 1 : Obtenir les dix premiers utilisateurs

PS C:\>Get-AzureADUser -Top 10

Cette commande obtient 10 utilisateurs.

Exemple 2 : Obtenir un utilisateur par ID

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

Cette commande obtient l’utilisateur spécifié.

Exemple 3 : Rechercher parmi les utilisateurs récupérés

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

Cette applet de commande obtient tous les utilisateurs qui correspondent à la valeur de SearchString par rapport aux premiers caractères dans DisplayName ou UserPrincipalName.

Exemple 4 : Obtenir un utilisateur par userPrincipalName

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

Cette commande obtient l’utilisateur spécifié.

Exemple 5 : Obtenir un utilisateur par JobTitle

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

Cette commande obtient tous les utilisateurs dont le poste commence par les ventes, par exemple le directeur des ventes et l’assistant des ventes.

Paramètres

-All

Si la valeur est true, retournez tous les utilisateurs. Si la valeur est false, retourne le nombre d’objets spécifié par le paramètre Top

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Filter

Spécifie une instruction de filtre OData v3.0. Ce paramètre contrôle les objets retournés. Vous trouverez plus d’informations sur l’interrogation avec OData ici. http://www.odata.org/documentation/odata-version-3-0/odata-version-3-0-core-protocol/#queryingcollections. Toutes les fonctions et opérateurs OData v3.0 ne sont pas pris en charge pour l’instant.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ObjectId

Spécifie l’ID (en tant qu’UPN ou ObjectId) d’un utilisateur dans l’ID Microsoft Entra.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SearchString

Spécifie une chaîne de recherche.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Top

Spécifie le nombre maximal d’enregistrements à retourner.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Notes

Consultez le guide de migration de Get-AzureADUser vers Microsoft Graph PowerShell.