Share via

Set-SendConnector (RTM)

  • Artikel

 

Gilt für: Exchange Server 2007 SP1, Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-08-27

Verwenden Sie das Cmdlet Set-SendConnector, um einen Sendeconnector auf einem Computer zu ändern, auf dem die Serverfunktion Hub-Transport oder Edge-Transport installiert ist.

Syntax

Set-SendConnector -Identity <SendConnectorIdParameter> [-AddressSpaces <MultiValuedProperty>] [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-UseExternalDNSServersEnabled <$true | $false>]

Set-SendConnector [-AddressSpaces <MultiValuedProperty>] [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-Instance <SmtpSendConnectorConfig>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-UseExternalDNSServersEnabled <$true | $false>]

Detaillierte Beschreibung

Das Cmdlet Set-SendConnector ändert einen vorhandenen Sendeconnector. Der Parameter Name ist für die Ausführung des Cmdlets Set-SendConnector erforderlich. Der Parameter Identity ist nur erforderlich, wenn der Wert des Parameters Name geändert wird.

Nachdem diese Aufgabe abgeschlossen ist, ist der Sendeconnector geändert.

Damit Sie das Cmdlet Set-SendConnector ausführen können, muss dem verwendeten Konto die Rolle Exchange-Serveradministrator zugewiesen worden sein, und es muss der lokalen Gruppe Administratoren für den Zielserver angehören.

Um das Cmdlet Set-SendConnector 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.SendConnectorIdParameter

Der Parameter Identity gibt die GUID oder den Connectornamen an, der den zu ändernden Sendeconnector repräsentiert.

AddressSpaces

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Dieser Parameter ist erforderlich, es sei denn, dieser Connector ist mit einem Empfangsconnector verknüpft. Wenn ein verknüpfter Empfangsconnector mithilfe des Parameters LinkedReceiveConnector angegeben wird, muss der Wert von AddressSpaces $null sein. Andernfalls gibt der Parameter AddressSpaces die Domänennamen an, an die der Sendeconnector Nachrichten sendet. Sie können mehrere Adressräume angeben, indem Sie diese durch Komma trennen. Die vollständige Syntax zur Eingabe der einzelnen Adressräume lautet:

<ConnectorScope>:<AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • ConnectorScope   Wenn Sie einen Wert von Local angeben, kann der Connector nur von anderen Hub-Transport-Servern verwendet werden, die am gleichen Active Directory-Standort wie der Hub-Transport-Quellserver vorhanden sind, auf dem das Cmdlet New-SendConnector ausgeführt wird. Wenn Sie den Qualifizierer ConnectorScope auslassen, kann der Connector von allen Hub-Transport-Servern verwendet werden, die in der gesamten Exchange 2007-Organisation vorhanden sind.

  • AddressSpaceType   Im Falle von SMTP-Adressräumen muss dieser Wert "SMTP" lauten. Bei anderen Adressräumen als SMTP kann dieser Wert eine beliebige beschreibende Textzeichenfolge sein, z. B. "Lotus Notes".

  • AddressSpace   Für SMTP-Adressräume kann das DNS-Platzhalterzeichen (Domain Name System) (*), wie in RFC 1035 definiert, verwendet werden. So können Sie beispielsweise "*", "*.com" oder "*.contoso.com" eingeben. Für Nicht-SMTP-Adressräume können Sie Platzhalterzeichen (*) und andere Zeichen verwenden, z. B. "*contoso.com" oder "@contoso".

  • 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 den Qualifizierer AddressSpaceCost bei Eingabe eines Adressraums unter Verwendung der vollständigen Syntax auslassen, werden Connectorkosten mit dem Wert 1 vorausgesetzt.

Sie müssen nur unter den folgenden Bedingungen die vollständige Syntax für den Parameter AddressSpaces verwenden:

  • Connectors mit Gültigkeitsbereich, die über den Qualifizierer Local verfügen

  • Andere Adressräume als SMTP

  • SMTP-Adressräume mit anderen Kosten als 1

Wenn Sie für den Wert des Parameters AddressSpaces einen Domänennamen oder eine durch Kommas getrennte Liste von Domänennamen eingeben, wird für jeden Domänennamen der Adressraumtyp SMTP und für die Kosten der Wert 1 angenommen. Auf Edge-Transport-Servern konfigurierte Sendeconnectors unterstützen nur SMTP-Adressräume. Auf Hub-Transport-Servern konfigurierte Sendeconnectors unterstützen SMTP- und Nicht-SMTP-Adressräume.

