Partager via


Get-AzADUser

Répertorie les entités d’utilisateurs ou obtenir une entité à partir d’utilisateurs par clé

Syntaxe

Get-AzADUser
   [-Count]
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-Filter <String>]
   [-Orderby <String[]>]
   [-Search <String>]
   [-ConsistencyLevel <String>]
   [-DefaultProfile <PSObject>]
   [-CountVariable <String>]
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -Mail <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -DisplayName <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -StartsWith <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -ObjectId <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -UserPrincipalName <String>
   [<CommonParameters>]
Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [-SignedIn]
   [<CommonParameters>]

Description

Répertorie les entités d’utilisateurs ou obtenir une entité à partir d’utilisateurs par clé

Exemples

Exemple 1 : Obtenir l’utilisateur de connexion

Get-AzADUser -SignedIn

Obtenir l’utilisateur de connexion

Exemple 2 : Répertorier les utilisateurs

Get-AzADUser -First 10 -Select 'City' -AppendSelected

Répertorier les 10 premiers utilisateurs et ajouter la propriété « City » après les propriétés par défaut : « DisplayName », « Id », « DeletedDateTime », « UserPrincipalName », « UsageLocation », « GivenName », « SurName », « AccountEnabled », « MailNickName », « MailNickName », « Mail »

Exemple 3 : Obtenir l’utilisateur par nom d’affichage

Get-AzADUser -DisplayName $name

Obtenir l’utilisateur par nom d’affichage

Exemple 4 : Obtenir l’utilisateur avec un filtre

Get-AzADUser -Filter "startsWith(DisplayName,'some-name')"

Obtenir l’utilisateur avec un filtre

Exemple 5 : Affecter OdataCount à une variable

Get-AzADUser -First 10 -ConsistencyLevel eventual -Count -CountVariable 'result'
$result

Affecter OdataCount à une variable

Paramètres

-AppendSelected

Ajoutez les propriétés sélectionnées avec les propriétés par défaut lorsque ce commutateur est activé, fonctionne uniquement avec le paramètre « -Select ».

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

-ConsistencyLevel

Indique le niveau de cohérence demandé. URL de la documentation : https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

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

-Count

Inclure le nombre d’éléments

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

-CountVariable

Spécifie le nombre total d’éléments d’une collection. Par défaut, cette variable est définie dans l’étendue globale.

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

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:PSObject
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DisplayName

nom d’affichage de l’utilisateur

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

-Expand

Développer les entités associées

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

-Filter

Filtrez les éléments par valeurs de propriété, pour plus d’informations sur la requête de filtre, consultez : https://learn.microsoft.com/en-us/graph/filter-query-parameter

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

-First

Obtient uniquement les premiers objets 'n'.

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

-Mail

adresse de messagerie de l’utilisateur

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

-ObjectId

clé : ID de l’utilisateur

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

-Orderby

Classer les éléments par valeurs de propriété

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

Rechercher des éléments par expressions de recherche

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

-Select

Sélectionner les propriétés à renvoyer

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

-SignedIn

adresse de messagerie de l’utilisateur

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

-Skip

Ignore les premiers objets « n », puis obtient les objets restants.

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

-StartsWith

Le nom d’affichage de l’utilisateur commence par

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

-UserPrincipalName

nom d’utilisateur principal

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

Sorties

IMicrosoftGraphUser