Set-ReceiveConnector (RTM)
S’applique à : Exchange Server 2007 SP1, Exchange Server 2007
Dernière rubrique modifiée : 2007-07-23
La cmdlet Set-ReceiveConnector permet de modifier un connecteur de réception existant sur un ordinateur sur lequel le rôle serveur de transport Hub ou Edge est installé.
Syntaxe
Set-ReceiveConnector -Identity <ReceiveConnectorIdParameter> [-AuthMechanism <None | Tls | Integrated | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-Banner <String>] [-BinaryMimeEnabled <$true | $false>] [-Bindings <MultiValuedProperty>] [-ChunkingEnabled <$true | $false>] [-Comment <String>] [-ConnectionInactivityTimeout <EnhancedTimeSpan>] [-ConnectionTimeout <EnhancedTimeSpan>] [-DefaultDomain <AcceptedDomainIdParameter>] [-DeliveryStatusNotificationEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-EightBitMimeEnabled <$true | $false>] [-Enabled <$true | $false>] [-EnhancedStatusCodesEnabled <$true | $false>] [-Fqdn <Fqdn>] [-MaxHeaderSize <ByteQuantifiedSize>] [-MaxHopCount <Int32>] [-MaxInboundConnection <Unlimited>] [-MaxInboundConnectionPercentagePerSource <Int32>] [-MaxInboundConnectionPerSource <Unlimited>] [-MaxLocalHopCount <Int32>] [-MaxLogonFailures <Int32>] [-MaxMessageSize <ByteQuantifiedSize>] [-MaxProtocolErrors <Unlimited>] [-MaxRecipientsPerMessage <Int32>] [-MessageRateLimit <Unlimited>] [-Name <String>] [-PermissionGroups <None | AnonymousUsers | ExchangeUsers | ExchangeServers | ExchangeLegacyServers | Partners | Custom>] [-PipeliningEnabled <$true | $false>] [-ProtocolLoggingLevel <None | Verbose>] [-RemoteIPRanges <MultiValuedProperty>] [-RequireEHLODomain <$true | $false>] [-RequireTLS <$true | $false>] [-SizeEnabled <Disabled | Enabled | EnabledWithoutValue>] [-TarpitInterval <EnhancedTimeSpan>]
Set-ReceiveConnector [-AuthMechanism <None | Tls | Integrated | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-Banner <String>] [-BinaryMimeEnabled <$true | $false>] [-Bindings <MultiValuedProperty>] [-ChunkingEnabled <$true | $false>] [-Comment <String>] [-ConnectionInactivityTimeout <EnhancedTimeSpan>] [-ConnectionTimeout <EnhancedTimeSpan>] [-DefaultDomain <AcceptedDomainIdParameter>] [-DeliveryStatusNotificationEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-EightBitMimeEnabled <$true | $false>] [-Enabled <$true | $false>] [-EnhancedStatusCodesEnabled <$true | $false>] [-Fqdn <Fqdn>] [-Instance <ReceiveConnector>] [-MaxHeaderSize <ByteQuantifiedSize>] [-MaxHopCount <Int32>] [-MaxInboundConnection <Unlimited>] [-MaxInboundConnectionPercentagePerSource <Int32>] [-MaxInboundConnectionPerSource <Unlimited>] [-MaxLocalHopCount <Int32>] [-MaxLogonFailures <Int32>] [-MaxMessageSize <ByteQuantifiedSize>] [-MaxProtocolErrors <Unlimited>] [-MaxRecipientsPerMessage <Int32>] [-MessageRateLimit <Unlimited>] [-Name <String>] [-PermissionGroups <None | AnonymousUsers | ExchangeUsers | ExchangeServers | ExchangeLegacyServers | Partners | Custom>] [-PipeliningEnabled <$true | $false>] [-ProtocolLoggingLevel <None | Verbose>] [-RemoteIPRanges <MultiValuedProperty>] [-RequireEHLODomain <$true | $false>] [-RequireTLS <$true | $false>] [-SizeEnabled <Disabled | Enabled | EnabledWithoutValue>] [-TarpitInterval <EnhancedTimeSpan>]
Description détaillée
La cmdlet Set-ReceiveConnector modifie un connecteur de réception existant. Le paramètre Identity est obligatoire si vous exécutez la cmdlet Set-ReceiveConnector.
Une fois cette tâche accomplie, le connecteur de réception est modifié.
Pour exécuter la cmdlet Set-ReceiveConnector, vous devez utiliser un compte auquel ont été délégués :
- le rôle Administrateur de serveur Exchange et le groupe Administrateurs local pour le serveur cible.
Pour exécuter la cmdlet Set-ReceiveConnector 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 |
---|---|---|---|
Identity |
Obligatoire |
Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter |
Ce paramètre spécifie le GUID ou le nom de connecteur représentant le connecteur de réception. L'intitulé Identity peut être omis. |
AuthMechanism |
Facultatif |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ReceiveConnector+AuthMechanisms |
Ce paramètre spécifie les mécanismes d'authentification publiés et acceptés. Les options d'authentification sont |
Banner |
Facultatif |
System.String |
Ce paramètre remplace la bannière 220 SMTP (Simple Mail Transfer Protocol) par défaut. Quand la valeur du paramètre Banner est vide, la bannière SMTP par défaut est la suivante :
Lorsque vous spécifiez une valeur pour le paramètre Banner, vous devez utiliser la syntaxe suivante :
220 est le code de réponse SMTP « Service ready » par défaut défini dans RFC 2821. |
BinaryMimeEnabled |
Facultatif |
System.Boolean |
Les valeurs valides pour ce paramètre sont |
Liaisons |
Facultatif |
Microsoft.Exchange.Data.MultiValuedProperty |
Ce paramètre spécifie l'adresse IP locale et le numéro de port TCP sur lequel ce connecteur de réception écoute les messages entrants. La syntaxe valide pour ce paramètre est <Adresse IP>:<Port TCP>, telle que 0.0.0.0 .
Les valeurs spécifiées à l'aide du paramètre Bindings doivent satisfaire une des exigences suivantes sur le caractère unique :
|
ChunkingEnabled |
Facultatif |
System.Boolean |
Les valeurs valides pour ce paramètre sont |
Comment |
Facultatif |
System.String |
Le paramètre Comment doit être placé entre guillemets, par exemple : |
ConnectionInactivityTimeout |
Facultatif |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Ce paramètre spécifie le temps d'inactivité maximale qui s'écoule avant qu'une connexion à un connecteur de réception ne soit fermée. La valeur par défaut pour un connecteur de réception configuré sur un serveur de transport Hub est 5 minutes. La valeur par défaut pour un connecteur de réception configuré sur un serveur de transport Edge est 1 minute. 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 valeur spécifiée par le paramètre ConnectionTimeout doit être supérieure à la valeur spécifiée par le paramètre ConnectionInactivityTimeout. La plage d'entrées valide pour ces paramètres s'étend de |
ConnectionTimeOut |
Facultatif |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Ce paramètre spécifie le temps maximal pendant lequel une connexion peut rester ouverte, même si la connexion transmet activement des données. La valeur par défaut pour un connecteur de réception configuré sur un serveur de transport Hub est 10 minutes. La valeur par défaut pour un connecteur de réception configuré sur un serveur de transport Edge est 5 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 valeur spécifiée par le paramètre ConnectionTimeout doit être supérieure à la valeur spécifiée par le paramètre ConnectionInactivityTimeout. La plage d'entrées valide pour ces paramètres s'étend de |
DefaultDomain |
Facultatif |
Microsoft.Exchange.Configuration.Tasks.AcceptedDomainIdParameter |
Ce paramètre spécifie le nom de domaine à ajouter aux valeurs soumises à |
DeliveryStatusNotificationEnabled |
Facultatif |
System.Boolean |
Les valeurs valides pour ce paramètre 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 la première partie du processus d'activation de l'authentification TLS mutuelle pour les domaines desservis par ce connecteur de réception. L'authentification TLS mutuelle ne fonctionne correctement que si les conditions suivantes sont remplies :
La valeur par défaut de DomainSecureEnabled est
La valeur par défaut de DomainSecureEnabled est |
EightBitMimeEnabled |
Facultatif |
System.Boolean |
Les valeurs valides pour ce paramètre sont |
Enabled |
Facultatif |
System.Boolean |
Les valeurs valides pour ce paramètre sont |
EnhancedStatusCodesEnabled |
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 (FQDN) utilisé comme serveur de destination pour des serveurs de messagerie connectés qui utilisent le connecteur de réception pour envoyer des messages entrants. La valeur de ce champ s'affiche pour les serveurs de messagerie connectés chaque fois qu'un nom de serveur de destination est requis, comme dans les exemples suivants :
La valeur par défaut du paramètre Fqdn est le nom de domaine complet du serveur de transport Hub ou du serveur de transport Edge contenant le connecteur de réception. > [!Note] > Ne modifiez pas la valeur FQDN sur le Connecteur de réception par défaut nommé « <Nom de serveur> par défaut » qui est créé automatiquement sur les serveurs de transport Hub. Si votre organisation Exchange dispose de plusieurs serveurs de transport Hub et que vous modifiez la valeur FQDN sur le connecteur de réception « <Nom de serveur> par défaut », le flux de messagerie interne entre les serveurs de transport Hub échouera. |
Instance |
Facultatif |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ReceiveConnector |
Ce paramètre permet de transmettre un objet entier à la commande à traiter. Il est principalement utilisé dans les scripts où un objet entier doit être transmis à la commande. |
MaxHeaderSize |
Facultatif |
Microsoft.Exchange.Data.ByteQuantifiedSize |
Ce paramètre spécifie la taille maximale, en octets, de l'en-tête de message SMTP que le connecteur de réception accepte avant de fermer la connexion. La valeur par défaut est
Les valeurs non qualifiées sont traitées comme des octets. La plage d'entrée valide pour ce paramètre s'étend de |
MaxHopCount |
Facultatif |
System.Int32 |
Ce paramètre spécifie le nombre maximal de sauts qu'un message peut prendre avant d'être rejeté par le connecteur de réception. La valeur par défaut est |
MaxInboundConnection |
Facultatif |
Microsoft.Exchange.Data.Unlimited |
Le paramètre MaxInboundConnection spécifie le nombre maximal de connexions entrantes que ce connecteur de réception dessert simultanément. La valeur par défaut est |
MaxInboundConnectionPercentagePerSource |
Facultatif |
System.Int32 |
Ce paramètre spécifie le nombre maximal de connexions qu'un connecteur de réception dessert simultanément depuis une adresse IP unique. La valeur est exprimée comme pourcentage de connexions restantes disponibles sur un connecteur de réception. Entrez la valeur sous forme d'un nombre entier sans le caractère pour cent (%). La valeur par défaut est 2 pour cent. La plage d'entrées valide pour ce paramètre s'étend de |
MaxInboundConnectionPerSource |
Facultatif |
Microsoft.Exchange.Data.Unlimited |
Ce paramètre spécifie le nombre maximal de connexions entrantes que ce connecteur de réception dessert simultanément depuis une adresse IP unique. La valeur par défaut est |
MaxLocalHopCount |
Facultatif |
System.Int32 |
Ce paramètre spécifie le nombre maximal de sauts qu'un message peut prendre avant d'être rejeté par le connecteur de réception. La valeur par défaut est |
MaxLogonFailures |
Facultatif |
System.Int32 |
Ce paramètre spécifie le nombre d'échecs d'ouverture de session que le connecteur de réception accepte avant de fermer la connexion. La valeur par défaut est |
MaxMessageSize |
Facultatif |
Microsoft.Exchange.Data.ByteQuantifiedSize |
Ce paramètre spécifie la taille maximale d'un message. Le paramètre MaxMessageSize prend une valeur de nombre entier. La valeur par défaut est
Les nombres entiers non qualifiés sont traités comme des octets. La plage d'entrées valide pour ce paramètre s'étend de 1 à 2147483647 octets. |
MaxProtocolErrors |
Facultatif |
Microsoft.Exchange.Data.Unlimited |
Ce paramètre spécifie le nombre maximal d'erreurs de protocole SMTP que le connecteur de réception accepte avant de fermer la connexion. La valeur par défaut est |
MaxRecipientsPerMessage |
Facultatif |
System.Int32 |
Le paramètre MaxRecipientsPerMessage spécifie le nombre maximal de destinataires par message que le connecteur de réception accepte avant de fermer la connexion. La valeur par défaut est |
MessageRateLimit |
Facultatif |
Microsoft.Exchange.Data.Unlimited |
Ce paramètre spécifie le nombre maximal de messages qui peuvent être envoyés par une adresse IP de client unique par minute. La valeur par défaut pour un connecteur de réception configuré sur un serveur de transport Hub est |
Nom |
Facultatif |
System.String |
Le paramètre spécifie le nom du connecteur fourni par l'administrateur. Entrez le paramètre Name sous la forme d'une chaîne comme suit : |
PermissionGroups |
Facultatif |
Microsoft.Exchange.Data.PermissionGroups |
Ce paramètre définit les groupes ou les rôles pouvant soumettre des messages au connecteur de réception et les autorisations attribuées à ces groupes. Un groupe d'autorisations est un ensemble prédéfini d'autorisations octroyées à des entités de sécurité bien connues. Les valeurs valides pour ce paramètre sont les suivantes : |
PipeliningEnabled |
Facultatif |
System.Boolean |
Les valeurs valides pour ce paramètre sont |
ProtocolLoggingLevel |
Facultatif |
Microsoft.Exchange.Data.ProtocolLoggingLevel |
Ce paramètre active ou désactive la journalisation de protocole pour le connecteur de réception spécifié. La valeur |
RemoteIPRanges |
Facultatif |
Microsoft.Exchange.Data.MultiValuedProperty |
Ce paramètre spécifie les adresses IP distantes à partir desquelles ce connecteur accepte des messages. La syntaxe valide pour ce paramètre est <Starting IP Address>:<Ending IP Address>, telle que Plusieurs connecteurs de réception sur le même serveur peuvent avoir des plages d'adresses IP distantes qui se chevauchent tant qu'une plage est complètement chevauchée par une autre adresse IP. Lorsque des plages d'adresses IP distantes se chevauchent, la plage d'adresses IP distante contenant la correspondance la plus proche de l'adresse IP du serveur de connexion est utilisée. |
RequireEHLODomain |
Facultatif |
System.Boolean |
Les valeurs valides pour ce paramètre sont |
RequireTLS |
Facultatif |
System.Boolean |
Les valeurs valides pour ce paramètre sont |
SizeEnabled |
Facultatif |
Microsoft.Exchange.Data.SizeMode |
Les valeurs valides pour ce paramètre sont |
TarpitInterval |
Facultatif |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Le paramètre TarpitInterval spécifie la période de retardement d'une réponse SMTP à un serveur distant dont Exchange détermine qu'il abuse peut être de la connexion. Des connexions authentifiées ne sont jamais retardées de cette manière. La valeur par défaut est 5 secondes. Pour spécifier une valeur, entrez-la sous forme de période : hh:mm:ss, où h = heures, m = minutes et s = secondes. La plage d'entrées valide pour ce paramètre s'étend de |
Types d'entrées
Types de renvois
Erreurs
Erreur | Description |
---|---|
|
|
Exemple
L'exemple suivant de la commande
Set-ReceiveConnector définit le paramètre Banner sur "220 Banner Text here"
et le paramètre ConnectionTimeOut sur 00:15:00
.
Set-ReceiveConnector -Identity "Internet Receive Connector" -Banner "220 Banner Text here" -ConnectionTimeout 00:15:00