AuthenticationCredential

Optional

System.Management.Automation.PSCredential

Dieser Parameter schreibt die Erstellung und Übergabe eines Anmeldeinformationsobjekts vor. Dieses Anmeldeinformationsobjekt wird mithilfe des Cmdlets Get-Credential erstellt. Geben Sie Get-Help Get-Credential in der Exchange-Verwaltungsshell ein, um weitere Informationen über das Cmdlet Get-Credential zu erhalten.

Comment

Optional

System.String

Der Parameter Comment muss in doppelte Anführungszeichen eingeschlossen werden. Beispiel: "this is an admin note".

ConnectionInactivityTimeOut

Optional

Microsoft.Exchange.Data.EnhancedTimeSpan

Dieser Parameter gibt den maximalen Zeitraum an, über den eine Leerlaufverbindung geöffnet bleiben kann. Der Standardwert beträgt 10 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 angibt. Der gültige Eingabebereich für diesen Parameter liegt zwischen 00:00:01 und 1.00:00:00.

DNSRoutingEnabled

Optional

System.Boolean

Dieser Parameter gibt an, ob DNS-Routing (Domain Name System) verwendet werden soll oder ob alle Nachrichten durch den mithilfe des Parameters SmartHosts konfigurierten SmartHost gesendet werden sollen. Der Standardwert ist $True. Wenn Sie den Wert auf $False festlegen möchten, müssen Sie zuerst einen Wert für den Parameter SmartHosts festlegen.

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 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 für den Parameter DomainSecureEnabled muss $True lauten.

  • Der Wert für den Parameter DNSRoutingEnabled muss $True lauten.

  • Der Wert für den Parameter IgnoreStartTLS muss $False lauten.

Das Platzhalterzeichen (*) wird in Domänen, die für MTLS-Authentifizierung konfiguriert sind, nicht unterstützt. Die gleiche Domäne muss auch auf dem entsprechenden Empfangsconnector und im Wert des Parameters TLSReceiveDomainSecureList im Cmdlet Get-TransportConfig definiert sein.

Der Standardwert für DomainSecureEnabled lautet $False für folgende Sendeconnectortypen:

  • Alle auf einem Hub-Transport-Server definierten Sendeconnectors

  • Auf einem Edge-Transport-Server definierte Sendeconnectors, die vom Benutzer erstellt wurden

Der Standardwert für DomainSecureEnabled lautet $True für folgende Sendeconnectortypen:

  • Auf einem Edge-Transport-Server definierte Standardsendeconnectors

Enabled

Optional

System.Boolean

Gültige Eingaben für diesen Parameter sind $True oder $False. Der Standardwert ist $True. Verwenden Sie den Parameter Enabled, um die Fähigkeit zur Verarbeitung von E-Mail-Nachrichten zu aktivieren oder deaktivieren.

Force

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter unterdrückt die Warn- oder Bestätigungsmeldungen, die während bestimmter Konfigurationsänderungen angezeigt werden.

ForceHELO

Optional

System.Boolean

Gültige Eingaben für diesen Parameter sind $True oder $False. Der Standardwert ist $False. Standardmäßig wird EHLO verwendet. Wenn der Parameter auf $True festgelegt ist, wird HELO anstelle von EHLO verwendet.

Fqdn

Optional

Microsoft.Exchange.Data.Fqdn

Dieser Parameter gibt den FQDN an, der als Quellserver für verbundene Messagingserver verwendet wird, die den Sendeconnector für den Empfang von ausgehenden 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

  • Im aktuellsten Received:-Kopfzeilenfeld der Nachricht, das der Nachricht vom Messagingserver des nächsten Hops nach dem Verlassen des Hub-Transport-Servers oder Edge-Transport-Servers hinzugefügt wird

  • Während der TLS-Authentifizierung

Der Standardwert für den Parameter Fqdn ist $Null. Dies bedeutet, dass der tatsächliche FQDN-Standardwert der FQDN des Hub-Transport-Servers oder Edge-Transport-Servers ist, auf dem der Sendeconnector ausgeführt wird.

Hinweis

