New-OutboundConnector

 

S’applique à :Exchange Online, Exchange Online Protection

Dernière rubrique modifiée :2017-03-23

Cette cmdlet est disponible uniquement dans le service en nuage.

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 SyntaxeSyntaxe de cmdlet Exchange.

New-OutboundConnector -Name <String> [-AllAcceptedDomains <$true | $false>] [-CloudServicesMailEnabled <$true | $false>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectorSource <Default | Migrated | HybridWizard | AdminUI>] [-ConnectorType <OnPremises | Partner>] [-Enabled <$true | $false>] [-IsTransportRuleScoped <$true | $false>] [-LinkForModifiedConnector <Guid>] [-RecipientDomains <MultiValuedProperty>] [-RouteAllMessagesViaOnPremises <$true | $false>] [-SmartHosts <MultiValuedProperty>] [-TestMode <$true | $false>] [-TlsDomain <SmtpDomainWithSubdomains>] [-TlsSettings <EncryptionOnly | CertificateValidation | DomainValidation>] [-UseMXRecord <$true | $false>] [-WhatIf [<SwitchParameter>]]

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

New-OutboundConnector -Name "Contoso Outbound Connector" -RecipientDomains *.contoso.com -TlsSettings DomainValidation -TlsDomain *.contoso.com

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 tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour voir les autorisations qui vous sont nécessaires, voir Entrée « Connecteurs entrants et sortants » dans la rubrique Autorisations des fonctionnalités dans Exchange Online.

 

Paramètre Obligatoire Type Description

Name

Obligatoire

System.String

Le paramètre Name spécifie un nom descriptif pour le connecteur.

AllAcceptedDomains

Facultatif

System.Boolean

Lorsque ce paramètre est défini sur $true, le connecteur s’applique à tous les domaines acceptés.

CloudServicesMailEnabled

Facultatif

System.Boolean

Remarque :   Nous vous recommandons de n’utiliser ce paramètre qu’en cas d’instructions de la part du Support technique et du Service clientèle Microsoft, ou d’une documentation produit spécifique. À la place, utilisez l’Assistant Configuration hybride pour configurer le flux de messagerie entre vos organisations locale et en nuage. 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 Office 365. Ce paramètre contrôle en particulier la gestion de certains en-têtes de messages X-MS-Exchange-Organization-* internes dans les messages qui sont envoyés entre des domaines acceptés dans les organisations locale et en nuage. Ces en-têtes sont appelés collectivement en-têtes intersites.

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 intersites sont conservés ou promus dans les messages qui transitent via le connecteur. Il s’agit de la valeur par défaut pour les connecteurs qui sont créés par l’Assistant Configuration hybride.

    Conservé pour les messages sortants   Certains en-têtes X-MS-Exchange-Organization-* dans les messages sortants qui transitent d’un côté à l’autre de l’organisation hybride sont convertis en en-têtes X-MS-Exchange-CrossPremises-* et sont ainsi conservés dans les messages.

    Promu pour les messages entrants   Les en-têtes X-MS-Exchange-CrossPremises-* dans les messages entrants qui transitent d’un côté à l’autre de l’organisation hybride 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, de sorte que les en-têtes intersites sont supprimés des messages qui transitent via le connecteur.

Comment

Facultatif

System.String

