Set-ReceiveConnector
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2009-08-19
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>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeout <EnhancedTimeSpan>] [-ConnectionTimeout <EnhancedTimeSpan>] [-DefaultDomain <AcceptedDomainIdParameter>] [-DeliveryStatusNotificationEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-EightBitMimeEnabled <$true | $false>] [-EnableAuthGSSAPI <$true | $false>] [-Enabled <$true | $false>] [-EnhancedStatusCodesEnabled <$true | $false>] [-Fqdn <Fqdn>] [-LongAddressesEnabled <$true | $false>] [-MaxHeaderSize <ByteQuantifiedSize>] [-MaxHopCount <Int32>] [-MaxInboundConnection <Unlimited>] [-MaxInboundConnectionPercentagePerSource <Int32>] [-MaxInboundConnectionPerSource <Unlimited>] [-MaxLocalHopCount <Int32>] [-MaxLogonFailures <Int32>] [-MaxMessageSize <ByteQuantifiedSize>] [-MaxProtocolErrors <Unlimited>] [-MaxRecipientsPerMessage <Int32>] [-MessageRateLimit <Unlimited>] [-Name <String>] [-OrarEnabled <$true | $false>] [-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>] [-WhatIf [<SwitchParameter>]]
Set-ReceiveConnector [-AuthMechanism <None | Tls | Integrated | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-Banner <String>] [-BinaryMimeEnabled <$true | $false>] [-Bindings <MultiValuedProperty>] [-ChunkingEnabled <$true | $false>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeout <EnhancedTimeSpan>] [-ConnectionTimeout <EnhancedTimeSpan>] [-DefaultDomain <AcceptedDomainIdParameter>] [-DeliveryStatusNotificationEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-EightBitMimeEnabled <$true | $false>] [-EnableAuthGSSAPI <$true | $false>] [-Enabled <$true | $false>] [-EnhancedStatusCodesEnabled <$true | $false>] [-Fqdn <Fqdn>] [-Instance <ReceiveConnector>] [-LongAddressesEnabled <$true | $false>] [-MaxHeaderSize <ByteQuantifiedSize>] [-MaxHopCount <Int32>] [-MaxInboundConnection <Unlimited>] [-MaxInboundConnectionPercentagePerSource <Int32>] [-MaxInboundConnectionPerSource <Unlimited>] [-MaxLocalHopCount <Int32>] [-MaxLogonFailures <Int32>] [-MaxMessageSize <ByteQuantifiedSize>] [-MaxProtocolErrors <Unlimited>] [-MaxRecipientsPerMessage <Int32>] [-MessageRateLimit <Unlimited>] [-Name <String>] [-OrarEnabled <$true | $false>] [-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>] [-WhatIf [<SwitchParameter>]]
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 |
Bindings |
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 : |
Confirm |
Facultatif |
System.Management.Automation.SwitchParameter |
Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm. |
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 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 vraies :
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 |
EnableAuthGSSAPI |
Facultatif |
System.Boolean |
Ce paramètre contrôle l'annonce de la méthode d'authentification de l'interface GSSAPI (Generic Security Services Application Programming Interface) lorsque l'authentification Windows intégrée est activée sur ce connecteur. Lorsque le paramètre AuthMechanism contient Si vos serveurs de messagerie des Services Internet (IIS) s'authentifient avec ce connecteur de réception, vous devez définir la valeur du paramètre EnableAuthGSSAPI sur La plage d'entrées valides pour ce paramètre est |
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 de nom de domaine complet 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 de nom de domaine complet 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. |
LongAddressesEnabled |
Facultatif |
System.Boolean |
Ce paramètre permet au connecteur de réception d'accepter des adresses de messagerie X.400 longues. Les adresses de messagerie X.400 sont encapsulées dans des adresses de messagerie SMTP à l'aide de la méthode d'encapsulation IMCEA (Internet Mail Connector Encapsulated Address). Lorsque la valeur de ce paramètre est Lorsque la valeur de ce paramètre est
C'est pourquoi les adresses de messagerie X.400 peuvent dépasser 1860 caractères après une encapsulation IMCEA. La plage d'entrées valides pour ce paramètre est |
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. Le nombre maximal de sauts est déterminé par le nombre d'en-tête |
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. Le nombre maximal de sauts locaux est déterminé par le nombre d'en-têtes 8 pour chaque connecteur de réception existant dont la valeur MaxLocalHopCount est supérieure à 1 .
|
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. 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 65536 à 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 |
Name |
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 : |
OrarEnabled |
Facultatif |
System.Boolean |
Ce paramètre active ORAR (Originator Requested Alternate Recipient). Si la valeur de ce paramètre est La plage d'entrées valides pour ce paramètre est |
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 |
WhatIf |
Facultatif |
System.Management.Automation.SwitchParameter |
Le paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n'est pas nécessaire de spécifier une valeur pour le paramètre WhatIf. |
Types d'entrées
Types de retours
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