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