Set-ReceiveConnector
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2009-08-19
Verwenden Sie das Cmdlet Set-ReceiveConnector, um einen vorhandenen Empfangsconnector auf einem Computer zu ändern, auf dem die Serverfunktion Hub-Transport oder Edge-Transport installiert ist.
Syntax
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>]]
Detaillierte Beschreibung
Das Cmdlet Set-ReceiveConnector ändert einen vorhandenen Empfangsconnector. Der Parameter Identity ist für die Ausführung des Cmdlets Set-ReceiveConnector erforderlich.
Nachdem diese Aufgabe abgeschlossen ist, ist der Empfangsconnector geändert.
Damit Sie das Cmdlet Set-ReceiveConnector ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- Exchange-Serveradministrator-Rolle und lokale Gruppe Administratoren für den Zielserver
Um das Cmdlet Set-ReceiveConnector auf einem Computer ausführen zu können, auf dem die Serverfunktion Edge-Transport installiert ist, müssen Sie sich mit einem Konto anmelden, das Mitglied der lokalen Gruppe Administratoren auf diesem Computer ist.
Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Microsoft Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Identity |
Erforderlich |
Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter |
Dieser Parameter gibt die GUID oder den Connectornamen an, die bzw. der den Empfangsconnector darstellt. Die Bezeichnung Identity kann ausgelassen werden. |
AuthMechanism |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ReceiveConnector+AuthMechanisms |
Dieser Parameter gibt die angekündigten und akzeptierten Authentifizierungsmechanismen an. Die Authentifizierungsoptionen sind |
Banner |
Optional |
System.String |
Dieser Parameter setzt das SMTP-Standardbanner "200" (Simple Mail Transfer Protocol) außer Kraft. Wenn der Wert des Parameters Banner leer ist, wird folgendes SMTP-Standardbanner verwendet:
Wenn Sie einen Wert für den Parameter Banner angeben, müssen Sie die folgende Syntax verwenden:
Wie in RFC 2821 definiert, lautet der SMTP-Standardantwortcode für "Service ready" (Dienst bereit) 220. |
BinaryMimeEnabled |
Optional |
System.Boolean |
Gültige Werte für diesen Parameter sind |
Bindings |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Dieser Parameter gibt die lokale IP-Adresse und die TCP-Portnummern an, die vom Empfangsconnector für das Abhören auf eingehende Nachrichten verwendet. Die gültige Syntax für diesen Parameter ist <IP-Adresse>:<TCP-Port>, wie etwa Hinweis Sie müssen eine lokale IP-Adresse angeben, die für den Hub-Transport-Server oder Edge-Transport-Server gültig ist, auf dem sich der Empfangsconnector befindet. Wenn Sie eine ungültige lokale IP-Adresse angeben, kann beim Neustart des Microsoft Exchange-Transportdiensts ein Fehler auftreten. Zum Angeben aller IP-Adressen, die auf allen Netzwerkadaptern konfiguriert sind, können Sie die IP-Adresse Die Werte, die Sie mithilfe des Parameters Bindings angeben, müssen einer der folgenden Anforderungen für Eindeutigkeit genügen:
|
ChunkingEnabled |
Optional |
System.Boolean |
Gültige Werte für diesen Parameter sind |
Comment |
Optional |
System.String |
Der Parameter Comment muss wie folgt in doppelte Anführungszeichen eingeschlossen werden. Beispiel: |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Der Confirm-Parameter bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Confirm-Parameter muss kein Wert angegeben werden. |
ConnectionInactivityTimeout |
Optional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Dieser Parameter gibt den maximalen Leerlaufzeitraum an, bevor eine Verbindung mit einem Empfangsconnector beendet wird. Der Standardwert für einen Empfangsconnector, der auf einem Hub-Transport-Server konfiguriert ist, beträgt 5 Minuten. Der Standardwert für einen Empfangsconnector, der auf einem Edge-Transport-Server konfiguriert ist, beträgt 1 Minute. Um einen Wert anzugeben, geben Sie den Wert als Zeitraum ein: TT.hh:MM:SS, wobei T = Tage, h = Stunden, M = Minuten und S = Sekunden ist. Der im Parameter ConnectionTimeout angegebene Wert muss größer als der des Parameters ConnectionInactivityTimeout sein. Der gültige Eingabebereich für beide Parameter liegt zwischen |
ConnectionTimeOut |
Optional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Dieser Parameter gibt den maximalen Zeitraum an, für den eine Verbindung geöffnet bleiben kann, selbst wenn die Verbindung aktiv Daten überträgt. Der Standardwert für einen Empfangsconnector, der auf einem Hub-Transport-Server konfiguriert ist, beträgt 10 Minuten. Der Standardwert für einen Empfangsconnector, der auf einem Edge-Transport-Server konfiguriert ist, beträgt 5 Minuten. Um einen Wert anzugeben, geben Sie den Wert als Zeitraum ein: TT.hh:MM:SS, wobei T = Tage, h = Stunden, M = Minuten und S = Sekunden ist. Der im Parameter ConnectionTimeout angegebene Wert muss größer als der des Parameters ConnectionInactivityTimeout sein. Der gültige Eingabebereich für beide Parameter liegt zwischen |
DefaultDomain |
Optional |
Microsoft.Exchange.Configuration.Tasks.AcceptedDomainIdParameter |
Dieser Parameter gibt den Domänenname an, der Werten angefügt werden soll, die von einem sendenden Server an |
DeliveryStatusNotificationEnabled |
Optional |
System.Boolean |
Gültige Werte für diesen Parameter sind |
DomainController |
Optional |
Microsoft.Exchange.Data.Fqdn |
Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, der diese Konfigurationsänderung in den Active Directory-Verzeichnisdienst schreibt, fügen Sie dem Befehl den Parameter DomainController hinzu. Der Parameter DomainController wird nicht auf Computern unterstützt, auf denen die Serverfunktion Edge-Transport ausgeführt wird. Die Serverfunktion Edge-Transport liest und schreibt nur in der lokalen ADAM-Instanz. |
DomainSecureEnabled |
Optional |
System.Boolean |
Dieser Parameter ist der erste Teil des Vorgangs zum Aktivieren von MTLS-Authentifizierung für Domänen, die von diesem Empfangsconnector bedient werden. Die MTLS-Authentifizierung funktioniert nur dann ordnungsgemäß, wenn folgende Bedingungen zutreffen:
Der Standardwert für DomainSecureEnabled lautet
Der Standardwert für DomainSecureEnabled ist |
EightBitMimeEnabled |
Optional |
System.Boolean |
Gültige Werte für diesen Parameter sind |
EnableAuthGSSAPI |
Optional |
System.Boolean |
Dieser Parameter steuert die Ankündigung der GSSAPI-Authentifizierungsmethode (Generic Security Services Application Programming Interface) wenn die integrierte Windows-Authentifizierung auf diesem Connector aktiviert ist. Wenn der Parameter AuthMechanism Wenn Sie über Microsoft IIS-Messagingserver (Internetinformationsdienste) verfügen, die sich bei diesem Empfangsconnector authentifizieren, sollten Sie den Wert des Parameters EnableAuthGSSAPI auf Der gültige Eingabebereich für diesen Parameter ist |
Enabled |
Optional |
System.Boolean |
Gültige Werte für diesen Parameter sind |
EnhancedStatusCodesEnabled |
Optional |
System.Boolean |
Gültige Werte für diesen Parameter sind |
Fqdn |
Optional |
Microsoft.Exchange.Data.Fqdn |
Dieser Parameter gibt den FQDN an, der als Zielserver für verbundene Messagingserver verwendet wird, die den Empfangsconnector zum Senden von eingehenden Nachrichten verwenden. Der Wert dieses Parameters wird verbundenen Messagingservern angezeigt, wenn der Name eines Zielservers erforderlich ist, wie in den folgenden Beispielen:
Der Standardwert des Fqdn-Parameters ist der FQDN des Hub-Transport-Servers oder Edge-Transport-Servers, auf dem der Empfangsconnector ausgeführt wird. Hinweis Ändern Sie nicht den FQDN-Wert für den standardmäßigen Empfangsconnector mit dem Namen "<Name des Standardservers>", der auf Hub-Transport-Servern automatisch erstellt wird. Wenn Sie in Ihrer Exchange-Organisation mehrere Hub-Transport-Server verwenden und den FQDN-Wert für den Empfangsconnector für "<Name des Standardservers>" ändern, treten bei der internen Nachrichtenübermittlung zwischen den Hub-Transport-Servern Fehler auf. |
Instance |
Optional |
Microsoft.Exchange.Data.Directory.SystemConfiguration.ReceiveConnector |
Dieser Parameter ermöglicht das Übergeben eines vollständigen Objekts an den zu verarbeitenden Befehl. Er wird hauptsächlich in Skripts verwendet, in denen ein gesamtes Objekt an den Befehl übergeben werden muss. |
LongAddressesEnabled |
Optional |
System.Boolean |
Dieser Parameter aktiviert den Empfangsconnector für das Akzeptieren von langen X.400-E-Mail-Adressen. Die X.400-E-Mail-Adressen werden in SMTP-E-Mail-Adressen mithilfe der Kapselungsmethode IMCEA (Internet Mail Connector Encapsulated Address) verkapselt. Wenn der Wert dieses Parameters Wenn der Wert dieses Parameters
Daher können X.400-E-Mail-Adressen nach der IMCEA-Verkapselung bis zu 1860 Zeichen lang sein. Der gültige Eingabebereich für diesen Parameter ist |
MaxHeaderSize |
Optional |
Microsoft.Exchange.Data.ByteQuantifiedSize |
Dieser Parameter gibt die maximale Größe der SMTP-Nachrichtenkopfzeile in Byte an, die vom Empfangsconnector akzeptiert wird, bevor die Verbindung geschlossen wird. Der Standardwert ist
Nicht qualifizierte Werte werden als "Byte" behandelt. Der gültige Eingabebereich für diesen Parameter liegt zwischen |
MaxHopCount |
Optional |
System.Int32 |
Dieser Parameter gibt die Höchstzahl von Hops an, die eine Nachricht ausführen kann, bevor sie vom Empfangsconnector zurückgewiesen wird. Die Höchstzahl von Hops wird von der Anzahl der in einer übermittelten Nachricht enthaltenen |
MaxInboundConnection |
Optional |
Microsoft.Exchange.Data.Unlimited |
Der Parameter MaxInboundConnection gibt die maximale Anzahl eingehender Verbindungen an, die von diesem Empfangsconnector gleichzeitig bedient werden. Der Standardwert ist |
MaxInboundConnectionPercentagePerSource |
Optional |
System.Int32 |
Dieser Parameter gibt die maximale Anzahl von Verbindungen von einer einzigen IP-Adresse aus an, die von einem Empfangsconnector gleichzeitig bedient werden. Der Wert wird als Prozentsatz der verbleibenden verfügbaren Verbindungen auf einem Empfangsconnector ausgedrückt. Geben Sie den Wert als ganze Zahl ohne Prozentzeichen (%) ein. Der Standardwert ist 2 Prozent. Der gültige Eingabebereich für diesen Parameter liegt zwischen |
MaxInboundConnectionPerSource |
Optional |
Microsoft.Exchange.Data.Unlimited |
Dieser Parameter gibt die maximale Anzahl von eingehenden Verbindungen von einer einzigen IP-Adresse aus an, die von diesem Empfangsconnector gleichzeitig bedient werden. Der Standardwert ist |
MaxLocalHopCount |
Optional |
System.Int32 |
Dieser Parameter gibt die Höchstzahl lokaler Hops an, die eine Nachricht ausführen kann, bevor sie vom Empfangsconnector zurückgewiesen wird. Die Höchstzahl von lokalen Hops wird von der Anzahl der in einer übermittelten Nachricht enthaltenen Hinweis Beim Update eines Hub-Transport-Servers oder Edge-Transport-Servers auf Exchange 2007 Service Pack 1 (SP1) beträgt der Wert der Parameters MaxLocalHopCount für alle vorhandenen Empfangsconnectors mit einem Wert für MaxLocalHopCount größer als |
MaxLogonFailures |
Optional |
System.Int32 |
Dieser Parameter gibt die Anzahl der Fehler bei Anmeldewiederholungsversuchen an, die vom Empfangsconnector ausgeführt werden, bevor die Verbindung geschlossen wird. Der Standardwert ist |
MaxMessageSize |
Optional |
Microsoft.Exchange.Data.ByteQuantifiedSize |
Dieser Parameter gibt die maximale Größe einer Nachricht an. Der Standardwert ist
Nicht qualifizierte ganze Zahlen werden als Byte behandelt. Der gültige Eingabebereich für diesen Parameter liegt zwischen 65536 und 2.147.483.647 Byte. |
MaxProtocolErrors |
Optional |
Microsoft.Exchange.Data.Unlimited |
Dieser Parameter gibt die maximale Anzahl von SMTP-Protokollfehlern an, die vom Empfangsconnector akzeptiert werden, bevor die Verbindung getrennt wird. Der Standardwert ist |
MaxRecipientsPerMessage |
Optional |
System.Int32 |
Der Parameter MaxRecipientsPerMessage gibt die maximale Anzahl von Empfängern pro Nachricht an, die vom Empfangsconnector akzeptiert werden, bevor die Verbindung geschlossen wird. Der Standardwert ist |
MessageRateLimit |
Optional |
Microsoft.Exchange.Data.Unlimited |
Dieser Parameter gibt die maximale Anzahl von Nachrichten an, die pro Minute von einer einzelnen Client-IP-Adresse gesendet werden können. Der Standardwert für einen Empfangsconnector, der auf einem Hub-Transport-Server konfiguriert ist, ist |
Name |
Optional |
System.String |
Dieser Parameter gibt den vom Administrator bereitgestellte Namen des Connectors an. Geben Sie den Parameter Name wie im folgenden Beispiel gezeigt als Zeichenfolge ein: |
OrarEnabled |
Optional |
System.Boolean |
Dieser Parameter aktiviert den ORAR (Originator Requested Alternate Recipient). Wenn der Wert dieses Parameters Der gültige Eingabebereich für diesen Parameter ist |
PermissionGroups |
Optional |
Microsoft.Exchange.Data.PermissionGroups |
Dieser Parameter definiert die Gruppen oder Rollen, die Nachrichten an den Empfangsconnector übermitteln können, sowie die Berechtigungen, die diesen Gruppen zugewiesen werden. Eine Berechtigungsgruppe ist eine vordefinierte Sammlung von Berechtigungen, die bekannten Sicherheitsprinzipalen gewährt wird. Gültige Werte für diesen Parameter sind: |
PipeliningEnabled |
Optional |
System.Boolean |
Gültige Werte für diesen Parameter sind |
ProtocolLoggingLevel |
Optional |
Microsoft.Exchange.Data.ProtocolLoggingLevel |
Dieser Parameter aktiviert bzw. deaktiviert die Protokollprotokollierung für den angegebenen Empfangsconnector. Mit dem Wert |
RemoteIPRanges |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Dieser Parameter gibt die IP-Remoteadressen an, von denen dieser Connector Nachrichten akzeptiert. Die gültige Syntax für diesen Parameter ist < IP-Startadresse>-< IP-Endadresse>, wie etwa Mehrere Empfangsconnectors auf dem gleichen Server können überlappende IP-Remoteadressbereiche aufweisen, sofern ein IP-Adressbereich vollständig von einem anderen IP-Adressbereich abgedeckt wird. Wenn die IP-Remoteadressbereiche überlappen, wird der IP-Remoteadressbereich mit der exaktesten Übereinstimmung mit der IP-Adresse des verbindenden Servers verwendet. |
RequireEHLODomain |
Optional |
System.Boolean |
Gültige Werte für diesen Parameter sind |
RequireTLS |
Optional |
System.Boolean |
Gültige Werte für diesen Parameter sind |
SizeEnabled |
Optional |
Microsoft.Exchange.Data.SizeMode |
Gültige Werte für diesen Parameter sind |
TarpitInterval |
Optional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Der Parameter TarpitInterval gibt den Zeitraum an, um den eine SMTP-Antwort an einen Remoteserver zu verzögern ist, von dem Exchange feststellt, dass er möglicherweise die Verbindung missbraucht. Authentifizierte Verbindungen werden nie auf diese Weise verzögert. Die Standardeinstellung ist 5 Sekunden. Um einen Wert anzugeben, geben Sie den Wert als Zeitraum ein: hh:MM:SS, wobei h = Stunden, M = Minuten und S = Sekunden angibt. Der gültige Eingabebereich für diesen Parameter liegt zwischen |
WhatIf |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter WhatIf weist den Befehl an, die für das Objekt ausgeführten Aktionen lediglich zu simulieren. Durch Verwendung des WhatIf-Parameters können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den WhatIf-Parameter muss kein Wert angegeben werden. |
Eingabetypen
Rückgabetypen
Fehler
Fehler | Beschreibung |
---|---|
|
|
Beispiel
Das folgende Beispiel für den Befehl
Set-ReceiveConnector legt den Parameter Banner auf "220 Banner Text here"
und den Parameter ConnectionTimeOut auf 00:15:00
fest.
Set-ReceiveConnector -Identity "Internet Receive Connector" -Banner "220 Banner Text here" -ConnectionTimeout 00:15:00