Partager via

New-SendConnector (RTM)

  • Article

 

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

Dernière rubrique modifiée : 2007-08-27

La cmdlet New-SendConnector permet de créer un connecteur d'envoi sur un ordinateur sur lequel le rôle serveur de transport Hub ou Edge est installé.

Syntaxe

New-SendConnector -Name <String> -AddressSpaces <MultiValuedProperty> [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-MaxMessageSize <Unlimited>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-TemplateInstance <PSObject>] [-Usage <Custom | Internal | Internet | Partner>] [-UseExternalDNSServersEnabled <$true | $false>]

New-SendConnector -Name <String> [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-TemplateInstance <PSObject>] [-Usage <Custom | Internal | Internet | Partner>] [-UseExternalDNSServersEnabled <$true | $false>]

Description détaillée

Cette cmdlet crée un connecteur d’envoi. Pour être invité à entrer les paramètres requis d'un nouveau connecteur d'envoi, tapez New-SendConnector. Une fois cette tâche accomplie, un connecteur d'envoi est créé.

Pour exécuter la cmdlet New-SendConnector, vous devez utiliser un compte auquel le rôle Administrateur de serveur Exchange et le groupe Administrateurs local ont été délégués pour le serveur cible.

Pour exécuter la cmdlet New-SendConnector sur un ordinateur sur lequel le rôle serveur de transport Edge est installé, vous devez ouvrir une session en utilisant un compte membre du groupe Administrateurs local sur cet ordinateur.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Microsoft Exchange Server 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

AddressSpaces

Obligatoire

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre est obligatoire à moins que ce connecteur ne soit lié à un connecteur de réception via le paramètre LinkedReceiveConnector. Le paramètre AddressSpaces spécifie les noms de domaine auxquels le connecteur d'envoi envoie des messages. Vous pouvez spécifier plusieurs espaces d'adressage en les séparant par des virgules. La syntaxe complète pour la saisie de chaque espace d'adressage est la suivante :

<ConnectorScope>:<AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • ConnectorScope   Si vous spécifiez la valeur Local, le connecteur peut uniquement être utilisé par les autres serveurs de transport Hub existant dans le même site Active Directory, tels que le serveur de transport Hub source sur lequel vous exécutez la cmdlet New-SendConnector. Si le qualificatif ConnectorScope est omis, le connecteur peut être utilisé par tous les serveurs de transport Hub existant dans l'organisation Exchange 2007.

  • AddressSpaceType   Sur un serveur de transport Edge, le type d'espace d'adressage doit être SMTP. Sur un serveur de transport Hub, le type d'espace d'adressage peut être SMTP, X400, ou toute chaîne de texte. Si vous omettez le type d'espace d'adressage, un type d'espace d'adressage SMTP est supposé.

  • AddressSpace   Pour les types d'espaces d'adressages SMTP, l'espace d'adressage que vous entrez doit être conforme à la norme RFC 1035. Par exemple, *, *.com et *.contoso.com sont autorisés mais *contoso.com ne l'est pas. Pour les types d'espaces d'adressages X.400, l'espace d'adressage que vous entrez doit être conforme à la norme RFC 1685, tel que o=MySite;p=MyOrg;a=adatum;c=us. Pour toutes les autres valeurs de type d'adressage, vous pouvez entrer un texte quelconque pour l'espace d'adressage.

  • AddressSpaceCost    La plage d'entrées valides pour le coût s'étend de 1 à 100. Plus le coût est bas, meilleure est la route. Ce paramètre est facultatif. Si vous omettez le coût d'espace d'adressage, un coût de 1 est supposé. Si vous entrez un espace d'adressage non-SMTP contenant le caractère point-virgule ( ; ), vous devez spécifier le coût d'espace d'adressage.

Vous devez uniquement utiliser la syntaxe complète pour le paramètre AddressSpaces dans les conditions suivantes :

  • connecteurs étendus auxquels le qualificatif Local est attribué ;

  • espaces d’adressage non-SMTP ;

  • espaces d’adressage SMTP avec un coût autre que 1.

