Set-Contact

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2016-04-06

Cette cmdlet est disponible dans Exchange Server 2016 sur site et dans le service en nuage. Certains paramètres peuvent être propres à un environnement ou à un autre.

La cmdlet Set-Contact permet de modifier les paramètres d’objet contact. Si le contact est un contact de messagerie, vous pouvez utiliser la cmdlet Set-MailContact pour modifier d’autres paramètres Microsoft Exchange qui ne sont pas disponibles en utilisant la cmdlet Set-Contact.

Pour plus d'informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir SyntaxeSyntaxe de cmdlet Exchange.

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 existant 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"

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 la 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 le contact que vous voulez modifier. Vous pouvez utiliser n’importe quelle valeur qui identifie le contact de manière unique.

Par exemple :

  • Nom

  • Nom complet

  • Nom unique (DN)

  • Nom unique canonique

  • GUID

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 spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.

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

Le paramètre CreateDTMFMap spécifie s’il faut créer un plan DTMF (numérotation en fréquences vocales) pour le destinataire. Ainsi, le destinataire peut être identifié à l’aide d’un clavier de téléphone dans les environnements de messagerie unifiée (MU). Les valeurs valides sont les suivantes :

  • $true   Un plan DTMF est créé pour le destinataire. Il s’agit de la valeur par défaut.

  • $false   Aucun plan DTMF n’est créé pour le destinataire.

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 d’affichage du contact. Le nom complet est visible dans le Centre d’administration Exchange et dans les listes d’adresses. La longueur maximale est de 256 caractères. Si la valeur contient des espaces, mettez le nom entre guillemets (").

Ce paramètre n’a de signification que s’il s’agit d’un contact à extension messagerie.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple : dc01.contoso.com.

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 de l’utilisateur.

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 :

  • Latitude et longitude   Par exemple, "47.644125;-122.122411"

  • Latitude, longitude et altitude   Par exemple, "47.644125;-122.122411;161.432"

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

Ce paramètre est disponible uniquement dans Exchange 2016 sur site.

Le commutateur IgnoreDefaultScope donne pour instruction à la commande d’ignorer le paramétrage de l’étendue du destinataire par défaut pour la session Exchange Management Shell et d’utiliser l’ensemble de la forêt comme étendue. Cela permet à la commande d’accéder à des objets Active Directory ne figurant pas actuellement dans l’étendue par défaut.

L’utilisation du commutateur IgnoreDefaultScope introduit les restrictions suivantes :

  • Vous ne pouvez pas utiliser le paramètre DomainController. La commande utilise automatiquement un serveur de catalogue global approprié.

  • Vous ne pouvez utiliser que 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.

Initials

Facultatif

System.String

Le paramètre Initials spécifie le deuxième prénom de l’utilisateur.

LastName

Facultatif

System.String

Le paramètre LastName spécifie le nom de famille de l’utilisateur.

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 unique du contact. La longueur maximale est de 64 caractères. Si la valeur contient des espaces, mettez le nom entre guillemets (").

Notes

Facultatif

System.String

Le paramètre Notes spécifie des informations supplémentaires sur l’objet. Si la valeur contient des espaces, placez-la entre guillemets (").

Office

Facultatif

System.String

Le paramètre Office spécifie le nom ou le numéro professionnel physique de l'utilisateur.

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 autre orthographe du nom de l’utilisateur qui est utilisée pour la conversion de texte par synthèse vocale dans des environnements de messagerie unifiée (MU). En règle générale, vous utilisez ce paramètre lorsque la prononciation et l’orthographe du nom de l’utilisateur ne correspondent pas. La longueur maximale est de 256 caractères. Si la valeur contient des espaces, placez-la entre guillemets (").

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é. Les caractères valides sont les suivants :

  • a - z

  • A - Z

  • 0 - 9

  • « <space> », « " », « ' », « ( », « ) », « + », « , », « - », « . », « / », « : » et « ? ».

Ce paramètre n’a de signification que s’il s’agit d’un contact à 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 spécifie les valeurs de plan DTMF (numérotation en fréquences vocales) pour le destinataire. Ainsi, le destinataire peut être identifié à l’aide d’un clavier de téléphone dans les environnements de messagerie unifiée (MU). En règle générale, ces valeurs DTMF sont automatiquement créées et mises à jour, mais vous pouvez utiliser ce paramètre pour apporter des modifications manuellement. Ce paramètre utilise la syntaxe suivante :

  • emailAddress:<integers>

  • lastNameFirstName:<integers>

  • firstNameLastName:<integers>

Pour saisir des valeurs qui remplacent toutes les entrées existantes, utilisez la syntaxe suivante : emailAddress:<integers>,lastNameFirstName:<integers>,firstNameLastName:<integers>.

Si vous utilisez cette syntaxe et si vous omettez l’une des valeurs de plan DTMF, ces valeurs sont supprimées du destinataire. Par exemple, si vous spécifiez uniquement emailAddress:<integers>, toutes les valeurs lastNameFirstName et firstNameLastName existantes sont supprimées.

Pour ajouter ou supprimer des valeurs sans affecter les entrées existantes, utilisez la syntaxe suivante : @{Add="emailAddress:<integers>","lastNameFirstName:<integers>","firstNameLastName:<integers>"; Remove="emailAddress:<integers>","lastNameFirstName:<integers>","firstNameLastName:<integers>"}.

Si vous utilisez cette syntaxe, vous n’avez pas besoin de spécifier toutes les valeurs de plan DTMF et vous pouvez spécifier plusieurs valeurs de plan DTMF. Par exemple, vous pouvez utiliser @{Add="emailAddress:<integers1>","emailAddress:<intgers2>} pour ajouter deux nouvelles valeurs pour emailAddress sans affecter les valeurs lastNameFirstName et firstNameLastName existantes.

WebPage

Facultatif

System.String

Le paramètre WebPage spécifie la page web du contact.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

WindowsEmailAddress

Facultatif

Microsoft.Exchange.Data.SmtpAddress

Le paramètre WindowsEmailAddress spécifie l’adresse de messagerie Windows pour ce destinataire. Il s’agit d’un attribut Active Directory commun qui est présent dans tous les environnements, y compris les environnements sans Exchange. L’utilisation du paramètre WindowsEmailAddress sur un destinataire entraîne l’une des conséquences suivantes :

  • Dans les environnements locaux où le destinataire est soumis à des stratégies d’adresse de messagerie (la propriété EmailAddressPolicyEnabled est définie sur la valeur True pour le destinataire), le paramètre WindowsEmailAddress n’a aucune incidence sur la propriété WindowsEmailAddress ou sur la valeur d’adresse de messagerie principale.

  • Dans les environnements en nuage ou les environnements locaux où le destinataire n’est pas soumis à des stratégies d’adresse de messagerie (la propriété EmailAddressPolicyEnabled est définie sur la valeur False pour le destinataire), le paramètre WindowsEmailAddress met à jour la propriété WindowsEmailAddress et l’adresse de messagerie principale sur la même valeur.

La propriété WindowsEmailAddress est visible pour le destinataire dans Utilisateurs et ordinateurs Active Directory dans l’attribut E-mail. Le nom commun d’attribut est E-mail-Addresses, et le Ldap-Display-Name est mail. Si vous modifiez cet attribut dans Active Directory, l’adresse de messagerie principale du destinataire n’est pas mise à jour sur la même valeur.

Pour visualiser les types d’entrées acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. 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 retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d’entrée et de sortie de la cmdlet d’Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.

 
Afficher: