.png)
Get-MailContact
S’applique à : Exchange Server 2013, Exchange Online
Dernière rubrique modifiée : 2012-07-11
La cmdlet Get-MailContact permet d’extraire tous les attributs du contact spécifié d’Active Directory.
Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe.
Get-MailContact [-Anr <String>] <COMMON PARAMETERS>
Get-MailContact [-Identity <MailContactIdParameter>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-AccountPartition <AccountPartitionIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>] [-UsnForReconciliationSearch <Int64>]
Cet exemple extrait le contact à extension de messagerie nommé Arlene.
Get-MailContact -Identity Arlene | Format-List
La cmdlet Get-MailContact 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.
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour voir les autorisations qui vous sont nécessaires, voir Section « Autorisations de configuration des destinataires » dans la rubrique Autorisations des destinataires.
| Paramètre | Obligatoire | Type | Description | ||
|---|---|---|---|---|---|
| AccountPartition | Facultatif | Microsoft.Exchange.Configuration.Tasks.AccountPartitionIdParameter | Ce paramètre est réservé à l’usage interne chez Microsoft. | ||
| Anr | Facultatif | System.String | Le paramètre Anr spécifie une chaîne sur laquelle une recherche de résolution de noms ANR (Ambiguous Name Resolution) peut porter. 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 :
| ||
| Credential | Facultatif | System.Management.Automation.PSCredential | Le paramètre Credential spécifie le compte à utiliser pour accéder à Active Directory. Ce paramètre requiert la création et la transmission d’un objet d’informations d’identification. L’objet d’informations d’identification est créé à l’aide de la cmdlet Get-Credential. Pour plus d’informations, consultez la rubrique Get-Credential. | ||
| DomainController | Facultatif | Microsoft.Exchange.Data.Fqdn | Le paramètre DomainController spécifie le nom de domaine complet du contrôleur de domaine qui récupère des données de Active Directory. | ||
| Filter | Facultatif | System.String | Le paramètre Filter indique le filtre OPath utilisé pour filtrer les destinataires. Pour plus d’informations sur les propriétés filtrables, voir Propriétés filtrables pour le paramètre -Filter. | ||
| Identity | Facultatif | Microsoft.Exchange.Configuration.Tasks.MailContactIdParameter | Le paramètre Identity identifie le contact. Ce paramètre accepte les valeurs suivantes :
| ||
| 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 la session 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 :
| ||
| Organization | Facultatif | Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter | Le paramètre Organization est réservé à l’usage interne chez Microsoft. | ||
| 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 également spécifier le nom canonique, par exemple :
| ||
| 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.
| ||
| RecipientTypeDetails | Facultatif | Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[] | Le paramètre RecipientTypeDetails spécifie le type de destinataire renvoyé. Les types de destinataires sont divisés en types et sous-types de destinataires. Chaque type de destinataire contient toutes les propriétés communes 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. Vous pouvez sélectionner l’une des valeurs suivantes :
| ||
| ResultSize | Facultatif | Microsoft.Exchange.Data.Unlimited | Le paramètre ResultSize 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 | Le paramètre SortBy spécifie l'attribut de tri des résultats. Le tri est effectué attribut par attribut et est toujours effectué en ordre croissant. | ||
| UsnForReconciliationSearch | Facultatif | System.Int64 | Ce paramètre est réservé à l’usage interne chez Microsoft. |
Remarque : Pour visualiser les types d’entrées acceptées par cette cmdlet, voir Types d’entrée et de sortie de la cmdlet. Si le champ Type d’entrée pour une cmdlet est vide, la cmdlet n’accepte pas les données d’entrée.
Pour visualiser les types de retour, connus également en tant que types de sortie, acceptés par cette cmdlet, voir Types d’entrée et de sortie de la cmdlet. Si le champ Type de sortie est vide, la cmdlet ne retourne pas de données.