Vous pouvez spécifier plusieurs espaces d'adressage en les séparant par des virgules, comme suit, par exemple : contoso.com,fabrikam.com. Si vous spécifiez la portée du connecteur, le type d'espace d'adressage ou le coût d'espace d'adressage, vous devez placer l'espace d'adressage entre guillemets ( " ), par exemple, comme suit : "contoso.com;2","fabrikam.com;3".

Si vous spécifiez un type d'espace d'adressage non-SMTP sur un connecteur d'envoi configuré sur un serveur de transport Hub, les paramètres suivants sont obligatoires sur le connecteur d'envoi :

  • Vous devez utiliser un hôte actif pour router des messages en spécifiant une valeur pour le paramètre SmartHosts.

  • La valeur du paramètre DNSRoutingEnabled doit être $False.

> [!Note] > Bien que vous puissiez configurer des espaces d'adressage non-SMTP sur un connecteur d'envoi situé sur un serveur de transport Hub, le connecteur d'envoi utilise le protocole SMTP comme mécanisme de transport pour envoyer des messages à d'autres serveurs de messagerie. Les connecteurs étrangers sur les serveurs de transport Hub sont utilisés pour envoyer des messages à des serveurs de messagerie locaux, tels que des serveurs de passerelle de télécopie tiers, qui n'utilisent pas le protocole SMTP comme mécanisme de transport principal. Pour plus d'informations, consultez la rubrique Connecteurs étrangers.

Nom

Obligatoire

System.String

Le paramètre spécifie le nom du connecteur fourni par l'administrateur. Vous devez placer le paramètre Name entre guillemets si le nom contient des espaces, comme suit, par exemple : "New Send Connector".

AuthenticationCredential

Facultatif

System.Management.Automation.PSCredential

Ce paramètre requiert la création et la transmission d'un objet informations d'identification. L'objet informations d'identification est créé à l'aide de la cmdlet Get-Credential. Pour plus d'informations sur l'utilisation de la cmdlet Get-Credential, tapez Get-Help Get-Credential dans l'environnement de ligne de commande Exchange Management Shell.

Comment

Facultatif

System.String

Le paramètre Comment doit être placé entre guillemets, par exemple : "this is an admin note".

ConnectionInactivityTimeOut

Facultatif

Microsoft.Exchange.Data.EnhancedTimeSpan

Ce paramètre spécifie le temps maximal pendant lequel une connexion inactive reste ouverte. La valeur par défaut est 10 minutes. Pour spécifier une valeur, entrez-la sous forme de période : jj.hh:mm:ss, où j = jours, h = heures, m = minutes et s = secondes. La plage d'entrées valides pour ce paramètre s'étend de 00:00:01 à 1.00:00:00.

DNSRoutingEnabled

Facultatif

System.Boolean

Les valeurs valides pour le paramètre DnsRoutingEnabled sont $True ou $False. La valeur par défaut est $True. Si vous spécifiez le paramètre SmartHosts, le paramètre DnsRoutingEnabled doit être défini sur $False dans la même ligne de commande.

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 dans la commande. Le paramètre DomainController n'est pas pris en charge sur les ordinateurs qui exécutent le rôle serveur de transport Edge. Le rôle serveur de transport Edge écrit et lit uniquement sur l'instance ADAM locale.

DomainSecureEnabled

Facultatif

System.Boolean

Ce paramètre est une partie du processus d’activation de l’authentification TLS (Transport Layer Security) mutuelle pour les domaines couverts par le connecteur d’envoi. L'authentification TLS mutuelle ne fonctionne correctement que si les conditions suivantes sont vraies :

  • La valeur du paramètre DomainSecureEnabled est définie sur $True.

  • La valeur du paramètre DNSRoutingEnabled est définie sur $True.

  • La valeur du paramètre IgnoreStartTLS est définie sur $False.

