Set-SendConnector
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
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>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-IsScopedConnector <$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>] [-WhatIf [<SwitchParameter>]]
Set-SendConnector [-AddressSpaces <MultiValuedProperty>] [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-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>] [-IsScopedConnector <$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>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Das Cmdlet Set-SendConnector ändert einen vorhandenen Sendeconnector. Der Name-Parameter ist für die Ausführung des Cmdlets Set-SendConnector erforderlich. Der Identity-Parameter ist nur erforderlich, wenn der Wert des Name-Parameters 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 Identity-Parameter 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
Die Angabe des Adressraumstyps oder der Adressraumkosten muss in doppelte Anführungszeichen (
Sie können mehrere Adressräume angeben, indem Sie die Adressräume durch Kommas trennen, wie im folgenden Beispiel: Wenn Sie einen anderen Adressraumtyp als SMTP für einen Sendeconnector angeben, der auf einem Hub-Transport-Server konfiguriert ist, sind die folgenden Einstellungen für den Sendeconnector erforderlich:
Hinweis Zwar können andere Adressräume als SMTP auf einem Sendeconnector auf einem Hub-Transport-Server konfiguriert werden, trotzdem verwendet der Sendeconnector SMTP als Transportmechanismus zum Senden von Nachrichten an andere Messagingserver. Fremde Connectors auf Hub-Transport-Servern werden zum Senden von Nachrichten an lokale Messagingserver verwendet, wie etwa an Fax-Gatewayserver von Drittherstellern, die nicht SMTP als primären Transportmechanismus verwenden. Weitere Informationen finden Sie unter Fremde Connectors. |
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 |
Comment |
Optional |
System.String |
Der Parameter Comment muss in doppelte Anführungszeichen eingeschlossen werden. Beispiel: |
Confirm |
Optional |
System.Management.Automation.SwitchParameter |
Der Parameter Confirm bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Parameter Confirm muss kein Wert angegeben werden. |
ConnectionInactivityTimeOut |
Optional |
Microsoft.Exchange.Data.EnhancedTimeSpan |
Dieser Parameter gibt den maximalen Zeitraum an, für 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 ist. 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 |
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 Bestandteil des Verfahrens zum Aktivieren der MTLS-Authentifizierung (Mutual Transport Layer Security, gegenseitige TLS-Authentifizierung) für die von diesem Sendeconnector bedienten Domänen. Die MTLS-Authentifizierung funktioniert nur dann ordnungsgemäß, wenn folgende Bedingungen zutreffen:
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
Der Standardwert für DomainSecureEnabled lautet
|
Enabled |
Optional |
System.Boolean |
Gültige Eingaben für diesen Parameter sind |
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 |
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:
Der Standardwert für den Parameter Fqdn ist Hinweis Wenn der Sendeconnector auf einem Hub-Transport-Server konfiguriert ist, auf dem auch die Serverfunktion Mailbox installiert ist, wird jeder für den Fqdn-Parameter angegebene Wert nicht verwendet. Stattdessen wird immer der FQDN des Servers verwendet, der vom Cmdlet Get-ExchangeServer angezeigt wird. |
IgnoreSTARTTLS |
Optional |
System.Boolean |
Gültige Eingaben für diesen Parameter sind |
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 gesamtes Objekt an den Befehl übergeben werden muss. |
IsScopedConnector |
Optional |
System.Boolean |
Dieser Parameter steuert die Verfügbarkeit des Connectors für andere Hub-Transport-Server-Server. Wenn der Wert dieses Parameters |
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:
Wenn Sie den Parameter LinkReceiveConnector mit dem Cmdlet Set-SendConnector verwenden, müssen Sie auch die folgenden Parameter mit den angegebenen Werten verwenden:
|
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
Nicht qualifizierte Werte werden als "Byte" behandelt. Werte, die in Byte eingegeben werden, werden auf das nächste volle Kilobyte aufgerundet. Beispielsweise wird |
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: |
Port |
Optional |
System.Int32 |
Der gültige Eingabebereich für diesen Parameter ist eine ganze Zahl zwischen |
ProtocolLoggingLevel |
Optional |
Microsoft.Exchange.Data.ProtocolLoggingLevel |
Dieser Parameter aktiviert bzw. deaktiviert die Protokollierung für den angegebenen Sendeconnector. Mit dem Wert |
RequireTLS |
Optional |
System.Boolean |
Dieser Parameter gibt an, ob alle Nachrichten, die durch diesen Connector gesendet werden, mithilfe von TLS (Transport Layer Security) übermittelt werden müssen. Der Standardwert ist |
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 DNSRoutingEnabled-Parameter auf |
SmartHosts |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
Dieser Parameter akzeptiert einen oder mehrere FQDNs, wie etwa |
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 |
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 |
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 Parameters WhatIf können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den Parameter WhatIf muss kein Wert angegeben werden. |
Eingabetypen
Rückgabetypen
Fehler
Fehler | Beschreibung |
---|---|
|
|
Beispiel
Das erste Codebeispiel zeigt einen Set-SendConnector-Befehl, 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 Exchange Server 2007-Server 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 Get-Credential-Befehl 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 $CredentialObject-Variablen 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