New-OutboundConnector
Cette cmdlet est disponible uniquement dans le service cloud.
Utilisez la cmdlet New-OutboundConnector pour créer un connecteur sortant dans votre organisation en nuage.
Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.
Syntaxe
Default (Par défaut)
New-OutboundConnector
[-Name] <String>
[-AllAcceptedDomains <Boolean>]
[-CloudServicesMailEnabled <Boolean>]
[-Comment <String>]
[-Confirm]
[-ConnectorSource <TenantConnectorSource>]
[-ConnectorType <TenantConnectorType>]
[-Enabled <Boolean>]
[-IsTransportRuleScoped <Boolean>]
[-LinkForModifiedConnector <Guid>]
[-RecipientDomains <MultiValuedProperty>]
[-RouteAllMessagesViaOnPremises <Boolean>]
[-SenderRewritingEnabled <Boolean>]
[-SmartHosts <MultiValuedProperty>]
[-TestMode <Boolean>]
[-TlsDomain <SmtpDomainWithSubdomains>]
[-TlsSettings <TlsAuthLevel>]
[-UseMXRecord <Boolean>]
[-WhatIf]
[<CommonParameters>]
Description
Les connecteurs sortant envoient des message électroniques aux domaines distants qui requièrent des options de configuration spécifiques.
Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cet article répertorie tous les paramètres de l’applet de commande, il se peut que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous sont attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.
Exemples
Exemple 1
New-OutboundConnector -Name "Contoso Outbound Connector" -RecipientDomains *.contoso.com -TlsSettings DomainValidation -TlsDomain *.contoso.com
Cet exemple décrit la création d’un connecteur sortant appelé Contoso et doté des propriétés suivantes :
- Il envoie des messages à des destinataires dans le domaine contoso.com et tous les sous-domaines.
- Il utilise le chiffrement TLS et la vérification de certificats pour contrôler le routage des courriers sur le domaine contoso.com et tous les sous-domaines associés
Paramètres
-AllAcceptedDomains
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre AllAcceptedDomains spécifie si le connecteur sortant est utilisé dans les organisations hybrides où les destinataires des messages se trouvent dans des domaines acceptés de la organization cloud. Les valeurs valides sont les suivantes :
- $true : le connecteur sortant est utilisé dans les organisations hybrides lorsque les destinataires des messages se trouvent dans un domaine accepté du organization cloud. Ce paramètre nécessite OnPremises pour la valeur ConnectorType.
- $false : le connecteur sortant n’est pas utilisé dans les organisations hybrides. Cette valeur est la valeur par défaut.
Ce paramètre est efficace uniquement pour les connecteurs OnPremises.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-CloudServicesMailEnabled
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Remarque : Nous vous recommandons de ne pas utiliser ce paramètre, sauf si vous êtes invité à le faire par le service clientèle et le support technique Microsoft, ou par la documentation du produit spécifique. Utilisez plutôt l’Assistant Configuration hybride pour configurer le flux de messagerie entre vos organisations locales et cloud. Pour plus d'informations, consultez la rubrique Assistant de configuration hybride.
Le paramètre CloudServicesMailEnabled spécifie si le connecteur est utilisé pour le flux de messagerie hybride entre un environnement Exchange local et Microsoft 365. Plus précisément, ce paramètre contrôle la façon dont certains en-têtes de message X-MS-Exchange-Organization-* internes sont gérés dans les messages envoyés entre des domaines acceptés dans les organisations locales et cloud. Ces en-têtes sont collectivement appelés en-têtes intersite.
Les valeurs valides sont les suivantes :
- $true : le connecteur est utilisé pour le flux de messagerie dans les organisations hybrides, de sorte que les en-têtes intersite sont conservés ou promus dans les messages qui transitent par le connecteur. Cette valeur est la valeur par défaut pour les connecteurs créés par l’Assistant Configuration hybride. Certains en-têtes X-MS-Exchange-Organization-* dans les messages sortants envoyés d’un côté du organization hybride à l’autre sont convertis en-têtes X-MS-Exchange-CrossPremises-* et sont ainsi conservés dans les messages. Les en-têtes X-MS-Exchange-CrossPremises-* dans les messages entrants reçus d’un côté de l’organization hybride de l’autre sont promus en en-têtes X-MS-Exchange-Organization-*. Ces en-têtes promus remplacent toutes les instances des mêmes en-têtes X-MS-Exchange-Organization-* qui existent déjà dans les messages.
- $false : le connecteur n’est pas utilisé pour le flux de messagerie dans les organisations hybrides. Par conséquent, tous les en-têtes intersite sont supprimés des messages qui transitent par le connecteur.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Comment
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre Comment permet d’insérer un commentaire facultatif. Si la valeur que vous saisissez contient des espaces, placez-la entre guillemets ("). Par exemple : "Ceci est une note d’administration".
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Confirm
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.
- Les applets de commande destructrices (par exemple, les applets de commande Remove-*) comportent une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte :
-Confirm:$false. - La plupart des autres applets de commande (par exemple, les applets de commande New-* et Set-*) n'ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ConnectorSource
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre ConnectorSource spécifie la façon dont le connecteur est créé. Les valeurs valides sont les suivantes :
- Default : le connecteur est créé manuellement. Cette valeur est la valeur par défaut lorsque vous utilisez cette applet de commande, et nous vous recommandons de ne pas modifier cette valeur.
- HybridWizard : l’Assistant de configuration hybride crée automatiquement le connecteur.
- Migrated : le connecteur a été initialement créé dans Microsoft Forefront Online Protection for Exchange.
Propriétés du paramètre
| Type: | TenantConnectorSource |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ConnectorType
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre ConnectorType spécifie une catégorie pour les domaines gérés par le connecteur. Les valeurs valides sont les suivantes :
- Partner : le connecteur gère les domaines externes à votre organisation.
- OnPremises : le connecteur gère les domaines utilisés par votre organisation locale.
Propriétés du paramètre
| Type: | TenantConnectorType |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Enabled
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre Enabled spécifie s’il faut activer ou désactiver le connecteur sortant. Les valeurs valides sont les suivantes :
- $true : le connecteur est activé. Cette valeur est la valeur par défaut.
- $false : le connecteur est désactivé.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-IsTransportRuleScoped
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre IsTransportRuleScoped spécifie si le connecteur sortant est associé à une règle de transport (également appelée règle de flux de courrier). Les valeurs valides sont les suivantes :
- $true : le connecteur est associé à une règle de transport.
- $false : le connecteur n’est pas associé à une règle de transport. Cette valeur est la valeur par défaut.
Vous pouvez étendre une règle de transport à un connecteur sortant à l’aide du paramètre RouteMessageOutboundConnector sur les applets de commande New-TransportRule ou Set-TransportRule. Les messages qui correspondent aux conditions de la règle de transport sont routés vers leurs destinations à l’aide du connecteur sortant spécifié.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-LinkForModifiedConnector
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Ce paramètre est réservé à l’usage interne chez Microsoft.
Propriétés du paramètre
| Type: | Guid |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre Name spécifie le nom unique du connecteur. La longueur maximale est de 64 caractères. Si la valeur contient des espaces, placez-la entre guillemets (").
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RecipientDomains
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre RecipientDomains spécifie les domaines auxquels le connecteur sortant achemine le courrier. Vous pouvez spécifier plusieurs domaines séparés par des virgules.
Vous pouvez utiliser un caractère générique pour spécifier tous les sous-domaines d’un domaine en particulier comme le montre l’exemple qui suit : *.contoso.com. Toutefois, vous ne pouvez pas incorporer de caractère générique, comme illustré dans l’exemple suivant : domaine.*.contoso.com.
Propriétés du paramètre
| Type: | MultiValuedProperty |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RouteAllMessagesViaOnPremises
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre RouteAllMessagesViaOnPremises spécifie que tous les messages mis en service par ce connecteur sont d’abord routés via le système de messagerie local dans les organisations hybrides. Les valeurs valides sont les suivantes :
- $true : les messages sont routés via le système de messagerie local. Ce paramètre nécessite OnPremises pour la valeur ConnectorType.
- $false : les messages ne sont pas routés via le système de messagerie local. Cette valeur est la valeur par défaut.
Ce paramètre est efficace uniquement pour les connecteurs OnPremises.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SenderRewritingEnabled
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre SenderRewritingEnabled spécifie que tous les messages qui sont normalement éligibles pour la réécriture SRS sont réécrits pour le routage via le système de messagerie local. Les valeurs valides sont les suivantes :
- $true : les messages sont réécrits par SRS en fonction des besoins avant d’être routés via le système de messagerie local. Ce paramètre nécessite OnPremises pour la valeur ConnectorType.
- $false : les messages ne sont pas réécrits par SRS avant d’être routés via le système de messagerie local. Cette valeur est la valeur par défaut.
Ce paramètre est efficace uniquement pour les connecteurs OnPremises.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SmartHosts
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre SmartHosts spécifie l’hôte actif que le connecteur sortant utilise pour acheminer le courrier. Les valeurs valides sont les suivantes :
- Nom de domaine complet d’un serveur hôte intelligent, d’un enregistrement MX (Mail Exchange) ou d’un enregistrement d’adresse (A) : par exemple, mail.contoso.com.
- Adresse IP unique : par exemple, 10.10.1.1.
- Plage d'adresses IP du routage interdomaine sans classe (CIDR) : par exemple, 192.168.0.1/25.
Vous pouvez spécifier plusieurs valeurs séparées par des virgules : "Value1","Value2",..."ValueN".
Ce paramètre est obligatoire si vous utilisez la valeur $false pour le paramètre UseMxRecord.
Propriétés du paramètre
| Type: | MultiValuedProperty |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-TestMode
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre TestMode spécifie si vous souhaitez activer ou désactiver le mode de test pour le connecteur sortant. Les valeurs valides sont les suivantes :
- $true : le mode test est activé.
- $false : le mode test est désactivé. Cette valeur est la valeur par défaut.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-TlsDomain
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre TlsDomain spécifie le nom de domaine que le connecteur sortant utilise pour vérifier le nom de domaine complet du certificat cible lorsqu’une connexion TLS sécurisée est établie. Une valeur valide pour ce paramètre est un domaine SMTP.
Les caractères génériques sont pris en charge pour spécifier tous les sous-domaines d’un domaine (par exemple, *.contoso.com), mais vous ne pouvez pas incorporer le caractère générique dans le domaine (par exemple, domaine.*.contoso.com).
Ce paramètre est significatif uniquement lorsque la valeur TlsSettings est DomainValidation.
Propriétés du paramètre
| Type: | SmtpDomainWithSubdomains |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-TlsSettings
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre TlsSettings définit le niveau d’authentification TLS utilisé pour les connexions TLS sortantes établies par ce connecteur sortant. Les valeurs valides sont les suivantes :
- EncryptionOnly : TLS est utilisé uniquement pour chiffrer le canal de communication. Aucune authentification de certificat n’est effectuée.
- CertificateValidation : TLS est utilisé pour chiffrer le canal et les vérifications de la validation de la chaîne de certificats et des listes de révocation sont effectuées.
- DomainValidation : en plus du chiffrement de canal et de la validation de certificat, le connecteur sortant vérifie également que le nom de domaine complet du certificat cible correspond au domaine spécifié dans le paramètre TlsDomain.
- $null (vide) : cette valeur est la valeur par défaut.
Propriétés du paramètre
| Type: | TlsAuthLevel |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-UseMXRecord
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le paramètre UseMXRecord permet d’activer ou de désactiver le routage DNS du connecteur. Les valeurs valides sont les suivantes :
- $true : le connecteur utilise le routage DNS (enregistrements MX dans DNS) pour remettre les e-mails. Cette valeur est la valeur par défaut.
- $false : le connecteur remet des e-mails à un ou plusieurs hôtes intelligents. Ce paramètre nécessite un ou plusieurs hôtes intelligents pour la valeur SmartHosts.
Propriétés du paramètre
| Type: | Boolean |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Applicable : Exchange Online, module complémentaire de sécurité intégré pour les boîtes aux lettres locales
Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
Input types
Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.
Sorties
Output types
Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.