Get-Contact
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-Contact permet d'extraire des informations sur un ou plusieurs contacts spécifiés.
Syntaxe
Get-Contact [-Identity <ContactIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Contact [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-Contact [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Description détaillée
La cmdlet Get-Contact interroge les propriétés d'un contact spécifique ou d'objets destinataires du contact dans le service d'annuaire Active Directory.
Pour exécuter la cmdlet Get-Contact, 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 est utilisé pour rechercher des objets correspondant à une chaîne partielle fournie. Cette fonction est similaire à une recherche utilisant des caractères génériques. |
Credential |
Facultatif |
System.Management.Automation.PSCredential |
Le paramètre Credential spécifie le compte utilisé pour interroger Active Directory sur les informations d'identification du contact. |
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 utilisés pour limiter 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.ContactIdParameter |
Le paramètre Identity prend l'une des 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 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 :
|
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. Pour cette commande, les détails de type de destinataire disponible sont les suivants :
|
ResultSize |
Facultatif |
Microsoft.Exchange.Data.Unlimited |
Le paramètre ResultSize spécifie le nombre maximal de résultats à retourner. |
SortBy |
Facultatif |
System.String |
Le paramètre SortBy spécifie de trier sur un attribut unique en ordre croissant. |
Types d'entrées
Types de retours
Erreurs
| Erreur | Description |
|---|---|
|
|
Exceptions
| Exceptions | Description |
|---|---|
|
Exemple
Dans cet exemple, la commande Get-Contact récupère le contact Ted Bremer et envoie l'objet vers la commande Format-List afin d'afficher les informations sur le contact.
Get-Contact -Identity TedBremer | Format-List