Get-MailContact

  • Article

 

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-MailContact permet d'extraire d'Active Directory tous les attributs du contact spécifié.

Syntaxe

Get-MailContact [-Identity <MailContactIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

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

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

Description détaillée

Cette cmdlet extrait tous les attributs du contact spécifié. Aucun paramètre n'est obligatoire. Si la cmdlet est exécutée sans paramètre, une liste complète de contacts pour l'organisation Exchange est retournée.

Pour exécuter la cmdlet Get-MailContact, 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 Microsoft 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 spécifié est résolu à l'aide d'une résolution de nom ambigu (ANR). Les attributs par défaut recherchés sont :

  • CommonName (CN)

  • DisplayName (displayName)

  • FirstName (givenName)

  • LastName (sn)

  • Alias (mailNickname)

  • LegacyExchangeDN (legacyExchangeDN)

  • Name (nom) (au lieu de CommonName/CN)

  • EmailAddresses (proxyAddresses)

  • SamAccountName (samAccountName)

  • Office (physicalDeliveryOfficeName)

Credential

Facultatif

System.Management.Automation.PSCredential

Ce paramètre 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 du contrôleur de domaine qui extrait des données d'Active Directory, incluez le paramètre DomainController dans la commande.

Filter

Facultatif

System.String

Ce paramètre 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.MailContactIdParameter

Ce paramètre identifie le contact. Vous pouvez inclure les paramètres ADObjectID, nom unique, LegacyExchangeDN, GUID, Domaine\SamAccountName, nom d'utilisateur principal (UPN), adresse de messagerie ou alias du contact.

OrganizationalUnit

Facultatif

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Ce paramètre 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 également spécifier le nom canonique. Par exemple :

  • UO : westcoast.contoso.com/users

  • Domaine : westcoast.contoso.com

ReadFromDomainController

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre 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 Exchange 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.

Pour cette cmdlet, les détails de type de destinataire disponible sont les suivants :

  • MailEnabledContact

  • MailEnabledForestContact

ResultSize

Facultatif

Microsoft.Exchange.Data.Unlimited

Ce paramètre spécifie le nombre total d'objets destinataire à retourner. S'il n'est pas spécifié, ce paramètre retourne tous les résultats qui correspondent au filtre.

SortBy

Facultatif

System.String

Ce paramètre spécifie l'attribut utilisé pour trier les résultats. Le tri est effectué attribut par attribut et est toujours effectué en ordre croissant.

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 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.

Types d'entrées

Types de retours

Erreurs

Erreur Description

Exceptions

Exceptions Description

Exemple

Dans cet exemple, la commande Get-MailContact est utilisée pour extraire le contact à extension messagerie nommé Ted.

Get-MailContact -Identity Ted | Format-List