New-SendConnector
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2007-09-05
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 serveur de transport Edge est installé.
Syntaxe
New-SendConnector -Name <String> -AddressSpaces <MultiValuedProperty> [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-Custom <SwitchParameter>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-Internal <SwitchParameter>] [-Internet <SwitchParameter>] [-IsScopedConnector <$true | $false>] [-MaxMessageSize <Unlimited>] [-Partner <SwitchParameter>] [-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>] [-WhatIf [<SwitchParameter>]]
New-SendConnector -Name <String> [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-Custom <SwitchParameter>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-Internal <SwitchParameter>] [-Internet <SwitchParameter>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Partner <SwitchParameter>] [-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>] [-WhatIf [<SwitchParameter>]]
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. Si un connecteur de réception lié est spécifié à l'aide du paramètre LinkedReceiveConnector, la valeur du paramètre AddressSpaces doit être
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 (
Vous pouvez spécifier plusieurs espaces d'adressage en les séparant par des virgules, par exemple, comme suit : 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 :
|
||
Name |
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 : |
||
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 |
||
Comment |
Facultatif |
System.String |
Le paramètre Comment doit être placé entre guillemets, par exemple : |
||
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 valide pour ce paramètre s'étend de |
||
Custom |
Facultatif |
System.Management.Automation.SwitchParameter |
Ce paramètre spécifie le type d'utilisation
Pour plus d'informations sur les types d'utilisation, les autorisations et les méthodes d'authentification du connecteur de réception, consultez la rubrique Connecteurs d'envoi. |
||
DNSRoutingEnabled |
Facultatif |
System.Boolean |
Les valeurs valides pour le paramètre DnsRoutingEnabled sont |
||
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 :
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
La valeur par défaut du paramètre DomainSecureEnabled est
|
||
Enabled |
Facultatif |
System.Boolean |
Les valeurs valides pour ce paramètre sont |
||
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 |
||
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 :
La valeur par défaut du paramètre Fqdn est
|
||
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 |
||
Internal |
Facultatif |
System.Management.Automation.SwitchParameter |
Ce paramètre spécifie le type d'utilisation
Pour plus d'informations sur les types d'utilisation, les autorisations et les méthodes d'authentification du connecteur de réception, consultez la rubrique Connecteurs d'envoi. |
||
Internet |
Facultatif |
System.Management.Automation.SwitchParameter |
Ce paramètre spécifie le type d'utilisation
Pour plus d'informations sur les types d'utilisation, les autorisations et les méthodes d'authentification du connecteur de réception, consultez la rubrique Connecteurs d'envoi. |
||
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 |
||
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 :
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 :
Lorsque vous utilisez le paramètre LinkedReceiveConnector, vous ne devez pas utiliser le paramètre AddressSpace. |
||
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
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, |
||
Partner |
Facultatif |
System.Management.Automation.SwitchParameter |
Ce paramètre spécifie le type d'utilisation
Pour plus d'informations sur les types d'utilisation, les autorisations et les méthodes d'authentification du connecteur de réception, consultez la rubrique Connecteurs d'envoi. |
||
Port |
Facultatif |
System.Int32 |
Ce paramètre est un nombre entier compris entre |
||
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 |
||
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 |
||
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 |
||
SmartHosts |
Facultatif |
Microsoft.Exchange.Data.MultiValuedProperty |
Ce paramètre est requis si vous voulez définir le paramètre DnsRoutingEnabled sur |
||
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 |
||
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 peut être utilisé pour spécifier les autorisations et les méthodes d'authentification par défaut affectées au connecteur d'envoi. Les valeurs valides pour ce paramètre sont les suivantes : Si vous utilisez le paramètre Usage, vous ne pouvez utiliser aucun des paramètres suivants :
Pour plus d'informations sur les types d'utilisation, les autorisations et les méthodes d'authentification du connecteur de réception, 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 |
||
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 montre la commande de création d’un connecteur d’envoi qui distribue 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