Le caractère générique (*) n'est pas pris en charge dans des domaines configurés pour l'authentification TLS mutuelle. Le même domaine doit également être défini sur le connecteur de réception correspondant et dans la valeur du paramètre TLSReceiveDomainSecureList de la cmdlet Get-TransportConfig.

La valeur par défaut du paramètre DomainSecureEnabled est $False pour les types de connecteurs d’envoi suivants :

  • tous les connecteurs d'envoi définis sur un serveur de transport Hub ;

  • les connecteurs d’envoi créés par l’utilisateur définis sur un serveur de Transport Edge.

La valeur par défaut du paramètre DomainSecureEnabled est $True pour les types de connecteurs d’envoi suivants :

  • les connecteurs d’envoi par défaut définis sur un serveur de Transport Edge.

Enabled

Facultatif

System.Boolean

Les valeurs valides pour ce paramètre sont $True ou $False. La valeur par défaut est $True. Le paramètre Enabled permet d'activer ou de désactiver la capacité du connecteur à traiter des messages électroniques.

Force

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre supprime les messages d'avertissement ou de confirmation qui s'affichent durant certaines modifications de configuration.

ForceHELO

Facultatif

System.Boolean

Les valeurs valides pour ce paramètre sont $True ou $False. La valeur par défaut est $False. Par défaut, EHLO est utilisé. Si ce paramètre est défini sur $True, HELO est envoyé au lieu de EHLO.

Fqdn

Facultatif

Microsoft.Exchange.Data.Fqdn

Ce paramètre spécifie le nom de domaine complet utilisé somme serveur source pour les serveurs de messagerie connectés qui utilisent le connecteur d'envoi pour recevoir des messages sortants. La valeur de ce paramètre s'affiche pour les serveurs de messagerie connectés chaque fois qu'un nom de serveur source est requis, comme dans les exemples suivants :

  • Dans la commande EHLO/HELO, lorsque le connecteur d'envoi communique avec le serveur de messagerie du saut suivant

  • Dans le dernier champ d'en-tête Received: du message ajouté au message par le serveur de messagerie du saut suivant après que le message a quitté le serveur de transport Hub ou Edge

  • Durant l'authentification TLS

La valeur par défaut du paramètre Fqdn est $Null. Cela signifie que la valeur de nom de domaine complet par défaut réelle est le nom de domaine complet du serveur de transport Hub ou Edge contenant le connecteur d'envoi.

noteRemarque :
Si le connecteur d'envoi est configuré sur un serveur de transport Hub sur lequel est également installé le rôle serveur de boîtes aux lettres, aucune valeur spécifiée pour le paramètre Fqdn n'est utilisée. Au lieu de cela, le nom de domaine complet du serveur affiché à l'aide de la cmdlet Get-ExchangeServer est toujours utilisé.
Pour les serveurs sur lesquels le rôle serveur de transport Hub et le rôle serveur de boîtes aux lettres sont installés, la seule manière de supprimer le nom du serveur des en-têtes Received: du message sortant consiste à utiliser la cmdlet Remove-ADPermission pour supprimer l'autorisation Ms-Exch-Send-Headers-Routing des entités de sécurité utilisant le connecteur. Cette action supprime tous les en-têtes Received: du message lorsque le message quitte le serveur de transport Hub. Il est recommandé de ne pas supprimer les en-têtes Received: pour les messages internes car les en-têtes Received: sont utilisés pour les calculs de nombre maximal de sauts. Pour plus d'informations sur les cmdlets Remove-ADPermission et Get-ExchangeServer, consultez les rubriques suivantes :
• Remove-ADPermission (RTM)
• Get-ExchangeServer (RTM)

IgnoreSTARTTLS

Facultatif

System.Boolean

Ce paramètre spécifie s'il faut ignorer l'option StartTLS offerte par un serveur d'envoi distant. Ce paramètre est utilisé avec des domaines distants. Ce paramètre doit être défini sur $False si le paramètre RequireTLS est défini sur $True. Les valeurs valides pour ce paramètre sont $True et $False.

LinkedReceiveConnector

Facultatif

Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter

