New-ForeignConnector

  • Artikel

 

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

Letztes Änderungsdatum des Themas: 2008-11-13

Sie verwenden das Cmdlet New-ForeignConnector zum Erstellen eines neuen fremden Connectors auf einen Computer, auf dem Microsoft Exchange Server 2007 ausgeführt wird und auf dem die Serverfunktion Hub-Transport installiert ist. Ein fremder Connector verwendet ein Dropverzeichnis auf einem Hub-Transport-Server zum Senden von Nachrichten an einen lokalen Messagingserver, der kein SMTP (Simple Mail Transfer Protocol) als primären Transportmechanismus verwendet. Diese Messagingserver werden auch als "fremde Gatewayserver" bezeichnet. Fax-Gatewayserver von Drittherstellern sind ein Beispiel für fremde Gatewayserver. Bei den einem fremden Connector zugewiesenen Adressräumen kann es sich um SMTP- oder Nicht-SMTP-Adressräume handeln.

Syntax

New-ForeignConnector -Name <String> -AddressSpaces <MultiValuedProperty> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IsScopedConnector <$true | $false>] [-SourceTransportServers <MultiValuedProperty>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Das Cmdlet New-ForeignConnector erstellt einen neuen fremden Connector. Damit die erforderlichen Parameter für einen neuen fremden Connector abgefragt werden, geben Sie New-ForeignConnector ein. Nachdem diese Aufgabe abgeschlossen ist, wird ein fremder Connector erstellt.

Hinweis

Nachdem Sie einen neuen fremden Connector erstellt haben, müssen Sie den Microsoft Exchange-Transportdienst (MSExchangeTransport) neu starten, um die Änderungen zu übernehmen.

Damit Sie das Cmdlet New-ForeignConnector 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.

Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Exchange 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.

Parameter

Parameter Erforderlich Typ Beschreibung

AddressSpaces

Erforderlich

Microsoft.Exchange.Data.MultiValuedProperty

Mit diesem Parameter werden die Domänennamen angegeben, an die der fremde Connector Nachrichten sendet. Die vollständige Syntax zur Eingabe der einzelnen Adressräume lautet: <AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • AddressSpaceType   Der Typ des Adressraums kann SMTP, X400 oder eine beliebige andere Textzeichenfolge sein. Wenn Sie den Adressraumtyp auslassen, wird von SMTP als Adressraumtyp ausgegangen.

  • AddressSpace   Für SMTP-Adressraumtypen muss der angegebene Adressraum RFC 1035-konform sein. Beispielsweise sind *, *.com und *.contoso.com zulässig, *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 Adresstyp 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. 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 Adressraumstyps oder der Adressraumkosten muss in doppelte Anführungszeichen ( " ) eingeschlossen 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, wie im folgenden Beispiel: contoso.com,fabrikam.com. Die Angabe des Adressraumstyps oder der Adressraumkosten muss in doppelte Anführungszeichen ( " ) eingeschlossen werden, wie im folgenden Beispiel: "contoso.com;2","fabrikam.com;3".

Name

Erforderlich

System.String

Mit diesem Parameter wird ein Name für den fremden Connector angegeben.

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 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.

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.

IsScopedConnector

Optional

System.Boolean

Dieser Parameter steuert die Verfügbarkeit des Connectors für andere Hub-Transport-Server-Server. Wenn der Wert dieses Parameters $False ist, kann der Connector von allen Hub-Transport-Servern in der Exchange-Organisation verwendet werden. Wenn der Wert dieses Parameters $True ist, kann der Connector nur von Hub-Transport-Servern am gleichen Active Directory-Standort verwendet werden. Der Standardwert ist $False.

SourceTransportServers

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Mit diesem Parameter werden die Namen von Hub-Transport-Servern angegeben, die diesen fremden Connector nutzen. Es können mehrere Hub-Transport-Server angegeben werden, indem die Servernamen durch Komma getrennt werden. Wird ein einzelner fremder Connector mit mehreren Hub-Transport-Server verbunden, sorgt dies für Fehlertoleranz und hohe Verfügbarkeit, wenn einer der Hub-Transport-Server einmal ausfällt. Der Standardwert dieses Parameters ist der Name des Hub-Transport-Servers, auf dem der fremde Connector zuerst installiert wurde.

TemplateInstance

Optional

System.Management.Automation.PSObject

Wenn ein vorhandenes Objekt an diesen Parameter übergeben wird, verwendet das Cmdlet die Konfiguration des Objekts zum Erstellen einer Kopie des Objekts.

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.

Beispiel

Im folgenden Codebeispiel wird mit dem Cmdlet New-ForeignConnector ein neuer fremder Connector mit den folgenden Eigenschaften erstellt:

  • Connectorname: Contoso Foreign Connector

  • Adressraum: "Contoso.com"

  • Adressraumtyp: SMTP

  • Adressraumkosten: 5

  • Quelltransportserver: Hub01 und Hub02

New-ForeignConnector -Name "Contoso Foreign Connector" -AddressSpaces "SMTP:*.contoso.com;5" -SourceTransportServers "Hub01,Hub02"