Wenn der Sendeconnector auf einem Hub-Transport-Server konfiguriert ist, auf dem auch die Serverfunktion Mailbox installiert ist, wird jeder für den Parameter Fqdn angegebene Wert nicht verwendet. Stattdessen wird immer der FQDN des Servers verwendet, der vom Cmdlet Get-ExchangeServer angezeigt wird.
Für Server, auf denen sowohl die Serverfunktion Hub-Transport als auch die Serverfunktion Mailbox installiert ist, besteht die einzige Möglichkeit zum Entfernen des Servernamens aus den Received:-Kopfzeilen der ausgehenden Nachricht in der Verwendung des Cmdlets Remove-ADPermission, um die Ms-Exch-Send-Headers-Routing-Berechtigung aus den Sicherheitsprinzipalen zu entfernen, die den Connector verwenden. Durch diesen Vorgang werden alle Received:-Kopfzeilen beim Verlassen des Hub-Transport-Servers aus der Nachricht entfernt. Es wird empfohlen, die Received:-Kopfzeilen für interne Nachrichten nicht zu entfernen, weil die Received:-Kopfzeilen für die Berechnung des maximalen Hop Counts verwendet werden. Weitere Informationen über das Cmdlet Remove-ADPermission und das Cmdlet Get-ExchangeServer finden Sie unter den folgenden Themen:
• Remove-ADPermission (RTM)
• Get-ExchangeServer (RTM)

IgnoreSTARTTLS

Optional

System.Boolean

Gültige Eingaben für diesen Parameter sind $True oder $False. Dieser Parameter gibt an, ob die StartTLS-Option ignoriert werden soll, die von einem sendenden Remoteserver angeboten wird. Dieser Parameter wird für Remotedomänen verwendet. Dieser Parameter muss auf $False festgelegt werden, wenn der Parameter RequireTLS auf $True festgelegt wird. Standardmäßig wird bei einem Sendeconnector, bei dem der Wert des Parameters DNSRoutingEnabled auf $True festgelegt wurde, auch der Wert für den Parameter IgnoreStartTLS auf $False festgelegt. Dies bedeutet, dass der Sendeconnector immer TLS aushandelt, wenn TLS vom empfangenden Server angeboten wird. Wenn Sie den Wert des Parameters IgnoreStartTLS auf $True festlegen, versucht der Sendeconnector nie, TLS mit dem empfangenden Server auszuhandeln.

Instance

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.SmtpSendConnectorConfig

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 vollständiges Objekt an den Befehl übergeben werden muss.

LinkedReceiveConnector

Optional

Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter

Dieser Parameter erzwingt den Ausgang aller Nachrichten, die vom angegebenen Empfangsconnector empfangen werden, über diesen Sendeconnector. Der Wert von LinkedReceivedConnector kann jeden der folgenden Bezeichner zum Angeben des Empfangsconnectors verwenden:

  • GUID

  • Distinguished Name (DN)

  • Servername\Connectorname

Wenn Sie den Parameter LinkReceiveConnector mit dem Cmdlet Set-SendConnector verwenden, müssen Sie auch die folgenden Parameter mit den angegebenen Werten verwenden:

  • AddressSpaces $null

  • DNSRoutingEnabled $False

  • MaxMessageSize unlimited

  • Smarthosts <SmarthostID>

  • SmarthostAuthMechanism <AuthMechanism>

MaxMessageSize

Optional

Microsoft.Exchange.Data.Unlimited

Dieser Parameter gibt die maximale Größe einer Nachricht an, die über einen Connector übergeben werden kann. Der Standardwert ist 10MB. Wenn Sie einen Wert eingeben, qualifizieren Sie den Wert mit einer der folgenden Einheiten:

  • B (Byte)

  • KB (Kilobyte)

  • MB (Megabyte)

  • GB (Gigabyte)

Nicht qualifizierte Werte werden als "Byte" behandelt. Der gültige Eingabebereich für diesen Parameter liegt zwischen 0 und 2147483647 Byte. Wenn Sie die Nachrichtengrößenbeschränkung für einen Sendeconnector entfernen möchten, geben Sie den Wert unlimited ein.

Name

Optional

System.String

Der Parameter Name ist der vom Administrator bereitgestellte Name des Connectors. Sie müssen den Parameter Name in doppelte Anführungszeichen setzen, falls der Name Leerzeichen wie im folgenden Beispiel enthält: "New Send Connector".

Port

Optional

System.Int32

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

ProtocolLoggingLevel

Optional

Microsoft.Exchange.Data.ProtocolLoggingLevel

Mit diesem Parameter wird die Protokollierung für den angegebenen Sendeconnector aktiviert bzw. deaktiviert. Mit dem Wert Verbose wird die Protokollierung für den Connector aktiviert. Mit dem Wert None wird die Protokollierung für den Connector deaktiviert. Der Standardwert ist None. Der Speicherort der Sendeconnector-Protokollaufzeichnungen für alle Sendeconnectors, die auf einem Hub-Transport- oder einem Edge-Transport-Server konfiguriert werden, wird mit dem Parameter SendProtocolLogPath des Befehls Set-TransportServer angegeben.

