Partager via


Set-Contact

 

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"