Get-MsolUser

  • Référence
Module:
MSOnline

Obtient les utilisateurs à partir d’Azure Active Directory.

Syntaxe

Get-MsolUser
   [-ReturnDeletedUsers]
   [-City <String>]
   [-Country <String>]
   [-Department <String>]
   [-DomainName <String>]
   [-EnabledFilter <UserEnabledFilter>]
   [-State <String>]
   [-Synchronized]
   [-Title <String>]
   [-HasErrorsOnly]
   [-LicenseReconciliationNeededOnly]
   [-UnlicensedUsersOnly]
   [-UsageLocation <String>]
   [-SearchString <String>]
   [-MaxResults <Int32>]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolUser
   -ObjectId <Guid>
   [-ReturnDeletedUsers]
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolUser
   [-ReturnDeletedUsers]
   -UserPrincipalName <String>
   [-TenantId <Guid>]
   [<CommonParameters>]
Get-MsolUser
   [-ReturnDeletedUsers]
   [-City <String>]
   [-Country <String>]
   [-Department <String>]
   [-DomainName <String>]
   [-EnabledFilter <UserEnabledFilter>]
   [-State <String>]
   [-Synchronized]
   [-Title <String>]
   [-HasErrorsOnly]
   [-LicenseReconciliationNeededOnly]
   [-UnlicensedUsersOnly]
   [-UsageLocation <String>]
   [-SearchString <String>]
   [-All]
   [-TenantId <Guid>]
   [<CommonParameters>]

Description

L’applet de commande Get-MsolUser obtient un utilisateur individuel ou une liste d’utilisateurs. Spécifiez le paramètre ObjectId ou UserPrincipalName pour obtenir un utilisateur spécifique.

Exemples

Exemple 1 : Obtenir tous les utilisateurs

PS C:\> Get-MsolUser

Cette commande récupère tous les utilisateurs de l’entreprise. Il affiche jusqu’à la valeur par défaut de 500 résultats.

Exemple 2 : Obtenir des utilisateurs activés

PS C:\> Get-MsolUser -EnabledFilter EnabledOnly -MaxResults 2000

Cette commande obtient jusqu’à 2 000 utilisateurs activés.

Exemple 3 : Obtenir un utilisateur par UPN

PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.com"

Cette commande récupère l’utilisateur avec l’UPN davidchew@contoso.com.

Exemple 4 : Obtenir un utilisateur par ID d’objet

PS C:\> Get-MsolUser -ObjectId 81701046-cb37-439b-90ce-2afd9630af7d

Cette commande récupère un utilisateur qui a l’ID d’objet spécifié.

Exemple 5 : Obtenir des utilisateurs par chaîne de recherche

PS C:\> Get-MsolUser -SearchString "David"

Cette commande récupère une liste d’utilisateurs avec David dans le nom d’affichage ou l’adresse e-mail.

Exemple 6 : Obtenir l’emplacement de données préféré d’un utilisateur

PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.onmicrosoft.com" | Select PreferredDataLocation

Cette commande retourne l’emplacement de données préféré d’un utilisateur.

Paramètres

-All

Indique que cette applet de commande retourne tous les résultats. Ne spécifiez pas avec le paramètre MaxResults .

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

-City

Spécifie la ville sur laquelle filtrer les résultats.

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

-Country

Spécifie le pays ou la région sur lequel filtrer les résultats.

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

-Department

Spécifie le service sur lequel filtrer les résultats.

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

-DomainName

Spécifie le domaine sur lequel filtrer les résultats. Il doit s’agir d’un domaine vérifié pour l’entreprise. Tous les utilisateurs disposant d’une adresse e-mail, principale ou secondaire, sur ce domaine sont retournés.

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

-EnabledFilter

Spécifie le filtre pour les utilisateurs activés ou désactivés. Les valeurs valides sont All, EnabledOnly et DisabledOnly.

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

-HasErrorsOnly

Indique que cette applet de commande retourne uniquement les utilisateurs qui ont des erreurs de validation.

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

-LicenseReconciliationNeededOnly

Indique que cette applet de commande filtre uniquement pour les utilisateurs qui ont besoin d’un rapprochement de licence.

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

-MaxResults

Spécifie le nombre maximal de résultats retournés par cette applet de commande. La valeur par défaut est 500.

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

-ObjectId

Spécifie l’ID d’objet unique de l’utilisateur à obtenir.

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

-ReturnDeletedUsers

