New-MailContact

  • Article

 

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

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

La commande New-MailContact permet de créer un contact à extension messagerie.

Syntaxe

New-MailContact -Name <String> -ExternalEmailAddress <ProxyAddress> [-Alias <String>] [-Confirm [<SwitchParameter>]] [-DisplayName <String>] [-DomainController <Fqdn>] [-FirstName <String>] [-Initials <String>] [-LastName <String>] [-MacAttachmentFormat <BinHex | UuEncode | AppleSingle | AppleDouble>] [-MessageBodyFormat <Text | Html | TextAndHtml>] [-MessageFormat <Text | Mime>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-PrimarySmtpAddress <SmtpAddress>] [-TemplateInstance <PSObject>] [-UsePreferMessageFormat <$true | $false>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La commande New-MailContact crée un objet contact de messagerie dans Microsoft Active Directory, puis active la messagerie pour le contact de messagerie.

Pour exécuter la cmdlet New-MailContact, 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

ExternalEmailAddress

Obligatoire

Microsoft.Exchange.Data.ProxyAddress

Adresse de messagerie cible.

Name

Obligatoire

System.String

Nom commun du contact de messagerie.

Alias

Facultatif

System.String

Alias du contact de messagerie.

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.

DisplayName

Facultatif

System.String

Nom qui s'affiche dans Microsoft Outlook pour le contact de messagerie.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet du contrôleur de domaine qui écrit ce changement de configuration dans Active Directory, incluez le paramètre DomainController dans la commande.

FirstName

Facultatif

System.String

Prénom du contact de messagerie.

Initials

Facultatif

System.String

Initiales du contact de messagerie.

LastName

Facultatif

System.String

Nom du contact de messagerie.

MacAttachmentFormat

Facultatif

Microsoft.Exchange.Data.Directory.Recipient.MacAttachmentFormat

Le paramètre MacAttachmentFormat spécifie le format de pièce jointe du système d'exploitation Apple Macintosh pour les messages envoyés au contact de messagerie. Les valeurs possibles pour ce paramètre sont :

  • BinHex

  • UUENCODE

  • AppleSingle

  • AppleDouble

Par défaut, ce paramètre est défini sur BinHex.

Les valeurs possibles pour le paramètre MacAttachmentFormat dépendent du paramètre MessageFormat. Si le paramètre MessageFormat est défini sur Texte, vous ne pouvez utiliser que les valeurs BinHex ou UUENCODE pour ce paramètre. Si le paramètre MessageFormat est défini sur Mime, vous ne pouvez utiliser que les valeurs BinHex, AppleSingle ou AppleDouble pour ce paramètre.

MessageBodyFormat

Facultatif

Microsoft.Exchange.Data.Directory.Recipient.MessageBodyFormat

Le paramètre MessageBodyFormat spécifie le format du corps de message pour les messages envoyés au contact de messagerie. Les valeurs possibles pour ce paramètre sont :

  • Text

  • Html

  • TextAndHtml

Par défaut, ce paramètre est défini sur TextAndHtml.

Les paramètres MessageFormat et MessageBodyFormat sont interdépendants. Si le paramètre MessageFormat est défini sur Mime, vous pouvez définir le paramètre MessageBodyFormat sur n'importe quelle valeur valide. En revanche, si le paramètre MessageFormat est défini sur Texte, le paramètre MessageBodyFormat ne peut être défini que sur Texte. C'est pourquoi, si vous voulez définir ce paramètre sur Html ou TextAndHtml, vous devez également définir le paramètre MessageFormat sur Mime.

MessageFormat

Facultatif

Microsoft.Exchange.Data.Directory.Recipient.MessageFormat

Le paramètre MessageFormat spécifie le format de message pour les messages envoyés au contact de messagerie.

Les valeurs possibles pour ce paramètre sont :

  • Text

  • Mime

Par défaut, ce paramètre est défini sur Mime.

Les paramètres MessageFormat et MessageBodyFormat sont interdépendants. Si le paramètre MessageFormat est défini sur Mime, vous pouvez définir le paramètre MessageBodyFormat sur n'importe quelle valeur valide. En revanche, si le paramètre MessageFormat est défini sur Texte, le paramètre MessageBodyFormat ne peut être défini que sur Texte. C'est pourquoi, si vous voulez modifier le paramètre MessageFormat de Mime en Texte, vous devez également modifier le paramètre MessageBodyFormat en Texte.

OrganizationalUnit

Facultatif

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

Unité d'organisation à laquelle le nouveau contact est ajouté. Par exemple, redmond.contoso.com/contacts.

PrimarySmtpAddress

Facultatif

Microsoft.Exchange.Data.SmtpAddress

Ce paramètre permet de spécifier l'adresse SMTP principale du contact de messagerie. Par défaut, l'adresse SMTP principale est générée sur la base de la stratégie d'adresse de messagerie par défaut. Si vous spécifiez une adresse SMTP principale à l'aide de ce paramètre, la cmdlet définit l'attribut EmailAddressPolicyEnabled du contact de messagerie sur $false, et les adresses de messagerie de ce contact de messagerie ne sont pas automatiquement mises à jour en fonction des stratégies d'adresse de messagerie.

TemplateInstance

Facultatif

System.Management.Automation.PSObject

Lorsqu'un objet existant est fourni pour ce paramètre, la commande utilise la configuration de l'objet pour créer un double de l'objet sur un serveur local ou cible.

UsePreferMessageFormat

Facultatif

System.Boolean

Lorsque ce paramètre est défini sur true, il spécifie que les paramètres de format de message préférés du destinataire remplacent les paramètres globaux pour les messages envoyés à cet utilisateur.

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.

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.

Types d'entrées

Types de retours

Erreurs

Erreur Description

Exceptions

Exceptions Description

Exemple

Dans l'exemple suivant, la commande New-MailContact permet de créer un contact à extension messagerie.

New-MailContact -Name "Ted Bremer" -ExternalEmailAddress "ted@tailspintoys.com" -OrganizationalUnit "Marketing"