Set-InboundConnector
Cette cmdlet est disponible uniquement dans le service cloud.
Utilisez la cmdlet Set-InboundConnector pour modifier 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
Set-InboundConnector
[-Identity] <InboundConnectorIdParameter>
[-AssociatedAcceptedDomains <MultiValuedProperty>]
[-CloudServicesMailEnabled <Boolean>]
[-Comment <String>]
[-Confirm]
[-ConnectorSource <TenantConnectorSource>]
[-ConnectorType <TenantConnectorType>]
[-EFSkipIPs <MultiValuedProperty>]
[-EFSkipLastIP <Boolean>]
[-EFSkipMailGateway <MultiValuedProperty>]
[-EFTestMode <Boolean>]
[-EFUsers <MultiValuedProperty>]
[-Enabled <Boolean>]
[-Name <String>]
[-RequireTls <Boolean>]
[-RestrictDomainsToCertificate <Boolean>]
[-RestrictDomainsToIPAddresses <Boolean>]
[-ScanAndDropRecipients <MultiValuedProperty>]
[-SenderDomains <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
Set-InboundConnector "Contoso Inbound Connector" -RequireTls $true -TlsSenderCertificateName contoso.comCet exemple apporte les modifications de configuration suivantes au connecteur entrant nommé Contoso.com.
Exigez la transmission TLS pour tous les messages entrants sur le connecteur.
Exigez que le certificat TLS, qui permet de chiffrer les communications, contienne le nom de domaine contoso.com
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 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. 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 |
-Identity
Le paramètre Identity spécifie le connecteur entrant à modifier.
| Type: | InboundConnectorIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| 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: | Named |
| Default value: | None |
| Required: | False |
| 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: | False |
| 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 distantes à partir desquelles ce connecteur accepte les messages. Les adresses IPv6 ne sont pas prises en charge. 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 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 |
-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). Ce paramètre fonctionne uniquement pour le flux de messagerie entre deux organisations Microsoft 365. Aucun autre paramètre n’est donc utilisé.
Pour entrer plusieurs valeurs et remplacer les entrées existantes, utilisez la syntaxe suivante : Value1,Value2,...ValueN. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN".
Pour ajouter ou supprimer une ou plusieurs valeurs sans affecter les entrées existantes, utilisez la syntaxe suivante : @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
| 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.