Le paramètre Comment permet d’insérer un commentaire. Si la valeur que vous saisissez contient des espaces, insérez des guillemets ("). Par exemple : "This is an admin note".

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur Confirm 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 cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets 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.

ConnectorSource

Facultatif

Microsoft.Exchange.Data.TenantConnectorSource

Le paramètre ConnectorSource spécifie la façon dont le connecteur est créé. Les entrées valides pour ce paramètre incluent les valeurs suivantes :

  • Default : le connecteur est créé manuellement.

  • 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.

La valeur par défaut pour les connecteurs créés est Default. Nous vous recommandons de ne pas modifier cette valeur.

ConnectorType

Facultatif

Microsoft.Exchange.Data.TenantConnectorType

Le paramètre ConnectorType spécifie une catégorie pour les domaines gérés par le connecteur. Les entrées valides pour ce paramètre incluent les valeurs suivantes :

  • Partner : le connecteur gère les domaines externes à votre organisation.

  • OnPremises : le connecteur gère les domaines utilisés par votre organisation locale.

Enabled

Facultatif

System.Boolean

Le paramètre Enabled active ou désactive le connecteur. L'entrée valide pour ce paramètre est $true ou $false. La valeur par défaut est $true.

IsTransportRuleScoped

Facultatif

System.Boolean

Le paramètre IsTransportRuleScoped permet d’associer un connecteur sortant à une règle de transport. L'entrée valide pour ce paramètre est $true ou $false.

Une règle de transport est délimitée par un connecteur sortant spécifique avec le paramètre RouteMessageOutboundConnector dans les cmdlets New-TransportRule ou Set-TransportRule. Les messages qui remplissent les conditions associées à la règle de transport sont acheminés vers les destinations appropriées via le connecteur sortant désigné.

LinkForModifiedConnector

Facultatif

System.Guid

VALEUR_PARAMÈTRE : Guid

RecipientDomains

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre RecipientDomains spécifie les noms de domaine auxquels le connecteur sortant achemine les messages. 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. En revanche, vous ne pouvez pas imbriquer un caractère générique, comme le montre l’exemple suivant : domain.*.contoso.com. Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

RouteAllMessagesViaOnPremises

Facultatif

System.Boolean

Le paramètre RouteAllMessagesViaOnPremises indique que tous les messages traités par ce connecteur sont d’abord transférés via le système de messagerie local. L'entrée valide pour ce paramètre est $true ou $false. La valeur par défaut est $false. Si le paramètre RouteAllMessagesViaOnPremises a la valeur $true, vous devez configurer le paramètre ConnectorType avec la valeur OnPremises dans la même commande.

SmartHosts

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre SmartHosts spécifie les hôtes actifs que le connecteur sortant utilisera pour router les messages. Ce paramètre est obligatoire si vous associez le paramètre UseMxRecord à la valeur $false. Vous devez le configurer sur la même ligne de commande. Le paramètre SmartHosts prend un ou plusieurs noms de domaine complet (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. Vous pouvez également utiliser le routage CIDR (Classless InterDomain Routing), par exemple, 192.168.0.1/25. L'identité de l'hôte actif peut être le FQDN du serveur de l'hôte actif, un enregistrement de serveur de messagerie (MX) ou un enregistrement d'adresse (A).

TestMode

Facultatif

System.Boolean

VALEUR_PARAMÈTRE : $true | $false

TlsDomain

Facultatif

Microsoft.Exchange.Data.SmtpDomainWithSubdomains

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. Ce paramètre est uniquement utilisé si le paramètre TlsSettings est défini sur DomainValidation. Une entrée valide pour le paramètre TlsDomain est un domaine SMTP. 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. En revanche, vous ne pouvez pas imbriquer un caractère générique, comme le montre l’exemple suivant : domain.*.contoso.com

TlsSettings

Facultatif

Microsoft.Exchange.Data.TlsAuthLevel

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 crypter le canal de communication. Aucune authentification de certificat n’est effectuée.

  • CertificateValidation   TLS est utilisé pour chiffrer le canal. La validation de la chaîne de certificats et des vérifications des listes de révocation sont effectuées.

  • DomainValidation   Outre le chiffrement du canal et la validation du certificat, le connecteur sortant vérifie que le nom de domaine complet du certificat cible correspond au domaine spécifié dans le paramètre TlsDomain.

UseMXRecord

Facultatif

System.Boolean

Le paramètre UseMXRecord permet d’activer ou de désactiver le routage DNS du connecteur. L'entrée valide pour ce paramètre est $true ou $false. La valeur par défaut est $true. Pour contourner le routage DNS et employer un hôte actif pour définir la destination du connecteur, associez la valeur UseMXRecord à $false et indiquez le nom de domaine complet ou l’adresse IP de l’hôte actif à l’aide du paramètre SmartHosts dans la même commande.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

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.

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.

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.

 
Afficher: