Partager via


New-InboundConnector

Cette cmdlet est disponible uniquement dans le service cloud.

Utilisez la cmdlet New-InboundConnector pour créer un connecteur entrant 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.

Syntax

New-InboundConnector
   [-Name] <String>
   -SenderDomains <MultiValuedProperty>
   [-AssociatedAcceptedDomains <MultiValuedProperty>]
   [-CloudServicesMailEnabled <Boolean>]
   [-Comment <String>]
   [-Confirm]
   [-ConnectorSource <TenantConnectorSource>]
   [-ConnectorType <TenantConnectorType>]
   [-EFSkipIPs <MultiValuedProperty>]
   [-EFSkipLastIP <Boolean>]
   [-EFSkipMailGateway <MultiValuedProperty>]
   [-EFTestMode <Boolean>]
   [-EFUsers <MultiValuedProperty>]
   [-Enabled <Boolean>]
   [-RequireTls <Boolean>]
   [-RestrictDomainsToCertificate <Boolean>]
   [-RestrictDomainsToIPAddresses <Boolean>]
   [-ScanAndDropRecipients <MultiValuedProperty>]
   [-SenderIPAddresses <MultiValuedProperty>]
   [-TlsSenderCertificateName <TlsCertificate>]
   [-TreatMessagesAsInternal <Boolean>]
   [-TrustedOrganizations <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Description

Les connecteurs entrants acceptent les messages électroniques provenant de domaines distants qui exigent des options de configuration spécifiques.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, 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 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-InboundConnector -Name "Contoso Inbound Connector" -SenderDomains *.contoso.com -SenderIPAddresses 192.168.0.1/25 -RestrictDomainsToIPAddresses $true

Cet exemple décrit la création d’un connecteur entrant appelé Contoso et doté des propriétés suivantes :

  • Il écoute les connexions entrantes dans le domaine contoso.com et tous les sous-domaines.
  • Il n’accepte que les courriers émanant de contoso.com et dans la plage d’adresses IP 192.168.0.1/25. Il refuse les courriers de contoso.com s’ils ont une autre adresse IP.

Exemple 2

New-InboundConnector -Name "Contoso Inbound Secure Connector" -SenderDomains *.contoso.com -SenderIPAddresses 192.168.0.1/25 -RestrictDomainsToIPAddresses $true -RequireTLS $true -TlsSenderCertificateName *.contoso.com

Cet exemple décrit la création d’un connecteur entrant appelé Contoso Inbound Secure Connector. Il requiert une transmission TLS pour tous les messages.

Paramètres

-AssociatedAcceptedDomains

Le paramètre AssociatedAcceptedDomains limite les domaines sources qui utilisent le connecteur aux domaines acceptés spécifiés. Une valeur valide est un domaine SMTP configuré en tant que domaine accepté dans votre organization Microsoft 365.

Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-CloudServicesMailEnabled

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. Il s’agit de 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.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Comment

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Confirm

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-*) ont 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.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-ConnectorSource

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. Il s’agit de la valeur par défaut.
  • 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.

Nous vous recommandons de ne pas modifier cette valeur.

Type:TenantConnectorSource
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-ConnectorType

Le paramètre ConnectorType spécifie la catégorie pour les domaines sources pour lesquelles le connecteur accepte les messages. Les valeurs valides sont les suivantes :

  • Partenaire : partenaires ou services externes.
  • OnPremises : votre messagerie locale organization. Utilisez cette valeur pour les domaines acceptés dans votre organisation en nuage, également spécifiés par le paramètre SenderDomains.
Type:TenantConnectorType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EFSkipIPs

Le paramètre EFSkipIPs spécifie les adresses IP sources à ignorer dans Filtrage amélioré pour les connecteurs lorsque la valeur du paramètre EFSkipLastIP est $false. Les valeurs valides sont les suivantes :

  • Adresse IP unique : par exemple, 192.168.1.1.
  • Plage d’adresses IP : par exemple, 192.168.0.1-192.168.0.254.
  • Plage d’adresses IP CIDR (Classless InterDomain Routing) : par exemple, 192.168.3.1/24.

Vous pouvez spécifier plusieurs valeurs séparées par des virgules.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EFSkipLastIP

Le paramètre EFSkipIPs spécifie le comportement du filtrage amélioré pour les connecteurs. Les valeurs valides sont les suivantes :

  • $true : seule la source du dernier message est ignorée.
  • $false : ignorez les adresses IP sources spécifiées par le paramètre EFSkipIPs. Si aucune adresse IP n’est spécifiée, le filtrage amélioré pour les connecteurs est désactivé sur le connecteur. Il s’agit de la valeur par défaut.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EFSkipMailGateway

Ce paramètre est réservé à l’usage interne chez Microsoft.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EFTestMode

Ce paramètre est réservé à l’usage interne chez Microsoft.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-EFUsers

Le paramètre EFUsers spécifie les destinataires auxquels le filtrage amélioré pour les connecteurs s’applique. La valeur par défaut est vide ($null), ce qui signifie que le filtrage amélioré pour les connecteurs est appliqué à tous les destinataires.

Vous pouvez spécifier plusieurs adresses électroniques de destinataires séparées par des virgules.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Enabled

Le paramètre Enabled active ou désactive le connecteur. Les valeurs valides sont les suivantes :

  • $true : le connecteur est activé. Il s’agit de la valeur par défaut.
  • $false : le connecteur est désactivé.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-Name

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-RequireTls