Ce paramètre force la transmission des messages reçus par le connecteur de réception spécifié via ce connecteur d'envoi. La valeur du paramètre LinkedReceivedConnector peut utiliser un des identificateurs suivants pour spécifier le connecteur de réception :

  • GUID

  • Nom unique

  • Nom_du_serveur\Nom_du_connecteur

Lorsque vous utilisez le paramètre LinkReceiveConnector avec la cmdlet New-SendConnector, vous devez également utiliser les paramètres suivants avec les valeurs spécifiées :

  • DNSRoutingEnabled $False

  • MaxMessageSize unlimited

  • Smarthosts <SmarthostID>

  • SmarthostAuthMechanism <AuthMechanism>

Lorsque vous utilisez le paramètre LinkedReceiveConnector, vous ne devez pas utiliser le paramètre AddressSpace.

MaxMessageSize

Facultatif

Microsoft.Exchange.Data.Unlimited

La valeur MaxMessageSize spécifie la taille maximale d'un message transitant par un connecteur. Vous pouvez également surcharger ce paramètre en entrant unlimited si vous ne voulez pas imposer de limites de message sur ce connecteur. La valeur par défaut est 10MB. Lorsque vous entrez un nombre entier, qualifiez la valeur à l'aide de l'une des unités suivantes :

  • B (octets)

  • KB (kilo-octets)

  • MB (mégaoctets)

  • GB (gigaoctets)

Les valeurs non qualifiées sont traitées comme des octets. Les valeurs entrées en octets sont arrondies au Ko le plus proche. Par exemple, 1048575B est arrondi à 1MB et 1048577 à 1025KB. La plage d'entrées valides pour ce paramètre s'étend de 0 à 2147483647 .

Port

Facultatif

System.Int32

Ce paramètre est un nombre entier compris entre 0 et 65535. La valeur par défaut est 25. Si vous spécifiez une valeur dans le paramètre SmartHosts, la valeur Port spécifie le numéro de port utilisé pour le transfert d'hôte actif. Dans la plupart des organisations, le numéro de port est défini sur 25.

ProtocolLoggingLevel

Facultatif

Microsoft.Exchange.Data.ProtocolLoggingLevel

Ce paramètre active ou désactive l’enregistrement dans le journal de protocole du connecteur d’envoi spécifié. La valeur Verbose active la journalisation de protocole pour le connecteur. La valeur None désactive la journalisation de protocole pour le connecteur. L’emplacement des journaux de protocole des connecteurs d’envoi pour tous les connecteurs d’envoi configurés sur un serveur de transport Hub ou Edge est spécifié à l’aide du paramètre SendProtocolLogPath de la cmdlet Set-TransportServer.

RequireTLS

Facultatif

System.Boolean

Ce paramètre spécifie si tous les messages envoyés via ce connecteur doivent être transmis à l'aide de TLS. La valeur par défaut est $False.

SmartHostAuthMechanism

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.SmtpSendConnectorConfig+AuthMechanisms

Ce paramètre est utilisé en cours d'authentification auprès d'un serveur distant. Ce paramètre n'est utilisé que si un hôte actif est configuré et si le paramètre DNSRoutingEnabled est défini sur $False. Les valeurs valides sont None, BasicAuth, BasicAuthRequireTLS, ExchangeServer et ExternalAuthoritative. Toutes les valeurs s'excluent mutuellement. Si vous sélectionnez BasicAuth ou BasicAuthRequireTLS, vous devez utiliser le paramètre AuthenticationCredential pour spécifier les informations d'authentification.

SmartHosts

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre est requis si vous voulez définir le paramètre DnsRoutingEnabled sur $False et doit être spécifié dans la même ligne de commande. Le paramètre SmartHosts prend un ou plusieurs noms de domaine complets (FQDN), tels que server.contoso.com, ou une ou plusieurs adresses IP, ou encore une combinaison de FQDN et d'adresses IP. Séparez les valeurs par des virgules. Si vous entrez une adresse IP, vous devez entrer l'adresse IP sous la forme d'un littéral, par exemple : 10.10.1.1. L'identité de l'hôte actif peut être le nom de domaine complet du serveur hôte actif, un enregistrement de serveur de messagerie (MX) ou un enregistrement d'adresse (A). Si vous configurez un nom de domaine complet comme l’identité de l’hôte actif, le serveur source pour le connecteur d’envoi doit être capable d’utiliser la résolution de nom DNS pour localiser le serveur de l’hôte actif.

