Get-User

Article
09/30/2014

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2010-04-27

La cmdlet Get-User permet d'extraire tous les utilisateurs dans la forêt qui correspondent aux conditions spécifiées.

Syntaxe

get-User [-Identity <UserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-User [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

get-User [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Description détaillée

Aucun paramètre n'est obligatoire. Toutefois, vous ne pouvez utiliser qu'un seul des paramètres suivants dans une commande Get-User : Identity, Filter ou Anr.

Pour exécuter la cmdlet Get-User, vous devez utiliser un compte auquel a été délégué :

le rôle Administrateur Affichage seul d'Exchange.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre	Obligatoire	Type	Description
Anr	Facultatif	System.String	Le paramètre Anr indique que l'argument sera résolu à l'aide d'une résolution de nom ambigu (ANR).
Credential	Facultatif	System.Management.Automation.PSCredential	Le paramètre Credential spécifie le compte utilisé pour lire le service d'annuaire Active Directory.
DomainController	Facultatif	Microsoft.Exchange.Data.Fqdn	Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui extrait des données depuis Active Directory, incluez le paramètre DomainController dans la commande.
Filter	Facultatif	System.String	Le paramètre Filter spécifie un ensemble d'attributs qui limitent le nombre de destinataires retournés par la requête. Pour plus d'informations sur les propriétés filtrables, consultez la rubrique Propriétés filtrables pour le paramètre -Filter.
Identity	Facultatif	Microsoft.Exchange.Configuration.Tasks.UserIdParameter	Le paramètre Identity prend l'une des valeurs suivantes : GUID Nom unique Domaine\Compte Nom d'utilisateur principal (UPN) Nom unique Exchange hérité Adresse SMTP (Simple Mail Transfer Protocol) Alias
IgnoreDefaultScope	Facultatif	System.Management.Automation.SwitchParameter	Le paramètre IgnoreDefaultScope donne pour instruction à la commande d'ignorer le paramétrage de la portée du destinataire par défaut pour l'environnement de ligne de commande Exchange Management Shell et d'utiliser l'ensemble de la forêt comme portée. Cela permet à la commande d'accéder à des objets Active Directory ne figurant pas actuellement dans la portée par défaut. L'utilisation du paramètre IgnoreDefaultScope introduit les restrictions suivantes : Vous ne pouvez pas utiliser le paramètre DomainController. La commande utilisera automatiquement un serveur de catalogue global approprié. Vous ne pouvez utiliser le nom unique que pour le paramètre Identity. D'autres formes d'identification, telles qu'un alias ou un GUID, ne sont pas acceptées. Vous ne pouvez pas utiliser les paramètres OrganizationalUnit et Identity ensemble. Vous ne pouvez pas utiliser le paramètre Credential.
OrganizationalUnit	Facultatif	Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter	Le paramètre OrganizationalUnit retourne des objets uniquement de l'unité d'organisation (UO) spécifiée.
ReadFromDomainController	Facultatif	System.Management.Automation.SwitchParameter	Le paramètre ReadFromDomainController spécifie que les informations utilisateur sont lues à partir d'un contrôleur de domaine dans le domaine de l'utilisateur. Si vous définissez la portée du destinataire pour inclure tous les destinataires de la forêt et si vous n'utilisez pas ce paramètre, il est possible que les informations utilisateur soient lues à partir d'un catalogue global avec des informations obsolètes. Si vous utilisez ce paramètre, plusieurs lectures peuvent être nécessaires pour obtenir les informations. > [!Note] > Par défaut, la portée du destinataire est définie sur le domaine qui héberge vos serveurs Exchange.
RecipientTypeDetails	Facultatif	Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[]	Le paramètre RecipientTypeDetails spécifie le type des destinataires renvoyés. Les types de destinataires dans Microsoft Exchange Server 2007 sont divisés en types et sous-types de destinataires. Chaque type de destinataire contient toutes les propriétés de tous les sous-types. Par exemple, le type UserMailbox représente un compte d'utilisateur dans Active Directory avec une boîte aux lettres associée. Comme il y a plusieurs types de boîtes aux lettres, chaque type est identifié par le paramètre RecipientTypeDetails. Par exemple, une boîte aux lettres de salle de conférence a le paramètre RecipientTypeDetails défini sur ConferenceRoomMailbox, tandis qu'une boîte aux lettres d'utilisateur a le paramètre RecipientTypeDetails défini sur UserMailbox. Les détails du type de destinataire disponibles pour ces paramètres sont les suivants : ConferenceRoomMailbox DisabledUser EquipmentMailbox LegacyMailbox LinkedMailbox UserMailbox MailUser User
ResultSize	Facultatif	Microsoft.Exchange.Data.Unlimited	Le paramètre ResultSize définit le nombre maximal de résultats à retourner.
SortBy	Facultatif	System.String	Le paramètre SortBy trie sur un attribut unique en ordre croissant.

Types d'entrées

Types de retours

Erreurs

Erreur	Description

Exceptions

Exceptions	Description

Exemple

Le premier exemple extrait des informations sur les utilisateurs de l'UO Marketing.

Le deuxième exemple utilise le paramètre Filter pour extraire des informations sur tous les utilisateurs dont le titre se termine par « Manager ».

Get-User -OrganizationalUnit "Marketing"
Get-User -Filter {Title -like '*Manager'}

Vous pouvez utiliser tout attribut d'utilisateur Active Directory pour construire une chaîne de filtrage pour le paramètre Filter dans la cmdlet Get-User. Pour plus d'informations sur les opérateurs de comparaison que vous pouvez utiliser dans la chaîne de filtrage, consultez la rubrique Opérateurs de comparaison.

Partager via