Get-MailUser (RTM)

Article
09/30/2014

S’applique à : Exchange Server 2007

Dernière rubrique modifiée : 2007-06-05

La cmdlet Get-MailUser permet d'extraire les attributs de messagerie de l'utilisateur spécifié du service d'annuaire Active Directory.

Syntaxe

get-MailUser [-Identity <MailUserIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

Description détaillée

Important :
Dans Microsoft Exchange Server 2007, les paramètres d'utilisateur à extension messagerie sont extraits uniquement avec l'environnement de ligne de commande Exchange Management Shell.

La cmdlet Get-MailUser extrait tous les attributs de messagerie de l'utilisateur spécifié.

Pour exécuter la cmdlet Get-MailUser, 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.

Notes

Les attributs d'utilisateur ne sont pas tous extraits par la cmdlet Get-MailUser. Vous pouvez obtenir des attributs d'utilisateur supplémentaires avec la cmdlet Get-User.

Paramètres

Paramètre	Obligatoire	Type	Description
ANR	Facultatif	System.String	Le paramètre Anr spécifie une chaîne sur laquelle effectuer une recherche de résolution de nom ambigu (ANR). Vous pouvez spécifier une chaîne partielle et rechercher des objets ayant un attribut correspondant à cette chaîne. Les attributs par défaut recherchés sont : CommonName (CN) DisplayName (displayName) FirstName (givenName) LastName (sn) Alias (mailNickname)
Credential	Facultatif	System.Management.Automation.PSCredential	Le paramètre Credential spécifie le compte utilisé pour accéder à Active Directory. En cas d'utilisation du paramètre Credential, la commande vous invite à taper le mot de passe du compte avant de continuer.
DomainController	Facultatif	Microsoft.Exchange.Data.Fqdn	Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui écrit ce changement de configuration dans Active Directory, incluez le paramètre DomainController dans la commande.
Filter	Facultatif	System.String	Le paramètre Filter permet de filtrer la liste des destinataires retournée. Vous pouvez spécifier les attributs à filtrer. 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.MailUserIdParameter	Le paramètre Identity identifie l'utilisateur. Vous pouvez inclure les paramètres ADObjectID, nom unique, LegacyExchangeDN, GUID, Domaine\SamAccountName, nom d'utilisateur principal (UPN), adresse de messagerie ou alias de l'utilisateur.
OrganizationalUnit	Facultatif	Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter	Le paramètre OrganizationalUnit spécifie un conteneur dans lequel limiter les résultats. Vous pouvez spécifier soit une unité d'organisation (UO), soit un domaine. Vous devez spécifier le nom canonique. Par exemple : UO : westcoast.contoso.com/users Domaine : westcoast.contoso.com
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.
ResultSize	Facultatif	Microsoft.Exchange.Data.Unlimited	Le paramètre ResultSize spécifie le nombre maximal d'objets destinataire à renvoyer. S'il n'est pas spécifié, ce paramètre retourne tous les résultats qui correspondent au filtre.
SortBy	Facultatif	System.String	Le paramètre SortBy spécifie l'attribut utilisé pour trier les résultats. Le tri est effectué attribut par attribut et est toujours effectué en ordre croissant.

Types d'entrées

Types de retours

Erreurs

Erreur	Description

Exceptions

Exceptions	Description

Exemple

Dans le premier exemple, la commande Get-MailUser est utilisée sans paramètre pour extraire une liste complète d'utilisateurs à extension messagerie pour toute l'organisation Exchange.

Dans le deuxième exemple, les paramètres de messagerie pour l'utilisateur Ted sont extraits, puis canalisés vers la cmdlet Format-List pour affichage.

Get-MailUser
Get-MailUser -Identity Ted | Format-List

Partager via