Le paramètre RequireTLS spécifie s’il faut exiger la transmission TLS pour tous les messages reçus par le connecteur. Les valeurs valides sont les suivantes :

  • $true : rejeter les messages s’ils ne sont pas envoyés via TLS. Il s'agit de la valeur par défaut.
  • $false : autorisez les messages s’ils ne sont pas envoyés via TLS.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-RestrictDomainsToCertificate

Le paramètre RestrictDomainsToCertificate spécifie si la valeur Subject du certificat TLS est vérifiée avant que les messages puissent utiliser le connecteur. Les valeurs valides sont les suivantes :

  • $true : le courrier n’est autorisé à utiliser le connecteur que si la valeur Subject du certificat TLS utilisé par le serveur de messagerie source pour l’authentification correspond à la valeur du paramètre TlsSenderCertificateName.
  • $false : la valeur Objet du certificat TLS que le serveur de messagerie source utilise pour l’authentification ne contrôle pas si les messages provenant de cette source utilisent le connecteur. Il s’agit de la valeur par défaut.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-RestrictDomainsToIPAddresses

Le paramètre RestrictDomainsToIPAddresses spécifie s’il faut rejeter les messages provenant d’adresses IP sources inconnues. Les valeurs valides sont les suivantes :

  • $true : rejeter automatiquement les messages provenant des domaines spécifiés par le paramètre SenderDomains si l’adresse IP source n’est pas également spécifiée par le paramètre SenderIPAddress.
  • $false : ne rejetez pas automatiquement les messages provenant de domaines spécifiés par le paramètre SenderDomains en fonction de l’adresse IP source. Il s’agit de la valeur par défaut.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-ScanAndDropRecipients

Ce paramètre est réservé à l’usage interne chez Microsoft.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-SenderDomains

Le paramètre SenderDomains spécifie les domaines sources pour lequel le connecteur accepte les messages. Une valeur valide est un domaine SMTP. Les caractères génériques sont pris en charge pour indiquer un domaine et tous les sous-domaines (par exemple, *.contoso.com), mais vous ne pouvez pas incorporer le caractère générique (par exemple, domaine.*.contoso.com n’est pas valide).

Vous pouvez spécifier plusieurs domaines séparés par des virgules.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-SenderIPAddresses

Le paramètre SenderIPAddresses spécifie les adresses IP IPV4 sources dont le connecteur accepte les messages. Les valeurs valides sont les suivantes :

  • Adresse IP unique : par exemple, 192.168.1.1.
  • Plage d’adresses IP CIDR (Classless InterDomain Routing) : par exemple, 192.168.0.1/25. Les valeurs de masque de sous-réseau valides sont de /24 à /32.

Vous pouvez spécifier plusieurs adresses IP séparées par des virgules.

Les adresses IPv6 ne sont pas prises en charge.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-TlsSenderCertificateName

Le paramètre TlsSenderCertificateName spécifie le certificat TLS utilisé lorsque la valeur du paramètre RequireTls est $true. Une valeur valide est un domaine SMTP. Les caractères génériques sont pris en charge pour indiquer un domaine et tous les sous-domaines (par exemple, *.contoso.com), mais vous ne pouvez pas incorporer le caractère générique (par exemple, domaine.*.contoso.com n’est pas valide).

Type:TlsCertificate
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-TreatMessagesAsInternal

Le paramètre TreatMessagesAsInternal spécifie une autre méthode pour identifier les messages envoyés à partir d’un organization local en tant que messages internes. Vous devez envisager d’utiliser ce paramètre uniquement lorsque votre organization local n’utilise pas Exchange. Les valeurs valides sont les suivantes :

  • $true : les messages sont considérés comme internes si le domaine de l’expéditeur correspond à un domaine configuré dans Microsoft 365. Ce paramètre autorise le flux de messagerie interne entre Microsoft 365 et les organisations locales qui n’ont pas installé Exchange Server 2010 ou version ultérieure. Toutefois, ce paramètre présente des risques potentiels pour la sécurité (par exemple, les messages internes contournent le filtrage anti-courrier indésirable). Par conséquent, soyez prudent lors de la configuration de ce paramètre.
  • $false : les messages ne sont pas considérés comme internes. Il s’agit de la valeur par défaut.

Dans les environnements hybrides, vous n’avez pas besoin d’utiliser ce paramètre, car l’Assistant Configuration hybride configure automatiquement les paramètres requis sur le connecteur entrant dans Microsoft 365 et le connecteur d’envoi dans le organization Exchange local (paramètre CloudServicesMailEnabled).

Remarque : Vous ne pouvez pas définir ce paramètre sur la valeur $true si l’une des conditions suivantes est remplie :

  • Le paramètre CloudServicesMailEnabled est défini sur la valeur $true.
  • La valeur du paramètre ConnectorType n’est pas OnPremises.
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-TrustedOrganizations

Le paramètre TrustedOrganizations spécifie d’autres organisations Microsoft 365 qui sont des sources de messagerie approuvées (par exemple, après acquisitions et fusions). Vous pouvez spécifier plusieurs organisations Microsoft 365 séparées par des virgules.

Ce paramètre fonctionne uniquement pour le flux de messagerie entre deux organisations Microsoft 365. Aucun autre paramètre n’est donc utilisé.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-WhatIf

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.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

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.