SourceIPAddress

Facultatif

System.Net.IPAddress

Ce paramètre spécifie l'adresse IP locale à utiliser comme point de terminaison d'une connexion SMTP vers un serveur de messagerie distant. L'adresse IP par défaut est 0.0.0.0. Cette valeur indique au serveur d'utiliser toute adresse IP locale disponible. Ce paramètre est uniquement valide pour les connecteurs d'envoi configurés sur des serveurs de transport Edge.

SourceTransportServers

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre spécifie les noms des serveurs de transport Hub qui utilisent ce connecteur d'envoi. Vous pouvez spécifier les noms de plusieurs serveurs de transport Hub en les séparant par des virgules. Ce paramètre n'est pas valide pour les connecteurs d'envoi configurés sur des serveurs de transport Edge.

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 une copie identique de l'objet sur un serveur local ou cible.

Usage

Facultatif

Microsoft.Exchange.Management.SystemConfigurationTasks.NewSendConnector+UsageType

Ce paramètre vous aide à configurer les valeurs par défaut du connecteur en fonction de la manière dont il sera utilisé. Les valeurs valides pour ce paramètre sont les suivantes : Custom, Internal, Internet ou Partner. Pour plus d'informations sur les options d'utilisation des connecteurs d'envoi, consultez la rubrique Connecteurs d'envoi.

UseExternalDNSServersEnabled

Facultatif

System.Boolean

Ce paramètre spécifie si ce connecteur d'envoi doit utiliser la liste DNS (Domaine Name System) externe spécifiée à l'aide du paramètre ExternalDNSServers de la cmdlet Set-TransportServer. La valeur par défaut est $False. Les valeurs valides pour ce paramètre sont $True et $False.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

 

Exemple

Le premier exemple montre la commande de création d’un connecteur d’envoi qui envoie des messages électroniques via Internet. L'exemple présente les paramètres minimaux requis pour créer un connecteur d'envoi. L’espace d’adressage est limité à l’envoi de messages aux domaines Contoso.com et Microsoft.com.

Le deuxième exemple présente les commandes qui créent un connecteur d'envoi qui adresse des messages électroniques à Contoso.com. Le serveur de messagerie Contoso.com requiert que le serveur Exchange 2007 local s'authentifie pour envoyer des messages électroniques. Pour configurer le connecteur d'envoi afin d'utiliser une authentification, vous devez commencer par exécuter la commande Get-Credential et l'affecter à une variable. Lorsque vous exécutez la commande Get-Credential, celle-ci demande le nom d'utilisateur et le mot de passe du compte utilisé durant l'authentification auprès du serveur de messagerie Contoso.com.

Dans le deuxième exemple, la cmdlet Get-Credential est affectée à la variable $CredentialObject. Une fois les informations d'authentification affectées à la variable $CredentialObject, vous pouvez créer le connecteur d'envoi à l'aide de la cmdlet New-SendConnector. La variable $CredentialObject est transmise au paramètre AuthenticationCredential. Outre la définition des informations d'identification, vous devez définir le paramètre SmartHostAuthMechanism sur BasicAuth afin de donner pour instruction au connecteur d'envoi de s'authentifier auprès du serveur de messagerie Contoso.com en utilisant les informations d'identification fournies.

New-SendConnector -Name Test -AddressSpaces contoso.com,microsoft.com
$CredentialObject = Get-Credential
New-SendConnector -Name "Secure E-Mail to Contoso.com" -AddressSpaces contoso.com -AuthenticationCredential $CredentialObject -SmartHostAuthMechanism BasicAuth