.png)
Set-Contact
S’applique à : Exchange Server 2013, Exchange Online
Dernière rubrique modifiée : 2012-10-16
La cmdlet Set-Contact permet de modifier les paramètres d'un contact existant.
Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe.
Set-Contact -Identity <ContactIdParameter> [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AssistantName <String>] [-City <String>] [-Company <String>] [-Confirm [<SwitchParameter>]] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-GeoCoordinates <GeoCoordinates>] [-HomePhone <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Initials <String>] [-LastName <String>] [-Manager <UserContactIdParameter>] [-MobilePhone <String>] [-Name <String>] [-Notes <String>] [-Office <String>] [-OtherFax <MultiValuedProperty>] [-OtherHomePhone <MultiValuedProperty>] [-OtherTelephone <MultiValuedProperty>] [-Pager <String>] [-Phone <String>] [-PhoneticDisplayName <String>] [-PostalCode <String>] [-PostOfficeBox <MultiValuedProperty>] [-SeniorityIndex <Int32>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMCallingLineIds <MultiValuedProperty>] [-UMDtmfMap <MultiValuedProperty>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]
Cet exemple apporte les modifications suivantes au contact Arlene Huff dans le conteneur Users du domaine contoso.com d'Active Directory :
-
Remplacez la valeur du paramètre City par Seattle.
-
Remplacez la valeur du paramètre Company par Contoso.
Set-Contact -Identity "contoso.com/Users/Arlene Huff" -City "Seattle" -Company "Contoso"
La cmdlet Set-Contact permet de modifier les paramètres des objets contact visibles dans Utilisateurs et ordinateurs Active Directory. Si le contact est à extension messagerie, utilisez la cmdlet Set-MailContact pour modifier les paramètres de messagerie du contact qui ne sont pas disponibles via la cmdlet Set-Contact.
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 |
|---|---|---|---|
| Identity | Obligatoire | Microsoft.Exchange.Configuration.Tasks.ContactIdParameter | Le paramètre Identity spécifie l'objet que vous voulez modifier. Ce paramètre accepte les valeurs suivantes :
|
| AllowUMCallsFromNonUsers | Facultatif | Microsoft.Exchange.Data.Directory.Recipient.AllowUMCallsFromNonUsersFlags | Le paramètre AllowUMCallsFromNonUsers indique d'exclure le contact des recherches dans l'annuaire. |
| AssistantName | Facultatif | System.String | Le paramètre AssistantName spécifie le nom de l'assistant du contact. |
| City | Facultatif | System.String | Le paramètre City définit la ville du contact. |
| Company | Facultatif | System.String | Le paramètre Company définit la société du contact. |
| Confirm | Facultatif | System.Management.Automation.SwitchParameter | Le commutateur Confirm peut être utilisé pour supprimer la boîte de dialogue de confirmation qui s’affiche par défaut lorsque cette cmdlet est exécutée. Pour supprimer la boîte de dialogue de confirmation, utilisez la syntaxe de |
| CountryOrRegion | Facultatif | Microsoft.Exchange.Data.Directory.CountryInfo | Le paramètre CountryOrRegion définit le pays ou la région du contact. |
| CreateDTMFMap | Facultatif | System.Boolean | La paramètre CreateDTMFMap indique qu'un plan DTMF (numérotation en fréquences vocales) peut être créé pour le contact. |
| Department | Facultatif | System.String | Le paramètre Department définit le service du contact. |
| DisplayName | Facultatif | System.String | Le paramètre DisplayName spécifie le nom du contact dans le Centre d’administration Exchange et dans la liste d’adresses globale Exchange. Le paramètre DisplayName n’a de signification que pour les objets à extension messagerie. |
| DomainController | Facultatif | Microsoft.Exchange.Data.Fqdn | Le paramètre DomainController spécifie le nom de domaine complet (FQDN) du contrôleur de domaine qui écrit ce changement de configuration dans Active Directory. |
| Fax | Facultatif | System.String | Le paramètre Fax spécifie le numéro de télécopie du contact. |
| FirstName | Facultatif | System.String | Le paramètre FirstName spécifie le prénom du contact. |
| GeoCoordinates | Facultatif | Microsoft.Exchange.Data.GeoCoordinates | Le paramètre GeoCoordinates désigne l’emplacement physique du contact (coordonnées en latitude, longitude et altitude). Utilisez ce paramètre pour spécifier la position globale de l’emplacement du contact. Vous devez spécifier un des jeux de coordonnées suivants ; utilisez des points-virgules pour séparer les valeurs :
|
| HomePhone | Facultatif | System.String | Le paramètre HomePhone spécifie le numéro de téléphone personnel du contact. |
| 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 :
|
| Initials | Facultatif | System.String | Le paramètre Initials spécifie les initiales du nom du contact. |
| LastName | Facultatif | System.String | Le paramètre LastName spécifie le nom du contact. |
| Manager | Facultatif | Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter | Le paramètre Manager spécifie le responsable du contact. |
| MobilePhone | Facultatif | System.String | Le paramètre MobilePhone spécifie le numéro de téléphone mobile principal du contact. |
| Name | Facultatif | System.String | Le paramètre Name spécifie le nom contact dans Utilisateurs et ordinateurs Active Directory, ainsi que dans le champ Nom de groupe dans le Centre d’administration de Exchange si le groupe est à extension messagerie. La valeur du paramètre Name ne peut pas dépasser 64 caractères. |
| Notes | Facultatif | System.String | Le paramètre Notes spécifie des informations supplémentaires sur le contact. |
| Office | Facultatif | System.String | Le paramètre Office spécifie le nom ou le numéro professionnel physique du contact. |
| OtherFax | Facultatif | Microsoft.Exchange.Data.MultiValuedProperty | Le paramètre OtherFax spécifie l'autre numéro de télécopie du contact. |
| OtherHomePhone | Facultatif | Microsoft.Exchange.Data.MultiValuedProperty | Le paramètre OtherHomePhone spécifie l'autre numéro de téléphone personnel du contact. |
| OtherTelephone | Facultatif | Microsoft.Exchange.Data.MultiValuedProperty | Le paramètre OtherTelephone spécifie l'autre numéro de téléphone professionnel du contact. |
| Pager | Facultatif | System.String | Le paramètre Pager spécifie le numéro de récepteur de radiomessagerie du contact. |
| Phone | Facultatif | System.String | Le paramètre Phone spécifie le numéro de téléphone professionnel du contact. |
| PhoneticDisplayName | Facultatif | System.String | Le paramètre PhoneticDisplayName spécifie une prononciation phonétique pour le paramètre DisplayName. La longueur maximale de cette valeur de paramètre est de 255 caractères. |
| PostalCode | Facultatif | System.String | Le paramètre PostalCode spécifie le code postal du contact. |
| PostOfficeBox | Facultatif | Microsoft.Exchange.Data.MultiValuedProperty | Le paramètre PostOfficeBox spécifie le numéro de boîte postale du contact. |
| SeniorityIndex | Facultatif | System.Int32 | Le paramètre SeniorityIndex spécifie l’ordre dans lequel ce contact s’affichera dans un carnet d’adresses hiérarchique. Un contact avec une valeur de 2 apparaîtra à un niveau plus haut dans un carnet d’adresses qu’un contact avec une valeur de 1. |
| SimpleDisplayName | Facultatif | System.String | Le paramètre SimpleDisplayName permet d’afficher une autre description de l’objet lorsque seul un jeu de caractères limité est autorisé. Ce jeu de caractères limité comprend les caractères ASCII 26 à 126 inclus. Le paramètre SimpleDisplayName n'a de signification que pour les objets à extension messagerie. |
| StateOrProvince | Facultatif | System.String | Le paramètre StateOrProvince définit l'état ou la province du contact. |
| StreetAddress | Facultatif | System.String | Le paramètre StreetAddress spécifie l'adresse physique du contact. |
| TelephoneAssistant | Facultatif | System.String | Le paramètre TelephoneAssistant spécifie le numéro de téléphone de l'assistant du contact. |
| Title | Facultatif | System.String | Le paramètre Title spécifie la fonction du contact. |
| UMCallingLineIds | Facultatif | Microsoft.Exchange.Data.MultiValuedProperty | Le paramètre UMCallingLineIds spécifie les numéros de téléphone ou les extensions pouvant être mappés à un utilisateur à extension messagerie unifiée. Pour spécifier plusieurs numéros de téléphone par utilisateur, séparez les entrées par une virgule. Les valeurs de ce paramètre doivent comporter moins de 128 caractères et peuvent inclure, en option, le signe plus (+) placé avant le numéro. Chaque utilisateur à extension messagerie unifiée doit avoir une valeur de paramètre UMCallingLineIds unique. |
| UMDtmfMap | Facultatif | Microsoft.Exchange.Data.MultiValuedProperty | Le paramètre UMDtmfMap indique si vous voulez créer un plan DTMF défini par l'utilisateur pour le contact à extension messagerie unifiée. |
| WebPage | Facultatif | System.String | Le paramètre WebPage spécifie la page Web du contact. |
| WhatIf | Facultatif | System.Management.Automation.SwitchParameter | Le commutateur WhatIf donne pour instruction à la commande de simuler les actions qu’elle va appliquer à l’objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n’est pas nécessaire de spécifier une valeur pour le commutateur WhatIf. |
| WindowsEmailAddress | Facultatif | Microsoft.Exchange.Data.SmtpAddress | Le paramètre WindowsEmailAddress spécifie l’adresse de messagerie du contact stockée dans Active Directory. |
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.
