Partager via


Set-Contact (RTM)

 

S’applique à : Exchange Server 2007

Dernière rubrique modifiée : 2007-06-17

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

Syntaxe

Set-Contact -Identity <ContactIdParameter> [-AssistantName <String>] [-City <String>] [-Company <String>] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-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>] [-WebPage <String>]

Set-Contact [-AssistantName <String>] [-City <String>] [-Company <String>] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-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>] [-WebPage <String>]

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 plus d'informations sur la cmdlet Set-MailContact, consultez la rubrique Set-MailContact (RTM).

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é.

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.

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.

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é. Ce jeu de caractères limité comprend les caractères ASCII 26 à 126 inclus. 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 numérotation.

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.

WebPage

Facultatif

System.String

Le paramètre WebPage définit la page Web du contact.

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"