Set-ForeignConnector

Modul:: Exchange PowerShell

Dieses Cmdlet ist nur lokal in Exchange verfügbar.

Verwenden Sie das Cmdlet Set-ForeignConnector, um einen vorhandenen fremden Connector im Transportdienst eines Postfachservers zu ändern.

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

Syntax

Default (Standard)

Set-ForeignConnector
    [-Identity] <ForeignConnectorIdParameter>
    [-AddressSpaces <MultiValuedProperty>]
    [-Comment <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-DropDirectory <String>]
    [-DropDirectoryQuota <Unlimited>]
    [-Enabled <Boolean>]
    [-Force]
    [-IsScopedConnector <Boolean>]
    [-MaxMessageSize <Unlimited>]
    [-Name <String>]
    [-RelayDsnRequired <Boolean>]
    [-SourceTransportServers <MultiValuedProperty>]
    [-WhatIf]
    [<CommonParameters>]

Beschreibung

Ein Fremd-Connector verwendet ein Drop-Verzeichnis im Transportdienst eines Postfachservers, um Nachrichten an einen lokalen Messaging-Server zu senden, der SMTP nicht als primären Transportmechanismus verwendet. Diese Messagingserver werden als fremde Gatewayserver bezeichnet. Beispiele für fremde Gatewayserver, die nicht von Microsoft stammen, sind Beispiele für ausländische Gatewayserver. Die einem fremden Connector zugewiesenen Adressräume können SMTP oder Nicht-SMTP sein.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen 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

Set-ForeignConnector "Fax Connector" -MaxMessageSize 10MB

In diesem Beispiel wird eine Nachrichtengrößenbeschränkung von 10 MB für den vorhandenen fremden Connector namens Faxconnector konfiguriert.

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 jedes Adressraums lautet: AddressSpaceType:AddressSpace;AddressSpaceCost.