RequireTLS

Optional

System.Boolean

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

SmartHostAuthMechanism

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.SmtpSendConnectorConfig+AuthMechanisms

Dieser Parameter wird während der Authentifizierung bei einem Remoteserver verwendet. Dieser Parameter wird nur verwendet, 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.

SmartHosts

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Dieser Parameter akzeptiert einen oder mehrere FQDNs, wie etwa server.contoso.com, oder eine oder mehrere IP-Adressen, jeweils durch Kommas getrennt. Wenn Sie eine IP-Adresse eingeben, müssen Sie die IP-Adresse als Literal eingeben, wie im folgenden Beispiel: 10.10.1.1. Die Smarthostidentität kann der FQDN eines Smarthostservers, ein MX-Datensatz (Mail Exchange) oder ein A-Datensatz (Adressdatensatz) sein. Wenn Sie einen FQDN als Smarthostidentität konfigurieren, muss der Quellserver für den Sendeconnector in der Lage sein, DNS-Namensauflösung zum Ermitteln des Smarthostservers zu verwenden.

SourceIPAddress

Optional

System.Net.IPAddress

Dieser Parameter 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 weist den Server an, eine beliebige lokale IP-Adresse zu verwenden. Dieser Parameter ist nur für Sendeconnectors gültig, die auf Edge-Transport-Servern konfiguriert sind.

SourceTransportServers

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Dieser Parameter gibt die Namen der Hub-Transport-Server an, die diesen Sendeconnector verwenden können. Sie können die Namen mehrerer Hub-Transport-Server angeben, indem Sie die Namen durch Komma trennen. Dieser Parameter ist nicht für Sendeconnectors gültig, die auf Edge-Transport-Servern konfiguriert sind.

UseExternalDNSServersEnabled

Optional

System.Boolean

Dieser Parameter gibt an, ob dieser Sendeconnector die externe DNS-Liste verwenden soll, die mithilfe des Parameters ExternalDNSServers des Cmdlets Set-TransportServer angegeben wird. Der Standardwert ist $False. Gültige Werte für diesen Parameter sind $True und $False.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

 

Beispiel

Das erste Codebeispiel zeigt einen Befehl Set-SendConnector, der einen vorhandenen Sendeconnector ändert. Der Befehl legt den Grenzwert MaxMessageSize auf 10 MB und den Wert für ConnectionTimeOut auf 15 Minuten fest.

Das zweite Beispiel zeigt die Befehle, die einen vorhandenen Sendeconnector so ändern, dass beim Senden einer E-Mail-Nachricht an Contoso.com Authentifizierung verwendet wird. Der E-Mail-Server Contoso.com schreibt vor, dass der lokale Servercomputer mit Exchange Server 2007 sich bei ihm authentifiziert, um E-Mail-Nachrichten zu senden. Um den Sendeconnector für die Verwendung von Authentifizierung zu konfigurieren, müssen Sie zuerst den Befehl Get-Credential ausführen und den Befehl einer Variablen zuweisen. Wenn der Befehl Get-Credential ausgeführt wird, fragt der Befehl nach dem Benutzernamen und dem Kennwort des Kontos, das bei der Authentifizierung beim E-Mail-Server Contoso.com verwendet wird.

Im Beispiel wird der Befehl Get-Credential der Variablen $CredentialObject zugewiesen. Nachdem die Authentifizierungsinformationen der Variablen $CredentialObject zugewiesen wurden, kann der Sendeconnector mithilfe des Cmdlets Set-SendConnector geändert werden. Die Variable $CredentialObject wird dem Parameter AuthenticationCredential übergeben. Über das Festlegen der zu verwendenden Anmeldeinformationen hinaus müssen Sie den Parameter SmartHostAuthMechanism auf BasicAuth festlegen, um den Sendeconnector anzuweisen, sich beim E-Mail-Server Contoso.com mit den angegebenen Anmeldeinformationen zu authentifizieren.

Set-SendConnector "Contoso.com Send Connector" -MaxMessageSize 10MB -ConnectionInactivityTimeOut 00:15:00 
$CredentialObject = Get-Credential
Set-SendConnector "E-Mail to Contoso.com" -AuthenticationCredential $CredentialObject -SmartHostAuthMechanism BasicAuth