New-ForeignConnector

Dieses Cmdlet ist nur lokal in Exchange verfügbar.

Verwenden Sie das Cmdlet New-ForeignConnector, um einen neuen Foreign-Connector im Transportdienst eines Postfachservers zu erstellen.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

New-ForeignConnector
   [-Name] <String>
   -AddressSpaces <MultiValuedProperty>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-IsScopedConnector <Boolean>]
   [-SourceTransportServers <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Beschreibung

Ein Fremdconnector verwendet ein Drop-Verzeichnis im Transportdienst eines Postfachservers, um Nachrichten an einen lokalen Messagingserver zu senden, der SMTP nicht als primären Transportmechanismus verwendet. Diese Messagingserver werden als ausländische Gatewayserver bezeichnet. Faxgatewayserver von Drittanbietern sind Beispiele für ausländische Gatewayserver. Die Adressräume, die einem Ausländischen Connector zugewiesen sind, können SMTP oder Nicht-SMTP sein.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.

Beispiele

Beispiel 1

New-ForeignConnector -Name "Contoso Foreign Connector" -AddressSpaces "X400:c=US;a=Fabrikam;P=Contoso;5" -SourceTransportServers Hub01,Hub02

In diesem Beispiel wird ein Foreign-Connector mit den folgenden Eigenschaften erstellt:

  • Connectorname: Contoso Foreign Connector
  • Adressraum: "c=US;a=Fabrikam; P=Contoso"
  • Adressraumtyp: X.400
  • Adressraumkosten: 5
  • Quelltransportserver: Hub01 und Hub02

Parameter

-AddressSpaces

Der Parameter AddressSpaces gibt die Domänennamen an, an die der Foreign-Connector Nachrichten sendet. Die vollständige Syntax für die Eingabe der einzelnen Adressräume lautet: AddressSpaceType:AddressSpace;AddressSpaceCost.

  • AddressSpaceType: Der Adressraumtyp kann SMTP, X400 oder eine beliebige andere Textzeichenfolge sein. Wenn Sie den Adressraumtyp weglassen, wird ein SMTP-Adressraumtyp angenommen.
  • AddressSpace: Für SMTP-Adressraumtypen muss der angegebene Adressraum RFC 1035-konform sein. Beispielsweise sind *, *.com und *.contoso.com zulässig, aber *contoso.com ist 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. Für alle anderen Werte eines Adresstyps können Sie einen beliebigen Text für den Adressraum eingeben.
  • 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 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, müssen Sie den Adressraum in Anführungszeichen (") einschließen, z. B.: "contoso.com;2","fabrikam.com;3".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

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.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

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.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IsScopedConnector

Der Parameter IsScopedConnector gibt die Verfügbarkeit des Connectors für die Postfachserver 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 von Postfachservern am gleichen Active Directory-Standort verwendet werden. Der Standardwert ist $false.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Name

Der Parameter Name gibt den Namen für den Foreign-Connector an.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SourceTransportServers

Der Parameter SourceTransportServers gibt die Namen der Postfachserver an, die diesen Foreign-Connector verwenden. Wenn ein einzelner Foreign-Connector auf mehreren Servern gehostet wird, bietet fehlertoleranz und Hochverfügbarkeit, wenn einer der Postfachserver ausfällt. Der Standardwert dieses Parameters ist der Name des Servers, auf dem dieser Foreign-Connector zuerst installiert wird.

Mehrere Werte können durch Kommata getrennt eingegeben werden. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

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.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Eingaben

Input types

Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.

Ausgaben

Output types

Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.