Set-SendConnector

  • Article

 

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

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

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

Syntaxe

Set-SendConnector -Identity <SendConnectorIdParameter> [-AddressSpaces <MultiValuedProperty>] [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-IsScopedConnector <$true | $false>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-UseExternalDNSServersEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

Set-SendConnector [-AddressSpaces <MultiValuedProperty>] [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-Instance <SmtpSendConnectorConfig>] [-IsScopedConnector <$true | $false>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-UseExternalDNSServersEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La cmdlet Set-SendConnector modifie un connecteur d'envoi existant. Le paramètre Name est obligatoire si vous exécutez la cmdlet Set-SendConnector. Le paramètre Identity n'est obligatoire que si vous modifiez la valeur du paramètre Name.

Une fois cette tâche accomplie, le connecteur d'envoi est modifié.

Pour exécuter la cmdlet Set-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 Set-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

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.SendConnectorIdParameter

Le paramètre Identity spécifie le GUID ou le nom de connecteur représentant le connecteur d'envoi que vous voulez modifier.

AddressSpaces

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre est obligatoire à moins que ce connecteur ne soit lié à un connecteur de réception. Si un connecteur de réception lié est spécifié à l'aide du paramètre LinkedReceiveConnector, la valeur du paramètre AddressSpaces doit être $null. Sinon, le paramètre AddressSpaces spécifie les noms de domaine auxquels le connecteur d'envoi envoie des messages. La syntaxe complète pour la saisie de chaque espace d'adressage est la suivante : <AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • 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 utilisé par défaut.

  • AddressSpace   Pour les types d'espace d'adressage 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'espace d'adressage 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 utilisé par défaut. 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.

Si vous spécifiez 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, les entrées d'espace d'adressage suivantes sont équivalentes :

  • "SMTP:contoso.com;1"

  • "contoso.com;1"

  • "SMTP:contoso.com"

  • contoso.com

Vous pouvez spécifier plusieurs espaces d'adressage en les séparant par des virgules, par exemple, comme suit : contoso.com,fabrikam.com. Si vous spécifiez 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.

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 doubles, par exemple : "this is an admin note".

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.

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 ces paramètres s'étend de 00:00:01 à 1.00:00:00.

DNSRoutingEnabled

Facultatif

System.Boolean

Ce paramètre spécifie si un routage DNS (Domain Name System) doit être utilisé ou si tous les messages doivent être envoyés via l'hôte actif configuré à l'aide du paramètre SmartHosts. La valeur par défaut est $True. Si vous voulez définir la valeur sur $False, vous devez commencer par définir une valeur sur le paramètre SmartHosts.

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

  • La valeur du paramètre DomainSecureEnabled doit être $True.

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

  • La valeur du paramètre IgnoreStartTLS doit être $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 qui sont 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 qui sont définis sur un serveur de transport Edge.

Enabled

Facultatif

System.Boolean

Les entrées 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 entrées 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 de 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
• Get-ExchangeServer

IgnoreSTARTTLS

Facultatif

System.Boolean

Les entrées valides pour ce paramètre sont $True ou $False. 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. Par défaut, un connecteur d’envoi avec la valeur du paramètre DNSRoutingEnabled définie sur $True a également la valeur du paramètre IgnoreStartTLS définie sur $False. Cela signifie que le connecteur d’envoi négociera toujours le TLS si TLS est proposé par le serveur destinataire. Si vous définissez la valeur du paramètre IgnoreStartTLS sur $True, le connecteur d’envoi n'essaie jamais de négocier le TLS avec le serveur destinataire.

Instance

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.SmtpSendConnectorConfig

Ce paramètre 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.

IsScopedConnector

Facultatif

System.Boolean

Ce paramètre contrôle la disponibilité du connecteur pour d'autres serveurs de transport Hub. Si la valeur de ce paramètre est $False, tous les serveurs de transport Hub de l'organisation Exchange peuvent utiliser le connecteur. Si la valeur de ce paramètre est $True, seuls des serveurs de transport Hub se trouvant dans le même site Active Directory peuvent utiliser le connecteur. La valeur par défaut est $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 Set-SendConnector, vous devez également utiliser les paramètres suivants avec les valeurs spécifiées :

  • AddressSpaces $null

  • DNSRoutingEnabled $False

  • MaxMessageSize unlimited

  • Smarthosts <Identité de l'hôte actif>

  • SmarthostAuthMechanism <Mécanisme d'authentification>

MaxMessageSize

Facultatif

Microsoft.Exchange.Data.Unlimited

Ce paramètre spécifie la taille maximale des messages qui peuvent transiter par un connecteur. La valeur par défaut est 10MB. Lorsque vous entrez une valeur, qualifiez-la à 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. Pour supprimer la limite de la taille du message sur un connecteur d’envoi, entrez une valeur unlimited.

Name

Facultatif

System.String

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

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 et désactive l’enregistrement dans le journal de protocole d’un 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. La valeur par défaut est None. L'emplacement des journaux de protocole du connecteur d’envoi de tous les connecteurs d'envoi définis dans les fichiers sur un serveur de transport Hub ou un serveur de transport Edge est spécifié en utilisant le paramètre SendProtocolLogPath de la commande 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 du protocole TLS (Transport Layer Security). 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 ou 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 prend un ou plusieurs noms de domaine complet, tels que server.contoso.com, ou une ou plusieurs adresses IP séparées 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 FQDN du serveur hôte actif, un enregistrement de serveur de messagerie (MX) ou un enregistrement d'adresse (A). Si vous configurez un FQDN comme l’identité de l’hôte actif, le serveur source pour le connecteur d’envoi doit être capable d’utiliser la résolution du 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.

UseExternalDNSServersEnabled

Facultatif

System.Boolean

Ce paramètre spécifie si ce connecteur d'envoi doit utiliser la liste DNS 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.

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

 

 

Exemple

Le premier exemple de code montre une commande Set-SendConnector qui modifie un connecteur d'envoi existant. La commande définit la limite MaxMessageSize sur 10 Mo et le paramètre ConnectionInactivityTimeOut sur 15 minutes.

Le deuxième exemple présente les commandes qui modifient un connecteur d'envoi existant pour utiliser une authentification lorsque le connecteur d'envoi adresse un message électronique à Contoso.com. Le serveur de messagerie Contoso.com requiert que le serveur Exchange Server 2007 local s'authentifie pour soumettre 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 qui sera utilisé durant l'authentification auprès du serveur de messagerie Contoso.com.

Dans l'exemple, la commande Get-Credential est affectée à la variable $CredentialObject. Une fois les informations d'identification pour l'authentification affectées à la variable $CredentialObject, vous pouvez modifier le connecteur d'envoi à l'aide de la cmdlet Set-SendConnector. La variable $CredentialObject est transmise au paramètre AuthenticationCredential. Outre la définition des informations d'identification qui sera utilisée, vous devez définir le paramètre SmartHostAuthMechanism sur BasicAuth pour que le connecteur d'envoi s'authentifie auprès du serveur de messagerie Contoso.com à des informations d'identification fournies.

Set-SendConnector "Contoso.com Send Connector" -MaxMessageSize 10MB -ConnectionInactivityTimeOut 00:15:00 
$CredentialObject = Get-Credential
Set-SendConnector "E-Mail to Contoso.com" -AuthenticationCredential $CredentialObject -SmartHostAuthMechanism BasicAuth