AddressSpaceType: Der Adressraumtyp kann SMTP, X400 oder eine 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 des Adresstyps können Sie einen beliebigen Text für den Adressraum eingeben.
AddressSpaceCost : Der gültige Eingabebereich für die Kosten liegt zwischen 1 und 100. Ein niedrigerer Kostenwert zeigt eine bessere Route an. Wenn Sie die Adressraumkosten fortlassen, werden Kosten von 1 angenommen. Wenn Sie einen Nicht-SMTP-Adressraum eingeben, der ein Semikolon (;)) enthält, müssen Sie die Kosten für den Adressraum 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 (") setzen, z. B.: "contoso.com;2","fabrikam.com;3".

Verwenden Sie die folgende Syntax, um einen oder mehrere Adressraumwerte hinzuzufügen oder zu entfernen, ohne dass sich dies auf vorhandene Einträge auswirkt: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Parametereigenschaften

Typ:	MultiValuedProperty
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Comment

Der „Comment“-Parameter gibt einen optionalen Kommentar an. Wenn Sie einen Wert angeben, der Leerzeichen enthält, setzen Sie den Wert in Anführungszeichen ("), z. B. "This is an admin note".

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Confirm

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie sich diese Option auf das Cmdlet auswirkt, hängt davon ab, ob für das Cmdlet eine Bestätigung erforderlich ist, bevor Sie fortfahren.

Destruktive Cmdlets (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
Die meisten anderen Cmdlets (beispielsweise New-*- und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt die Angabe des Bestätigungsschalters ohne Wert zu einer Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	vgl

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

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

Parametereigenschaften

Typ:	Fqdn
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-DropDirectory

Der DropDirectory-Parameter gibt den Namen des Drop-Verzeichnisses an, das von diesem fremden Connector verwendet wird. Alle ausgehenden Nachrichten, die an Adressräume gesendet werden, die von diesem fremden Connector definiert sind, werden im angegebenen Ablageverzeichnis abgelegt. Der Speicherort des Ablageverzeichnisses für jeden fremden Connector wird durch die folgenden beiden Elemente gesteuert:

RootDropDirectoryPath-Parameter im Set-TransportService Cmdlet: Diese Option wird für alle fremden Connectors verwendet, die auf dem Postfachserver vorhanden sind. Der Wert des Parameters RootDropDirectoryPath kann ein lokaler Pfad oder ein UNC-Pfad (Universal Naming Convention) zu einem Remoteserver sein.
DropDirectory-Parameter im Set-ForeignConnector Cmdlet: Dieser Wert wird für jeden Fremdconnector festgelegt, der auf dem Server vorhanden ist.

In der Standardeinstellung ist der Parameter RootDropDirectoryPath leer. Dies weist darauf hin, dass der Wert von "RootDropDirectoryPath" der Exchange 2010-Installationsordner ist. Der Standardinstallationsordner von Exchange 2010 lautet "C:\Program Files\Microsoft\Exchange Server\". Standardmäßig ist der Wert des DropDirectory-Parameters der Name des fremden Connectors.

Wenn der Wert des DropDirectory-Parameters keine absoluten Pfadinformationen enthält, wird der Speicherort des Drop-Verzeichnisses durch die Kombination aus dem DropDirectory-Parameter und dem RootDropDirectoryPath-Parameter definiert. Wenn der Wert des DropDirectory-Parameters absolute Pfadinformationen enthält, darf der Wert von RootDropDirectoryPath nicht angegeben sein. Der Speicherort des Drop-Verzeichnisses wird nur durch den Wert des DropDirectory-Parameters definiert.

Das Ablageverzeichnis wurde nicht für Sie erstellt. Daher müssen Sie jeden Ablageverzeichnisordner manuell erstellen.

Dem Drop-Verzeichnis müssen die folgenden Berechtigungen zugewiesen sein:

Netzwerkdienst: Vollzugriff
System: Vollzugriff
Administratoren: Vollzugriff

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-DropDirectoryQuota

Der Parameter DropDirectoryQuota gibt die maximale Größe aller Nachrichtendateien im Drop-Verzeichnis an. Wenn der angegebene Wert erreicht ist, können keine neuen Nachrichtendateien in das Ablageverzeichnis kopiert werden, bis die vorhandenen Nachrichten zugestellt und gelöscht wurden.

Wenn Sie einen Wert eingeben, qualifizieren Sie den Wert mit einer der folgenden Einheiten:

B (Bytes)
KB (Kilobytes)
MB (Megabytes)
GB (Gigabytes)
TB (Terabytes)

Nicht qualifizierte Werte werden in der Regel als Bytes behandelt, kleine Werte werden jedoch möglicherweise auf das nächste Kilobyte aufgerundet.

Der gültige Eingabebereich für diesen Parameter liegt zwischen 1 und 2147483647 Byte. Wenn Sie den Wert "unlimited" eingeben, wird dem Verzeichnis "Löschen" keine Nachrichtengrößenbeschränkung auferlegt. Der Standardwert ist unbegrenzt.

Parametereigenschaften

Typ:	Unlimited
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Enabled

Der Parameter Enabled gibt an, ob der Fremd-Connector aktiviert werden soll. Gültige Werte sind $true und $false. Der Standardwert lautet $true.

Parametereigenschaften

Typ:	Boolean
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Force

Der Schalter „Erzwingen“ blendet Warnungs- oder Bestätigungsmeldungen aus. Sie müssen keinen Wert für diese Option angeben.

Sie können diesen Switch verwenden, um Aufgaben in Fällen programmgesteuert auszuführen, in denen die administrative Eingabe unangemessen ist.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Identity

Der Parameter "Identity" gibt den Fremdverbinder an, den Sie ändern möchten. Der Parameter Identity akzeptiert jeden der folgenden Werte für den fremden Connector:

GUID
Connectorname
ServerName\ConnectorName

Parametereigenschaften

Typ:	ForeignConnectorIdParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	1
Obligatorisch:	True
Wert aus Pipeline:	True
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-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 im Exchange-organization verwendet werden. Wenn der Wert dieses Parameters $true ist, kann der Connector nur von Postfachservern am selben Active Directory-Standort verwendet werden. Der Standardwert ist $false.

Parametereigenschaften

Typ:	Boolean
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-MaxMessageSize

Der Parameter MaxMessageSize gibt die maximale Größe einer Nachricht an, die diesen fremden Connector passieren kann.

Wenn Sie einen Wert eingeben, qualifizieren Sie den Wert mit einer der folgenden Einheiten:

B (Bytes)
KB (Kilobytes)
MB (Megabytes)
GB (Gigabytes)
TB (Terabytes)

Nicht qualifizierte Werte werden in der Regel als Bytes behandelt, kleine Werte werden jedoch möglicherweise auf das nächste Kilobyte aufgerundet.

Wenn Sie den Wert unlimited eingeben, wird diesem fremden Connector keine Nachrichtengrößenbeschränkung auferlegt. Der Standardwert ist unbegrenzt. Der gültige Eingabebereich für diesen Parameter liegt zwischen 0 und 2147483647 KB. Wenn Sie den Wert des MaxMessageSize-Parameters auf 0 festlegen, deaktivieren Sie effektiv den Fremdenconnector. Wenn Sie jedoch den Wert des MaxMessageSize-Parameters auf 0 festlegen, wenn der Wert des Enabled-Attributs $true ist, generieren Sie Ereignisprotokollfehler. Die bevorzugte Methode zum Deaktivieren des Fremdenconnectors ist die Verwendung des Parameters Enabled.

Parametereigenschaften

Typ:	Unlimited
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Name

Der Name-Parameter gibt einen beschreibenden Namen für den Fremd-Connector an.

Parametereigenschaften

Typ:	String
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-RelayDsnRequired

Der Parameter RelayDsnRequired gibt an, ob eine Relay Delivery Status Notification (DSN) vom Fremdenconnector benötigt wird, wenn Nachrichten in das Drop-Verzeichnis geschrieben werden. Die gültigen Eingabewerte für diesen Parameter sind $true oder $false. Der Standardwert ist $false.

Parametereigenschaften

Typ:	Boolean
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-SourceTransportServers

Der Parameter SourceTransportServers gibt die Namen der Postfachserver an, die diesen fremden Connector verwenden. Die Verwaltung eines einzigen fremden Connectors auf mehreren Postfachservern, auf denen der Transportdienst ausgeführt wird, bietet Fehlertoleranz und Hochverfügbarkeit, wenn einer der Server ausfällt. Der Standardwert dieses Parameters ist der Name des Postfachservers, auf dem dieser fremde Connector zuerst installiert wurde.

Verwenden Sie zum Eingeben mehrerer Werte und zum Überschreiben vorhandener Einträge die folgende Syntax: Value1,Value2,...ValueN. Wenn die Werte Leerzeichen oder anderweitig erforderliche Anführungszeichen enthalten, verwenden Sie die folgende Syntax: "Value1","Value2",..."ValueN".

Verwenden Sie die folgende Syntax, um mindestens einen Wert hinzuzufügen oder zu entfernen, ohne dass dies Auswirkungen auf vorhandene Einträge hat: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Parametereigenschaften

Typ:	MultiValuedProperty
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-WhatIf

Der Schalter "WhatIf" zeigt die Funktion des Befehls an, ohne Änderungen vorzunehmen. Sie müssen keinen Wert für diese Option angeben.

Parametereigenschaften

Typ:	SwitchParameter
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	Wi

Parametersätze

(All)

Position:	Named
Obligatorisch:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.

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 und die von diesem Cmdlet akzeptiert werden, finden Sie unter Eingabe- und Ausgabetypen von Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.

Feedback

War diese Seite hilfreich?