New-SendConnector
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2007-09-05
Verwenden Sie das Cmdlet New-SendConnector, um einen neuen Sendeconnector auf einem Computer zu erstellen, auf dem die Serverfunktion Hub-Transport oder Edge-Transport installiert ist.
Syntax
New-SendConnector -Name <String> -AddressSpaces <MultiValuedProperty> [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-Custom <SwitchParameter>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-Internal <SwitchParameter>] [-Internet <SwitchParameter>] [-IsScopedConnector <$true | $false>] [-MaxMessageSize <Unlimited>] [-Partner <SwitchParameter>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-TemplateInstance <PSObject>] [-Usage <Custom | Internal | Internet | Partner>] [-UseExternalDNSServersEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]
New-SendConnector -Name <String> [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-Custom <SwitchParameter>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-Internal <SwitchParameter>] [-Internet <SwitchParameter>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Partner <SwitchParameter>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-TemplateInstance <PSObject>] [-Usage <Custom | Internal | Internet | Partner>] [-UseExternalDNSServersEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Mit diesem Cmdlet wird ein neuer Sendeconnector erstellt. Damit die erforderlichen Parameter für einen neuen Sendeconnector abgefragt werden, geben Sie New-SendConnector ein. Nachdem diese Aufgabe abgeschlossen ist, wird ein Sendeconnector erstellt.
Damit Sie das Cmdlet New-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 New-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 |
---|---|---|---|
AddressSpaces |
Erforderlich |
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 des Parameters 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. |
Name |
Erforderlich |
System.String |
Dieser Parameter 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: |
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 wie im folgenden Beispiel in doppelte Anführungszeichen eingeschlossen werden: |
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 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 dT = Tage, h = Stunden, M = Minuten und sS = Sekunden ist. Der gültige Eingabebereich für diesen Parameter liegt zwischen |
Custom |
Optional |
System.Management.Automation.SwitchParameter |
Dieser Parameter gibt den
Weitere Informationen zu Sendeconnector-Verwendungstypen, Berechtigungen und Authentifizierungsmethoden finden Sie unter Sendeconnectors. |
DNSRoutingEnabled |
Optional |
System.Boolean |
Gültige Werte für den Parameter DnsRoutingEnabled 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 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:
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 Werte 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 Werte 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 |
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 |
Internal |
Optional |
System.Management.Automation.SwitchParameter |
Dieser Parameter gibt den
Weitere Informationen zu Sendeconnector-Verwendungstypen, Berechtigungen und Authentifizierungsmethoden finden Sie unter Sendeconnectors. |
Internet |
Optional |
System.Management.Automation.SwitchParameter |
Dieser Parameter gibt den
Weitere Informationen zu Sendeconnector-Verwendungstypen, Berechtigungen und Authentifizierungsmethoden finden Sie unter Sendeconnectors. |
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 New-SendConnector verwenden, müssen Sie auch die folgenden Parameter mit den angegebenen Werten verwenden:
Wenn Sie den Parameter LinkedReceiveConnector verwenden, dürfen Sie nicht den Parameter AddressSpace 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 |
Partner |
Optional |
System.Management.Automation.SwitchParameter |
Dieser Parameter gibt den
Weitere Informationen zu Sendeconnector-Verwendungstypen, Berechtigungen und Authentifizierungsmethoden finden Sie unter Sendeconnectors. |
Port |
Optional |
System.Int32 |
Der gültige Eingabebereich für diesen Parameter ist eine Ganzzahl zwischen |
ProtocolLoggingLevel |
Optional |
Microsoft.Exchange.Data.ProtocolLoggingLevel |
Mit diesem Parameter wird die Protokollierung für den angegebenen Sendeconnector aktiviert bzw. deaktiviert. Mit dem Wert |
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 |
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 ist erforderlich, wenn Sie den Parameter DnsRoutingEnabled auf |
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. |
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.NewSendConnector+UsageType |
Mit diesem Parameter können Sie die Standardberechtigungsgruppen und Authentifizierungsmethoden angeben, die dem Sendeconnector zugewiesen sind. Gültige Werte für diesen Parameter sind: Wenn Sie den Parameter Usage verwenden, können Sie keinen der folgenden Parameter verwenden:
Weitere Informationen zu Sendeconnector-Verwendungstypen, Berechtigungen und Authentifizierungsmethoden finden Sie unter Sendeconnectors. |
UseExternalDNSServersEnabled |
Optional |
System.Boolean |
Dieser Parameter gibt an, ob dieser Sendeconnector die externe DNS-Liste (Domain Name System) verwenden soll, die mithilfe des Parameters ExternalDNSServers im Cmdlet 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 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 erste Beispiel zeigt den Befehl, mit dem ein neuer Sendeconnector zum Senden von E-Mail-Nachrichten über das Internet erstellt wird. Das Beispiel zeigt die Parameter, die mindestens zum Erstellen eines Sendeconnectors erforderlich sind. Der Adressraum ist so eingeschränkt, dass Nachrichten nur an die Domäne Contoso.com und die Domäne Microsoft.com gesendet werden.
Das zweite Beispiel zeigt die Befehle, mit denen ein neuer Sendeconnector zum Senden von E-Mail-Nachrichten an Contoso.com erstellt wird. Für den E-Mail-Server Contoso.com ist es erforderlich, dass sich der lokale Exchange 2007-Server authentifiziert, um E-Mail-Nachrichten übermitteln zu können. Um den Sendeconnector für die Verwendung einer Authentifizierung zu konfigurieren, müssen Sie zuerst den Befehl Get-Credential ausführen und diesen einer Variablen zuweisen. Wenn der Get-Credential-Befehl ausgeführt wird, fragt er nach dem Benutzernamen und dem Kennwort des Kontos, das bei der Authentifizierung beim E-Mail-Server Contoso.com verwendet wird.
Im zweiten Beispiel wird das Cmdlet Get-Credential der Variablen $CredentialObject zugewiesen. Nachdem die Authentifizierungsinformationen der $CredentialObject-Variablen zugewiesen wurden, kann der neue Sendeconnector mithilfe des Cmdlets Set-SendConnector erstellt werden. Die Variable $CredentialObject wird dem Parameter AuthenticationCredential übergeben. Über das Festlegen der Anmeldeinformationen hinaus müssen Sie den SmartHostAuthMechanism-Parameter auf BasicAuth
festlegen, um den Sendeconnector anzuweisen, sich beim E-Mail-Server Contoso.com mit den angegebenen Anmeldeinformationen zu authentifizieren.
New-SendConnector -Name Test -AddressSpaces contoso.com,microsoft.com
$CredentialObject = Get-Credential
New-SendConnector -Name "Secure E-Mail to Contoso.com" -AddressSpaces contoso.com -AuthenticationCredential $CredentialObject -SmartHostAuthMechanism BasicAuth