Indique que cette applet de commande retourne uniquement les utilisateurs dans le bac de recyclage.

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

-SearchString

Spécifie une chaîne pour faire correspondre l’adresse e-mail ou le nom complet à partir de cette chaîne.

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

-State

Spécifie le filtre pour l’état de l’utilisateur.

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

-Synchronized

Indique que cette applet de commande retourne uniquement les utilisateurs qui sont synchronisés via Azure Active Directory Sync.

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

-TenantId

Spécifie l’ID unique du locataire sur lequel effectuer l’opération. La valeur par défaut est le locataire de l’utilisateur actuel. Ce paramètre s’applique uniquement aux utilisateurs partenaires.

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

-Title

Spécifie le filtre pour le titre de l’utilisateur.

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

-UnlicensedUsersOnly

Indique que cette applet de commande retourne uniquement les utilisateurs qui n’ont pas de licence.

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

-UsageLocation

Spécifie le filtre pour le pays ou la région où les services sont consommés par l’utilisateur. Spécifiez un code de pays ou de région à deux lettres.

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

-UserPrincipalName

Spécifie l’ID utilisateur de l’utilisateur à récupérer.

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

Sorties

Microsoft.Online.Administration.User

Cette applet de commande retourne des objets utilisateur, qui incluent les informations suivantes :

  • AlternateEmailAddresses. Autre adresse e-mail de l’utilisateur (externe à Azure Active Directory).

  • BlockCredential. indique si l'utilisateur peut se connecter.

  • City. ville de l'utilisateur.

  • Pays. Pays ou région de l’utilisateur.

  • Département. département de l'utilisateur.

  • DisplayName. Nom complet de l’utilisateur.

  • Erreurs. tableau d'erreurs. Il s'agit d'erreurs de validation qui peuvent entraîner une perte d'accès aux services.

  • Fax. numéro de télécopie de l'utilisateur.

  • Prénom. Prénom de l’utilisateur.

  • ImmuableID. valeur retournée uniquement pour les utilisateurs fédérés. Il s’agit de l’ID qui doit être fédéré avec Azure Active Directory.

  • isBlackBerryUser. indique si l'utilisateur a un appareil BlackBerry.

  • estLicensed. indique si des licences sont affectées à l'utilisateur.

  • LastDirSyncTime. Date et heure de la dernière synchronisation d’annuaires (retournées uniquement par les utilisateurs synchronisés avec Azure Active Directory via la synchronisation Active Directory).

  • LastPasswordChangeTimestamp. Heure la plus récente à laquelle une modification de mot de passe pour l’utilisateur a été inscrite dans Azure Active Directory.

  • LastName. Nom de famille de l’utilisateur.

  • LicenseReconciliationNeededed. indique si l'utilisateur possède actuellement une boîte aux lettres sans licence. Si le cas se présente, l'utilisateur doit disposer d'une licence de 30 jours pour ne pas perdre sa boîte aux lettres.

  • Licences. liste des licences de l'utilisateur.

  • LiveID. ID de connexion unique de l'utilisateur.

  • MobilePhone. numéro de téléphone mobile de l'utilisateur.

  • Objectid. ID unique de l'utilisateur.

  • Bureau. numéro de téléphone fixe de l'utilisateur.

  • OverallProvisioningStatus. indique si des privilèges d'accès ont été attribués à l'utilisateur pour les services.

  • PasswordNeverExpires. indique si le mot de passe de l'utilisateur doit être obligatoirement changé tous les 90 jours.

  • PhoneNumber. numéro de téléphone de l'utilisateur.

  • Postalcode. code postal de l'utilisateur.

  • PreferredDataLocation. Emplacement de données préféré de l’utilisateur.

  • PreferredLanguage. langue par défaut de l'utilisateur

  • ProxyAddresses. Adresses proxy associées à cet utilisateur.

  • State (État). état de l'utilisateur (pour les États-Unis).

  • StreetAddress. adresse de l'utilisateur.

  • StrongPasswordRequired. indique si l'utilisateur doit définir un mot de passe fort quand il change de mot de passe. Les mots de passe forts sont recommandés.

  • Titre. titre de l'utilisateur.

  • UsageLocation. Pays ou région où les services sont consommés par l’utilisateur. Il doit s’agir d’un code de pays ou de région à deux lettres.

  • UserPrincipalName. identifiant utilisateur de l'utilisateur.

  • ValidationStatus. indique si des erreurs sont liées à l'utilisateur.