Set-ForeignConnector
Dieses Cmdlet ist nur lokal in Exchange verfügbar.
Verwenden Sie das Cmdlet Set-ForeignConnector, um einen vorhandenen Foreign-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
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 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
Set-ForeignConnector "Fax Connector" -MaxMessageSize 10MBIn diesem Beispiel wird ein Nachrichtengrößenlimit von 10 MB für den vorhandenen Foreign-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 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 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 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".
Verwenden Sie die folgende Syntax, um einen oder mehrere Adressraumwerte ohne Auswirkungen auf vorhandene Einträge hinzuzufügen oder zu entfernen: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
| 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 |
-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".
| Type: | String |
| 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 |
-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 |
-DropDirectory
Der Parameter DropDirectory gibt den Namen des Drop-Verzeichnisses an, das von diesem Foreign-Connector verwendet wird. Alle ausgehenden Nachrichten, die an Adressräume gesendet werden, die von diesem Foreign-Connector definiert werden, werden im angegebenen Drop-Verzeichnis abgelegt. Der Speicherort des Drop-Verzeichnisses für jeden Foreign-Connector wird durch die folgenden beiden Elemente gesteuert:
- RootDropDirectoryPath-Parameter im cmdlet Set-TransportService: Diese Option wird für alle Foreign-Connectors verwendet, die auf dem Postfachserver vorhanden sind. Der Wert des RootDropDirectoryPath-Parameters kann ein lokaler Pfad oder ein UNC-Pfad (Universal Naming Convention) zu einem Remoteserver sein.
- DropDirectory-Parameter im cmdlet Set-ForeignConnector: Dieser Wert wird für jeden Foreign Connector festgelegt, der auf dem Server vorhanden ist.
In der Standardeinstellung ist der Parameter RootDropDirectoryPath leer. Dies gibt an, dass der Wert von RootDropDirectoryPath der Exchange 2010-Installationsordner ist. Der Standardmäßige Exchange 2010-Installationsordner ist C:\Programme\Microsoft\Exchange Server\. Standardmäßig ist der Wert des DropDirectory-Parameters der Name des Foreign-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, muss der Wert von RootDropDirectoryPath nicht angegeben sein. Der Speicherort des Drop-Verzeichnisses wird nur durch den Wert des DropDirectory-Parameters definiert.
Das Drop-Verzeichnis wird nicht für Sie erstellt. Daher müssen Sie jeden Drop-Verzeichnisordner manuell erstellen.
Dem Drop-Verzeichnis müssen die folgenden Berechtigungen zugewiesen sein:
- Netzwerkdienst: Vollzugriff
- System: Vollzugriff
- Administratoren: Vollzugriff
| Type: | String |
| 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 |
-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 Drop-Verzeichnis kopiert werden, bis die vorhandenen Nachrichten übermittelt und gelöscht werden.
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 Byte behandelt, kleine Werte werden jedoch auf das nächsthöhere Kilobyte aufgerundet.
Der gültige Eingabebereich für diesen Parameter liegt zwischen 1 und 2147483647 Bytes. Wenn Sie den Wert unbegrenzt eingeben, wird für das Verzeichnis "Löschen" keine Größenbeschränkung für Nachrichten festgelegt. Der Standardwert ist unbegrenzt.
| Type: | Unlimited |
| 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 |
-Enabled
Der Parameter Enabled gibt an, ob der Foreign-Connector aktiviert werden soll. Gültige Werte sind $true und $false. Der Standardwert ist $true.
| 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 |
-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.
| Type: | SwitchParameter |
| 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 |
-Identity
Der Parameter Identity gibt den Foreign-Connector an, den Sie ändern möchten. Der Parameter Identity akzeptiert jeden der folgenden Werte für den fremden Connector:
- GUID
- Connectorname
- ServerName\ConnectorName
| Type: | ForeignConnectorIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| 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 |
-MaxMessageSize
Der Parameter MaxMessageSize gibt die maximale Größe einer Nachricht an, die diesen Foreign-Connector durchlaufen 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 Byte behandelt, kleine Werte werden jedoch auf das nächsthöhere Kilobyte aufgerundet.
Wenn Sie den Wert unbegrenzt eingeben, wird für diesen Foreign-Connector keine Größenbeschränkung für Nachrichten festgelegt. Der Standardwert ist unbegrenzt. Der gültige Eingabebereich für diesen Parameter liegt zwischen 0 und 2147483647 Kilobytes. Wenn Sie den Wert des Parameters MaxMessageSize auf 0 festlegen, deaktivieren Sie den Foreign-Connector effektiv. Wenn Sie jedoch den Wert des Parameters MaxMessageSize auf 0 festlegen, wenn der Wert des Enabled-Attributs $true ist, generieren Sie Ereignisprotokollfehler. Die bevorzugte Methode zum Deaktivieren des Foreign-Connectors ist die Verwendung des Parameters Enabled.
| Type: | Unlimited |
| 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 einen beschreibenden Namen für den Foreign-Connector an.
| Type: | String |
| 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 |
-RelayDsnRequired
Der Parameter RelayDsnRequired gibt an, ob eine Relay-Übermittlungsstatusbenachrichtigung (DSN) vom Foreign-Connector erforderlich ist, wenn Nachrichten in das Drop-Verzeichnis geschrieben werden. Die gültigen Eingabewerte für diesen Parameter sind $true oder $false. 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 |
-SourceTransportServers
Der Parameter SourceTransportServers gibt die Namen der Postfachserver an, die diesen Foreign-Connector verwenden. Wenn ein einzelner Foreign-Connector auf mehreren Postfachservern gehostet wird, 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 Foreign-Connector zum ersten Mal installiert wurde.
Verwenden Sie die folgende Syntax, um mehrere Werte einzugeben und vorhandene Einträge zu überschreiben: 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 einen oder mehrere Werte ohne Auswirkungen auf vorhandene Einträge hinzuzufügen oder zu entfernen: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
| 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.