Set-Contact

Article
09/30/2014

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2009-05-12

La cmdlet Set-Contact permet de modifier les paramètres d'un contact existant.

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>] [-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>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-Contact [-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>] [-HomePhone <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Initials <String>] [-Instance <Contact>] [-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>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Description détaillée

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.

Pour exécuter la cmdlet Set-Contact, vous devez utiliser un compte auquel ont été délégués :

le rôle Administrateur des destinataires Exchange ;
le rôle Opérateur de compte pour les conteneurs Active Directory applicables.

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
Identity	Obligatoire	Microsoft.Exchange.Configuration.Tasks.ContactIdParameter	Le paramètre Identity spécifie l'objet que vous voulez modifier. Le paramètre Identity peut prendre l'une des valeurs suivantes pour l'objet contact : GUID Nom unique Nom canonique Name Vous ne pouvez pas utiliser le paramètre Identity si le paramètre Instance est spécifié.
AllowUMCallsFromNonUsers	Facultatif	Microsoft.Exchange.Data.Directory.Recipient.AllowUMCallsFromNonUsersFlags	Ce paramètre spécifie d'exclure le contact des recherches dans l'annuaire.
AssistantName	Facultatif	System.String	La paramètre AssistantName définit 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 paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm.
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	Ce paramètre indique qu’une carte DTMF (multifréquence bi-tonalité) peut être créée pour le contact.
Department	Facultatif	System.String	Le paramètre Department définit le département du contact.
DisplayName	Facultatif	System.String	Le paramètre DisplayName permet de spécifier le nom du contact dans la console de gestion Exchange et dans la liste d'adresses globale (LAG) d'Exchange. DisplayName n'a de signification que pour les objets à extension messagerie.
DomainController	Facultatif	Microsoft.Exchange.Data.Fqdn	Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui écrit ce changement de configuration dans le service d'annuaire Active Directory, incluez le paramètre DomainController.
Fax	Facultatif	System.String	Le paramètre Fax définit le numéro de télécopie du contact.
FirstName	Facultatif	System.String	Le paramètre FirstName définit le prénom du contact.
HomePhone	Facultatif	System.String	Le paramètre HomePhone définit 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 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 que 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 définit les initiales du nom du contact.
Instance	Facultatif	Microsoft.Exchange.Data.Directory.Management.Contact	Le paramètre Instance permet de transmettre un objet entier à la commande à traiter. Il est principalement utilisé dans les scripts où un objet entier doit être transmis à la commande. Vous ne pouvez pas utiliser le paramètre Instance si le paramètre Identity est spécifié.
LastName	Facultatif	System.String	La paramètre LastName définit le nom de famille du contact.
Manager	Facultatif	Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter	Le paramètre Manager définit le responsable du contact.
MobilePhone	Facultatif	System.String	Le paramètre MobilePhone définit 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 la console de gestion Exchange si le groupe est à extension messagerie. La valeur Name ne peut pas dépasser 64 caractères.
Notes	Facultatif	System.String	Le paramètre Notes définit des informations supplémentaires sur le contact.
Office	Facultatif	System.String	Ce paramètre Office définit le nom ou le numéro professionnel physique du contact.
OtherFax	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre OtherFax définit l'autre numéro de télécopie du contact.
OtherHomePhone	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre OtherHomePhone définit l'autre numéro de téléphone personnel du contact.
OtherTelephone	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre OtherTelephone définit l'autre numéro de téléphone professionnel du contact.
Pager	Facultatif	System.String	Le paramètre Pager définit le numéro de récepteur de radiomessagerie du contact.
Phone	Facultatif	System.String	Le paramètre Phone définit 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. Pour plus d'informations sur la paramètre PhoneticDisplayName et la reconnaissance vocale, consultez la rubrique Présentation des recherches dans l'annuaire de reconnaissance vocale automatique.
PostalCode	Facultatif	System.String	Le paramètre PostalCode définit le code postal du contact.
PostOfficeBox	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Le paramètre PostOfficeBox définit le numéro de boîte postale du contact.
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é. Le jeu de caractères limité comprend les caractères suivants : abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:? 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 définit l'adresse physique du contact.
TelephoneAssistant	Facultatif	System.String	Le paramètre TelephoneAssistant définit le numéro de téléphone de l'assistant du contact.
Title	Facultatif	System.String	Le paramètre Title définit le titre du contact.
UMDialPlan	Facultatif	Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter	Ce paramètre spécifie l'identificateur d'objet annuaire pour le plan de commutation des appels.
UMDtmfMap	Facultatif	Microsoft.Exchange.Data.MultiValuedProperty	Ce paramètre indique si vous voulez créer une carte DTMF définie par l'utilisateur pour le contact à extension messagerie unifiée.
UseRusServer	Facultatif	System.String	> [!Note] > Ce paramètre n'est disponible que dans Exchange 2007 SP2. Le paramètre UseRusServer indique à la commande d'utiliser le serveur de boîtes aux lettres spécifié sur lequel le service de listes d'adresses est exécuté pour obtenir puis définir les attributs des boîtes aux lettres et des utilisateurs Active Directory. Le service de listes d'adresses est un composant du service Surveillance du système Exchange. Le service de listes d'adresses crée et gère les valeurs des attributs spécifiques d'Exchange dans Active Directory. Vous pouvez utiliser le service de listes d'adresses pour mettre à jour les objets destinataire dans un domaine à l'aide d'informations spécifiques telles que l'appartenance à une liste d'adresses et des adresses de messagerie.
WebPage	Facultatif	System.String	Le paramètre WebPage définit la page Web du contact.
WhatIf	Facultatif	System.Management.Automation.SwitchParameter	Le paramètre 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 paramètre WhatIf.
WindowsEmailAddress	Facultatif	Microsoft.Exchange.Data.SmtpAddress	Le paramètre WindowsEmailAddress spécifie l'adresse de messagerie du contact stockée dans Active Directory.

Types d'entrées

Types de retours

Erreurs

Erreur	Description

Exceptions

Exceptions	Description

Exemple

L'exemple de code suivant montre comment utiliser la cmdlet Set-Contact pour apporter les modifications suivantes à un contact existant nommé Ted Bremer dans le conteneur Users du domaine Active Directory nommé contoso.com :

remplacer la valeur du paramètre City par Seattle ;
remplacer la valeur du paramètre Company par Contoso.

Set-Contact -Identity "contoso.com/Users/Ted Bremer" -City "Seattle" -Company "Contoso"