New-ReceiveConnector (RTM)
Gilt für: Exchange Server 2007 SP1, Exchange Server 2007
Letztes Änderungsdatum des Themas: 2007-07-23
Verwenden Sie das Cmdlet New-ReceiveConnector, um einen neuen Empfangsconnector auf einem Computer zu erstellen, auf dem die Serverfunktion Hub-Transport oder Edge-Transport installiert ist.
Syntax
New-ReceiveConnector -Name <String> [-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>] [-PermissionGroups <None | AnonymousUsers | ExchangeUsers | ExchangeServers | ExchangeLegacyServers | Partners | Custom>] [-PipeliningEnabled <$true | $false>] [-ProtocolLoggingLevel <None | Verbose>] [-RemoteIPRanges <MultiValuedProperty>] [-RequireEHLODomain <$true | $false>] [-RequireTLS <$true | $false>] [-Server <ServerIdParameter>] [-SizeEnabled <Disabled | Enabled | EnabledWithoutValue>] [-TarpitInterval <EnhancedTimeSpan>] [-TemplateInstance <PSObject>] [-Usage <Custom | Internet | Internal | Client | Partner>]
Detaillierte Beschreibung
Das Cmdlet New-ReceiveConnector erstellt einen neuen Empfangsconnector. Damit die erforderlichen Parameter für einen Empfangsconnector abgefragt werden, geben Sie New-ReceiveConnector ein. Die erforderlichen Parameter für einen neuen Empfangsconnector sind Name, Bindings und RemoteIPRanges.
Nachdem diese Aufgabe abgeschlossen ist, wird ein Empfangsconnector erstellt.
Damit Sie das Cmdlet New-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 New-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 Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
Parameter | Erforderlich | Typ | Beschreibung |
---|---|---|---|
Name |
Erforderlich |
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: " |
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:
Sie müssen einen Wert für den Parameter Bindings angeben, wenn die folgenden Werte für den Parameter Usage angegeben werden:
|
ChunkingEnabled |
Optional |
System.Boolean |
Gültige Eingaben für diesen Parameter sind |
Comment |
Optional |
System.String |
Der Parameter Comment muss wie folgt in doppelte Anführungszeichen eingeschlossen werden. Beispiel: |
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 dT = Tage, h = Stunden, M = Minuten und sS = 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 Daten aktiv übertragen werden. 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 dT = Tage, h = Stunden, M = Minuten und sS = 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 |
Aktiviert |
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. |
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. Der Standardwert ist Hinweis Die Höchstzahl von Hops wird von der Anzahl der in einer übermittelten Nachricht vorhandenen |
MaxInboundConnection |
Optional |
Microsoft.Exchange.Data.Unlimited |
Dieser Parameter 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 Höchstzahl 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 |
MaxInboundConnectionPerSource |
Optional |
Microsoft.Exchange.Data.Unlimited |
Dieser Parameter gibt die maximale Anzahl von 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. Der Standardwert ist Hinweis Die Höchstzahl von lokalen Hops wird von der Anzahl der in einer übermittelten Nachricht enthaltenen "Received:" -Kopfzeilen mit lokalen Serveradressen bestimmt. |
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 Werte werden als "Byte" behandelt. Der gültige Eingabebereich für diesen Parameter liegt zwischen 1 und 2147483647 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 |
Dieser Parameter gibt die maximale Anzahl von Empfängern pro Nachricht an, die vom Empfangsconnector akzeptiert werden, bevor die Verbindung getrennt 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 |
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 Sie müssen einen Wert für den Parameter RemoteIPRanges angeben, wenn die folgenden Werte für den Parameter Usage angegeben werden:
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 |
Server |
Optional |
Microsoft.Exchange.Configuration.Tasks.ServerIdParameter |
Dieser Parameter gibt den Server an, auf dem der neue Empfangsconnector erstellt werden soll. |
SizeEnabled |
Optional |
Microsoft.Exchange.Data.SizeMode |
Gültige Werte für diesen Parameter sind |
TarpitInterval |
Optional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Dieser Parameter 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: TT.hh:MM:SS, wobei dT = Tage, h = Stunden, M = Minuten und sS = Sekunden ist. Der gültige Eingabebereich für diesen Parameter liegt zwischen |
TemplateInstance |
Optional |
System.Management.Automation.PSObject |
Wenn ein vorhandenes Objekt an diesen Parameter übergeben wird, verwendet der Befehl die Konfiguration des Objekts zum Erstellen einer identischen Kopie des Objekts auf einem lokalen oder Zielserver. |
Usage |
Optional |
Microsoft.Exchange.Management.SystemConfigurationTasks.NewReceiveConnector+UsageType |
Dieser Parameter gibt die Standardberechtigungsgruppen und Authentifizierungsmethoden an, die diesem Empfangsconnector zugewiesen sind. Folgende Werte sind für den Parameter Usage gültig: Für den Parameter Bindings ist ein Wert erforderlich, wenn Sie einen der folgenden Werte für den Parameter Usage angeben:
Für den Parameter RemoteIPRanges ist ein Wert erforderlich, wenn Sie einen der folgenden Werte für den Parameter Usage angeben:
Wenn Sie keinen Wert für einen erforderlichen Parameter angeben, wird der Befehl nicht erfolgreich ausgeführt. Das Cmdlet New-ReceiveConnector fordert Sie nicht zur Eingabe der fehlenden erforderlichen Parameter auf. Weitere Informationen zu Empfangsconnector-Verwendungstypen, Berechtigungsgruppen und Authentifizierungsmethoden finden Sie unter Empfangsconnectors. |
Eingabetypen
Rückgabetypen
Fehler
Fehler | Beschreibung |
---|---|
|
|
Beispiel
Der Befehl New-ReceiveConnector erstellt einen neuen Empfangsconnector. Das Beispiel zeigt die Parameter, die mindestens zum Erstellen eines Empfangsconnectors erforderlich sind.
Hinweis
Sie können keine mehreren Empfangsconnectors erstellen, die für die Parameter Bindings und RemoteIPRanges identische Werte verwenden.
New-ReceiveConnector -Name Test -Bindings 10.10.1.1:25 -RemoteIPRanges 192.168.0.1-192.168.0.24