Set-SendConnector

Mit dem Parameter AddressSpaces werden die Domänennamen angegeben, an die der Sendeconnector E-Mail weiterleitet. Die vollständige Syntax für die Eingabe der einzelnen Adressräume lautet: AddressSpaceType:AddressSpace;AddressSpaceCost.

• AddressSpaceType: Auf einem Edgeserver muss SMTP als Adressraumtyp verwendet werden. Im Transportdienst auf einem Postfachserver kann der Adressraumtyp SMTP, X400 oder eine beliebige andere Textzeichenfolge sein. Wenn Sie den Adressraumtyp nicht angeben, wird SMTP angenommen.
• AddressSpace: Für SMTP-Adressraumtypen muss der angegebene Adressraum RFC 1035-konform sein. Beispielsweise sind *, *.com und *.contoso.com erlaubt, *contoso.com ist jedoch nicht zulässig. Für X.400-Adressraumtypen muss der eingegebene Adressraum RFC 1685-konform sein, wie etwa o=MySite;p=MyOrg;a=adatum;c=us. Bei allen anderen Werten für den Adressraumtyp kann ein beliebiger Text für den Adressraum eingegeben werden.
• AddressSpaceCost: Der gültige Eingabebereich für die Kosten beträgt 1 bis 100. Ein niedrigerer Kostenwert zeigt eine bessere Route an. Dieser Parameter ist optional. Wenn Sie die Adressraumkosten fortlassen, werden Kosten von 1 angenommen. Wenn Sie einen anderen Adressraum als SMTP angeben, der das Semikolon (;) als Zeichen enthält, müssen Sie die Adressraumkosten angeben.

Die Angabe des Adressraumtyps oder der Adressraumkosten muss in Anführungszeichen (") gesetzt werden. Beispielsweise sind die folgenden Adressraumeinträge gleichbedeutend:

• "SMTP:contoso.com;1"
• "contoso.com;1"
• "SMTP:contoso.com"
• contoso.com

Sie können mehrere Adressräume angeben, indem Sie die Adressräume durch Kommas trennen, z. B. contoso.com,fabrikam.com. Wenn Sie den Adressraumtyp oder die Adressraumkosten angeben, schließen Sie den Adressraum in Anführungszeichen (") ein, z. B. "contoso.com;2","fabrikam.com;3".

Wenn Sie einen anderen Adressraumtyp als SMTP auf einem Sendeconnector angeben, der im Transportdienst auf einem Postfachserver konfiguriert ist, sind folgende Parameter erforderlich:

• Der Parameter SmartHosts muss auf einen Wert festgelegt werden, der einen Smarthost angibt.
• Der Parameter DNSRoutingEnabled muss auf $false gesetzt werden.

Auch wenn andere Adressräume als SMTP auf einem Sendeconnector im Transportdienst auf einem Postfachserver konfiguriert werden können, verwendet der Sendeconnector dennoch SMTP als Transportmechanismus zum Senden von Nachrichten an andere Messagingserver. Fremde Connectors im Transportdienst auf einem Postfachserver werden zum Senden von Nachrichten an lokale Messagingserver verwendet, wie etwa an Fax-Gatewayserver von Drittanbietern, die nicht SMTP als primären Transportmechanismus verwenden. Weitere Informationen finden Sie unter Fremde Connectors.

Der Parameter AuthenticationCredential gibt den Benutzernamen und das Kennwort an, die für die Verwendung des Connectors erforderlich sind.

Ein Wert für diesen Parameter setzt das Cmdlet "Get-Credential" voraus. Verwenden Sie den Wert (Get-Credential), um diesen Befehl anzuhalten und eine Aufforderung zur Eingabe von Anmeldeinformationen zu erhalten. Oder speichern Sie die Anmeldeinformationen in einer Variablen (beispielsweise $cred = Get-Credential), bevor Sie diesen Befehl ausführen, und verwenden Sie dann den Variablennamen ($cred) für diesen Parameter. Weitere Informationen finden Sie unter Get-Credential.

Hinweis: Es wird empfohlen, diesen Parameter nicht zu verwenden, es sei denn, Sie werden von Microsoft Kundendienst und Support oder einer bestimmten Produktdokumentation dazu aufgefordert. Verwenden Sie stattdessen den Assistenten für die Hybridkonfiguration, um den E-Mail-Fluss zwischen Ihren lokalen und Cloudorganisationen zu konfigurieren. Weitere Informationen finden Sie unter Assistent für die Hybridkonfiguration.

Der Parameter CloudServicesMailEnabled gibt an, ob der Connector für den hybriden E-Mail-Fluss zwischen einer lokalen Exchange-Umgebung und Microsoft 365 verwendet wird. Dieser Parameter steuert insbesondere, wie bestimmte interne X-MS-Exchange-Organization-*-Nachrichtenheader in Nachrichten behandelt werden, die zwischen akzeptierten Domänen in der lokalen und cloudbasierten Organisation gesendet werden. Diese Header werden zusammen als standortübergreifende Header bezeichnet.

Gültige Werte sind:

• $true: Der Connector wird für den Nachrichtenfluss in Hybridorganisationen verwendet, sodass standortübergreifende Header in Nachrichten, die über den Connector fließen, beibehalten oder heraufgestuft werden. Dies ist der Standardwert für Connectors, die vom Assistenten für die Hybridkonfiguration erstellt werden. Bestimmte X-MS-Exchange-Organization-*-Header in ausgehenden Nachrichten, die von einer Seite der Hybridorganisation an die andere gesendet werden, werden in X-MS-Exchange-CrossPremises-*-Header konvertiert und dadurch in Nachrichten beibehalten. X-MS-Exchange-CrossPremises-*-Header in eingehenden Nachrichten, die auf einer Seite der Hybridorganisation von der anderen empfangen werden, werden zu X-MS-Exchange-Organization-*-Headern heraufgestuft. Diese höher gestuften Header ersetzen alle Instanzen der gleichen X-MS-Exchange-Organization-*-Header, die bereits in Nachrichten vorhanden sind.
• $false: Der Connector wird in Hybridorganisationen nicht für den Nachrichtenfluss verwendet, sodass alle standortübergreifenden Header aus Nachrichten entfernt werden, die den Connector durchlaufen.

Der ParameterComment gibt einen optionalen Kommentar an. Sie müssen den Comment-Parameter in Anführungszeichen (") einschließen, z. B. "Dies ist eine Administratornotiz".

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.

• Destruktive Cmdlets (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
• Die meisten anderen Cmdlets (z. B. New-* und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.

Der Parameter ConnectionInactivityTimeOut gibt den maximalen Zeitraum an, für den eine Leerlaufverbindung geöffnet bleiben kann. Der Standardwert beträgt zehn Minuten.

Um einen Wert anzugeben, geben Sie ihn als Zeitspanne ein: dd.hh:mm:ss, wobei dd = Tage, hh = Stunden, mm = Minuten und ss = Sekunden.

Legen Sie den Parameter beispielsweise auf 00:15:00 fest, um fünfzehn Minuten anzugeben. Der gültige Eingabebereich für diesen Parameter liegt zwischen 00:00:01 und 1.00:00:00.

Der ConnectorType-Parameter gibt an, ob der Connector in Hybridbereitstellungen verwendet wird, um Nachrichten an Microsoft 365 zu senden. Gültige Werte sind:

• Standard: Der Connector wird nicht zum Senden von Nachrichten an Microsoft 365 verwendet. Dies ist der Standardwert.
• XPremises: Der Connector wird verwendet, um Nachrichten an Microsoft 365 zu senden.

Der Parameter DNSRoutingEnabled gibt an, ob der Sendeconnector zum Weiterleiten von E-Mail DNS (Domain Name System) verwendet. Gültige Werte für diesen Parameter sind $true oder $false. Der Standardwert ist $true. Wenn Sie einen SmartHosts-Parameter angeben, muss der DNSRoutingEnabled-Parameter $false lauten.

Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: dc01.contoso.com.

Der DomainController-Parameter wird auf Edge-Transport-Servern nicht unterstützt. Edge-Transport-Server verwenden die lokale Instanz von Active Directory Lightweight Directory Services (AD LDS), um Daten zu lesen und zu schreiben.

Der Parameter DomainSecureEnabled ist Teil des Prozesses zur Aktivierung der MTLS-Authentifizierung (Mutual Transport Layer Security) für die Domänen, die von diesem Sendeconnector bedient werden. Die MTLS-Authentifizierung funktioniert nur dann ordnungsgemäß, wenn folgende Bedingungen zutreffen:

• Der Wert des Parameters DomainSecureEnabled muss $true lauten.
• Der Wert des Parameters DNSRoutingEnabled muss $true lauten.
• Der Wert des Parameters IgnoreStartTLS muss $false lauten.

Das Platzhalterzeichen (*) wird in Domänen, die für MTLS-Authentifizierung konfiguriert sind, nicht unterstützt. Dieselbe Domäne muss auch für den entsprechenden Empfangsconnector und im Attribut TLSReceiveDomainSecureList der Transportkonfiguration definiert sein.

Der Standardwert für den Parameter DomainSecureEnabled lautet $false für folgende Sendeconnectortypen:

• Alle Sendeconnectors, die im Transportdienst auf einem Postfachserver definiert sind.
• Vom Benutzer erstellte Sendeconnectors, die auf einem Edgeserver definiert wurden.

Der Standardwert für den Parameter DomainSecureEnabled ist $true für Standardsendeconnectors, die auf einem Edgeserver definiert sind.

Der Parameter Enabled gibt an, ob die Verarbeitung von E-Mails für den Sendeconnector aktiviert wird. Gültige Werte sind $true oder $false. Der Standardwert ist $true.

Der Parameter ErrorPolicies gibt an, wie Kommunikationsfehler behandelt werden. Folgende Werte sind möglich:

• Standard: Für Kommunikationsfehler wird ein Nichtzustellbarkeitsbericht (Non-Delivery Report, NDR) generiert.
• DowngradeDnsFailures: Alle DNS-Fehler werden als vorübergehend behandelt.
• DowngradeCustomFailures: Bestimmte SMTP-Fehler werden als vorübergehend behandelt.
• UpgradeCustomFailures Benutzerdefinierte vorübergehende Fehler werden aktualisiert und als dauerhafte Fehler behandelt.

Für diesen Parameter können mehrere Werte angegeben werden, die durch Kommata getrennt werden müssen.

Geben Sie für diesen Parameter nur dann einen anderen Wert als Default an, wenn dieser Sendeconnector zum Senden von Nachrichten über einen zuverlässigen und ordnungsgemäß definierten Kommunikationskanal verwendet wird, für den keine Kommunikationsfehler erwartet werden. Ziehen Sie z. B. die Angabe eines anderen Werts als Default in Betracht, wenn dieser Sendeconnector zum Senden von Nachrichten an einen Partner verwendet wird.

Der Schalter „Erzwingen“ blendet Warnungs- oder Bestätigungsmeldungen aus. Sie müssen keinen Wert für diese Option angeben.

Sie können diesen Switch verwenden, um Aufgaben in Fällen programmgesteuert auszuführen, in denen die administrative Eingabe unangemessen ist.

Mit dem Parameter ForceHELO wird angegeben, ob HELO anstelle des standardmäßigen EHLO gesendet wird. Gültige Werte sind $true oder $false. Der Standardwert ist $false.

Der Parameter Fqdn gibt den vollqualifizierten Domänennamen (FQDN) an, der als Quellserver für verbundene Messagingserver verwendet wird, die den Sendeconnector für den Empfang ausgehender Nachrichten verwenden. Der Wert dieses Parameters wird verbundenen Messagingservern angezeigt, wenn der Name eines Quellservers erforderlich ist, wie in den folgenden Beispielen:

• Im EHLO/HELO-Befehl, wenn der Sendeconnector mit dem Messagingserver auf dem nächsten Hop kommuniziert
• In dem Received-Kopfzeilenfeld, das der Nachricht zuletzt vom Messagingserver im nächsten Hop hinzugefügt wird, nachdem die Nachricht den Transportdienst auf einem Postfachserver oder einem Edgeserver verlässt
• Während der TLS-Authentifizierung

Der Parameter Fqdn hat den Standardwert $null. Dies bedeutet, dass der FQDN-Standardwert dem FQDN des Postfachservers oder Edgeservers entspricht, auf dem der Sendeconnector ausgeführt wird.

Ist der Parameter FrontendProxyEnabled auf $true gesetzt, werden ausgehende Nachrichten über den CAS-Server weitergeleitet, auf dem zielgerichtetes Routing wie DNS oder eine IP-Adresse festgelegt ist.

Die GUID oder der Connectorname an, die bzw. der für den zu ändernden Sendeconnector steht.

Der Parameter IgnoreSTARTTLS gibt an, ob die Option "StartTLS" ignoriert werden soll, die von einem sendenden Remoteserver angeboten wird. Dieser Parameter wird für Remotedomänen verwendet. Dieser Parameter muss auf $false gesetzt werden, wenn der Parameter RequireTLS auf $true festgelegt ist. Gültige Werte für diesen Parameter sind $true oder $false.

Dieser Parameter ist nur in Exchange Server 2010 verfügbar.

Der Parameter IsCoexistenceConnector gibt an, ob dieser Sendeconnector für einen sicheren E-Mail-Fluss zwischen Ihrer lokalen Bereitstellung und Ihrer Microsoft 365-Organisation verwendet wird. Der Standardwert ist $false.

Der Parameter IsScopedConnector gibt die Verfügbarkeit des Connectors für andere Postfachserver mit dem Transportdienst an. Wenn der Wert dieses Parameters $false ist, kann der Connector von allen Postfachservern in der Exchange-Organisation verwendet werden. Wenn der Wert dieses Parameters $true ist, kann der Connector nur vom Transportdienst auf Postfachservern am gleichen Active Directory-Standort verwendet werden. Der Standardwert ist $false.

Dieser Parameter ist nur in Exchange Server 2010 verfügbar.

Der Parameter LinkedReceiveConnector erzwingt, dass alle Nachrichten, die vom angegebenen Empfangsconnector empfangen werden, über diesen Sendeconnector ausgegeben werden. Der Wert des Parameters LinkedReceiveConnector kann einen der folgenden Bezeichner verwenden, um den Empfangsconnector anzugeben:

• GUID
• Distinguished Name (DN)
• Servername\ConnectorName

Wenn Sie den LinkedReceiveConnector-Parameter mit diesem Befehl verwenden, müssen Sie auch die folgenden Parameter mit den angegebenen Werten verwenden:

• AddressSpaces $null
• DNSRoutingEnabled $false
• MaxMessageSize unlimited
• Smarthosts <SmarthostID>
• SmarthostAuthMechanism <AuthMechanism>

Der Parameter MaxMessageSize gibt die maximale Größe einer Nachricht an, die über einen Connector übergeben werden kann. The default value is 25 MB.

Wenn Sie einen Wert eingeben, qualifizieren Sie den Wert mit einer der folgenden Einheiten:

• B (Bytes)
• KB (Kilobytes)
• MB (Megabytes)
• GB (Gigabytes)
• TB (Terabytes)

Nicht qualifizierte Werte werden in der Regel als Byte behandelt, kleine Werte werden jedoch auf das nächsthöhere Kilobyte aufgerundet.

Der gültige Eingabebereich für diesen Parameter liegt zwischen 0 und 2.147.483.647 Byte. Wenn Sie die Nachrichtengrößenbeschränkung für einen Sendeconnector entfernen möchten, geben Sie den Wert unlimited ein.

Der Parameter Name gibt den vom Administrator angegebenen Namen des Connectors an. Wenn der Name Leerzeichen enthält, müssen Sie den Parameter Name in Anführungszeichen (") setzen. Beispiel: "New Send Connector".

Der Parameter Port gibt die Portnummer an, die für die Smarthost-Weiterleitung verwendet wird, wenn Sie einen Wert im Parameter SmartHosts festlegen. Der gültige Eingabebereich ist eine Ganzzahl zwischen 0 und 65535. Der Standardwert ist 25. In den meisten Organisationen ist die Portnummer auf 25 festgelegt.

Der Parameter ProtocolLoggingLevel gibt an, ob die Protokollierung aktiviert wird. Durch Verbose wird die Protokollierung aktiviert. Durch None wird die Protokollierung deaktiviert. Der Speicherort der Protokolle für alle Sendeconnectors, die im Transportdienst auf einem Postfachserver oder einem Edgeserver konfiguriert sind, wird mithilfe des Parameters SendProtocolLogPath des Cmdlets Set-TransportService angegeben.

Dieser Parameter ist für die interne Verwendung durch Microsoft reserviert.

Der Parameter RequireTLS gibt an, ob alle Nachrichten, die über diesen Connector gesendet werden, mithilfe von TLS übermittelt werden müssen. Der Standardwert ist $false.

Der Parameter SmartHostAuthMechanism gibt den Smarthost-Authentifizierungsmechanismus an, der zur Authentifizierung bei einem Remoteserver verwendet werden soll. Verwenden Sie diesen Parameter nur, wenn ein Smarthost konfiguriert wird und der Parameter DNSRoutingEnabled auf $false festgelegt ist. Gültige Werte sind None, BasicAuth, BasicAuthRequireTLS, ExchangeServer und ExternalAuthoritative. Alle Werte schließen sich gegenseitig aus. Wenn Sie BasicAuth oder BasicAuthRequireTLS wählen, müssen Sie den Parameter AuthenticationCredential verwenden, um die Anmeldeinformationen für die Authentifizierung anzugeben.

Der SmartHosts-Parameter gibt die Smarthosts an, die der Sendeconnector zum Weiterleiten von E-Mails verwendet. Dieser Parameter ist erforderlich, wenn Sie den DnsRoutingEnabled-Parameter auf $false festlegen und in derselben Befehlszeile angegeben werden muss. Der SmartHosts-Parameter akzeptiert einen oder mehrere FQDNs, z. B. server.contoso.com, eine oder mehrere IP-Adressen oder eine Kombination aus FQDNs und IP-Adressen. Wenn Sie eine IP-Adresse eingeben, müssen Sie die IP-Adresse als Literal eingeben. Beispiel: 10.10.1.1. Die Smarthostidentität kann der FQDN eines Smarthostservers, ein MX-Eintrag (Mail Exchanger) oder ein Adressdatensatz (A) sein. Wenn Sie einen FQDN als Smarthostidentität konfigurieren, muss der Quellserver für den Sendeconnector die DNS-Namensauflösung verwenden können, um den Smarthostserver zu suchen.

Verwenden Sie die folgende Syntax, um mehrere Werte einzugeben und vorhandene Einträge zu überschreiben: Value1,Value2,...ValueN. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".

Verwenden Sie die folgende Syntax, um einen oder mehrere Werte ohne Auswirkungen auf vorhandene Einträge hinzuzufügen oder zu entfernen: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Der Parameter SmtpMaxMessagesPerConnection gibt die maximale Anzahl von Nachrichten an, die der Server pro Verbindung senden kann.

Der Parameter SourceIPAddress gibt die lokale IP-Adresse an, die als Endpunkt für eine SMTP-Verbindung mit einem Remotemessagingserver verwendet wird. Die IP-Standardadresse lautet 0.0.0.0. Dieser Wert bedeutet, dass der Server eine beliebige lokale IP-Adresse verwenden kann. Dieser Parameter gilt nur für Sendeconnectors, die auf einem Edgeserver konfiguriert sind.

Mit dem Parameter SourceTransportServers werden die Namen von Postfachservern angegeben, die diesen Sendeconnector nutzen können. Dieser Parameter gibt nicht für Sendeconnectors, die auf einem Edgeserver konfiguriert sind.

Verwenden Sie die folgende Syntax, um mehrere Werte einzugeben und vorhandene Einträge zu überschreiben: Value1,Value2,...ValueN. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".

Verwenden Sie die folgende Syntax, um einen oder mehrere Werte ohne Auswirkungen auf vorhandene Einträge hinzuzufügen oder zu entfernen: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Der Parameter TlsAuthLevel gibt die TLS-Authentifizierungsebene für ausgehende TLS-Verbindungen an, die von diesem Sendeconnector hergestellt werden. Gültige Werte sind:

• EncryptionOnly: TLS wird lediglich zum Verschlüsseln des Kommunikationskanals verwendet. Es wird keine Zertifikatsauthentifizierung durchgeführt.
• CertificateValidation: TLS wird verwendet, um den Kanal zu verschlüsseln, und überprüfungen der Zertifikatkette und Sperrlisten werden ausgeführt.
• DomainValidation: Zusätzlich zur Kanalverschlüsselung und Zertifikatüberprüfung prüft der Sendeconnector, ob der FQDN des Zielzertifikats mit der im Parameter TlsDomain angegebenen Domäne übereinstimmt. Wenn im Parameter TlsDomain keine Domäne angegeben ist, wird der FQDN auf dem Zertifikat mit der Domäne des Empfängers verglichen.

Für diesen Parameter kann kein Wert angegeben werden, wenn der Parameter IgnoreSTARTTLS auf $true bzw. der Parameter RequireTLS auf $false gesetzt ist.

Der TlsCertificateName-Parameter gibt das X.509-Zertifikat an, das für die für TLS-Verschlüsselung verwendet werden soll. Ein gültiger Wert für diesen Parameter ist "<I>X.500Issuer<S>X.500Subject". Der Wert X.500Issuer befindet sich im Feld Issuer des Zertifikats, und der Wert X.500Subject befindet sich im Feld Subject des Zertifikats. Sie können diese Werte finden, indem Sie das Get-ExchangeCertificate-Cmdlet ausführen. Wenn Sie Get-ExchangeCertificate ausgeführt haben, um den Fingerabdruckwert des Zertifikats zu ermitteln, führen Sie den Befehl $TLSCert = Get-ExchangeCertificate -Thumbprint <Thumbprint>aus, führen Sie den Befehl $TLSCertName = "<I>$($TLSCert.Issuer)<S>$($TLSCert.Subject)"aus, und verwenden Sie dann den Wert $TLSCertName für diesen Parameter.

Der Parameter TlsDomain gibt den Domänennamen an, anhand dessen der Sendeconnector den FQDN des Zielzertifikats beim Herstellen einer über TLS gesicherten Verbindung überprüft.

Dieser Parameter wird nur verwendet, wenn der Parameter TlsAuthLevel auf DomainValidation gesetzt ist.

In den folgenden Fällen muss für diesen Parameter ein Wert angegeben werden:

• Der Parameter TLSAuthLevel ist auf DomainValidation gesetzt.
• Der Parameter DNSRoutingEnabled ist auf $false gesetzt (Smarthost-Sendeconnector).

Der Parameter UseExternalDNSServersEnabled gibt an, ob dieser Sendeconnector die externe DNS-Liste verwenden soll, die über den Parameter ExternalDNSServers des Cmdlets Set-TransportService angegeben wird. Der Standardwert ist $false.

Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.