Set-ForeignConnector

 

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

Letztes Änderungsdatum des Themas: 2007-06-28

Mit dem Cmdlet Set-ForeignConnector können Sie einen vorhandenen fremden Connector auf einem Computer ändern, auf dem Microsoft Exchange Server 2007 ausgeführt und die Serverfunktion Hub-Transport installiert ist. Ein fremder Connector verwendet ein Dropverzeichnis auf einem Hub-Transport-Server, um Nachrichten an einen lokalen Messagingserver zu senden, der als primären Transportmechanismus kein SMTP (Simple Mail Transfer Protocol) 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 handeln.

Syntax

Set-ForeignConnector -Identity <ForeignConnectorIdParameter> [-AddressSpaces <MultiValuedProperty>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-IsScopedConnector <$true | $false>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]

Set-ForeignConnector [-AddressSpaces <MultiValuedProperty>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <ForeignConnector>] [-IsScopedConnector <$true | $false>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Das Cmdlet Set-ForeignConnector ändert einen vorhandenen fremden Connector. Die Änderungen an den Eigenschaften, die Sie beim Verwenden des Cmdlets Set-ForeignConnector festlegen, überschreiben die vorhandenen Eigenschaftenwerte.

Damit Sie das Cmdlet Set-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

Identity

Erforderlich

Microsoft.Exchange.Configuration.Tasks.ForeignConnectorIdParameter

Dieser Parameter gibt den zu ändernden fremden Connector an. Der Parameter Identity akzeptiert jeden der folgenden Werte für den fremden Connector:

  • GUID

  • Connectorname

  • Servername\Connectorname

AddressSpaces

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Dieser Parameter gibt die Domänennamen an, 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".

Comment

Optional

System.String

Dieser Parameter gibt einen optionalen Kommentar für den fremden Connector an. Der Parameter Comment muss wie folgt in doppelte Anführungszeichen eingeschlossen werden, z. B.: "Dies ist eine Adminnotiz."

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.

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.

DropDirectory

Optional

System.String

Dieser Parameter gibt den Namen des Dropverzeichnisses an, das von diesem fremden Connector verwendet wird. Alle ausgehenden Nachrichten, die an Adressräume gesendet werden, die durch diesen fremden Connector definiert sind, werden im angegebenen Dropverzeichnis abgelegt. Der Speicherort des Dropverzeichnisses für jeden fremden Connector wird von den folgenden beiden Elementen gesteuert:

  • Der Parameter "RootDropDirectoryPath" im Cmdlet "Set-TransportServer"   Diese Option wird für alle fremden Connectors verwendet, die auf einem Hub-Transport-Server vorhanden sind. Der Wert des Parameters RootDropDirectoryPath kann ein lokaler Pfad oder ein UNC-Pfad (Universal Naming Convention) zu einem Remoteserver sein.

  • Der Parameter "DropDirectory" im Cmdlet "Set-ForeignConnector"   Dieser Wert wird für jeden fremden Connector festgelegt, der auf dem Hub-Transport-Server vorhanden ist.

In der Standardeinstellung ist der Parameter RootDropDirectoryPath leer. Dies bedeutet, dass der Wert von RootDropDirectoryPath dem Exchange 2007-Installationsordner entspricht. Standardmäßig lautet der Exchange 2007-Installationsordner C:\Programme\Microsoft\Exchange Server\. Der Wert des Parameters DropDirectory entspricht dem Namen des fremden Connectors.

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

Das Dropverzeichnis wird nicht für Sie erstellt. Aus diesem Grund müssen Sie jeden Dropverzeichnisordner manuell erstellen.

Dem Dropverzeichnis müssen die folgenden Berechtigungen zugewiesen werden:

  • Netzwerkdienst: Vollzugriff

  • System: Vollzugriff

  • Administratoren: Vollzugriff

DropDirectoryQuota

Optional

Microsoft.Exchange.Data.Unlimited

Dieser Parameter gibt die maximale Größe aller Nachrichtendateien im Dropverzeichnis an. Wenn der angegebene Wert erreicht ist, können neue Nachrichtendateien erst wieder in das Dropverzeichnis kopiert werden, wenn die vorhandenen Nachrichten übermittelt und gelöscht wurden. Wenn Sie einen Wert für den Parameter DropDirectoryQuota eingeben, qualifizieren Sie den Wert mit einer der folgenden Einheiten:

  • B (Bytes)

  • KB (Kilobytes)

  • MB (Megabytes)

  • GB (Gigabytes)

  • TB (Terabytes)

Nicht qualifizierte Werte werden als "Bytes" behandelt. Der gültige Eingabebereich für diesen Parameter liegt zwischen 1 und 2147483647 Byte(s). Bei Eingabe eines Werts vom Typ unlimited wird für das Dropverzeichnis keine Beschränkung für die Nachrichtengröße festgelegt. Der Standardwert ist unlimited.

Enabled

Optional

System.Boolean

Dieser Parameter aktiviert oder deaktiviert den fremden Connector. Die gültigen Eingabewerte sind $True und $False. Der Standardwert ist $True.

Force

Optional

System.Management.Automation.SwitchParameter

Dieser Parameter unterdrückt die Warn- oder Bestätigungsmeldungen, die während bestimmter Konfigurationsänderungen angezeigt werden.

Instance

Optional

Microsoft.Exchange.Data.Directory.SystemConfiguration.ForeignConnector

Der Parameter Instance ermöglicht das Übergeben eines vollständigen Objekts an den zu verarbeitenden Befehl. Er wird hauptsächlich in Skripts verwendet, in denen ein vollständiges Objekt an den Befehl übergeben werden muss.

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.

MaxMessageSize

Optional

Microsoft.Exchange.Data.Unlimited

Dieser Parameter gibt die maximale Größe einer Nachricht an, die über diesen fremden Connector übergeben werden kann. Wenn Sie einen Wert für den Parameter MaxMessageSize eingeben, qualifizieren Sie den Wert mit einer der folgenden Einheiten:

  • B (Bytes)

  • KB (Kilobytes)

  • MB (Megabytes)

  • GB (Gigabytes)

  • TB (Terabytes)

Nicht qualifizierte Werte werden als "Kilobytes" behandelt. Bei Eingabe eines Werts vom Typ unlimited wird für diesen fremden Connector keine Beschränkung für die Nachrichtengröße festgelegt. Der Standardwert ist unlimited. Der gültige Eingabebereich für diesen Parameter liegt zwischen 0 und 2147483647 Kilobyte(s). Wenn Sie den Wert des Parameters MaxMessageSize auf 0 festlegen, wird der fremde Connector deaktiviert. Wenn Sie jedoch den Wert des Parameters MaxMessageSize auf 0 festlegen und das Attribut Enabled den Wert $True aufweist, treten Fehler im Ereignisprotokoll auf. Die bevorzugte Methode für das Deaktivieren des fremden Connectors ist die Verwendung des Parameters Enabled.

Name

Optional

System.String

Dieser Parameter gibt einen beschreibenden Namen für den fremden Connector an.

RelayDsnRequired

Optional

System.Boolean

Dieser Parameter gibt an, ob beim Schreiben von Nachrichten in das Dropverzeichnis eine mittels Relay umgeleitete Benachrichtigung über den Übermittlungsstatus für den fremden Connector erforderlich ist. Die gültigen Eingabewerte für diesen Parameter sind $True und $False. Der Standardwert ist $False.

SourceTransportServers

Optional

Microsoft.Exchange.Data.MultiValuedProperty

Dieser Parameter gibt die Namen der Hub-Transport-Server an, die diesen fremden Connector verwenden. Sie können mehrere Hub-Transport-Server angeben, indem Sie die Servernamen durch Komma trennen. Bei einem einzelnen fremden Connector, der sich auf mehreren Hub-Transport-Servern befindet, werden Fehlertoleranz und eine hohe Verfügbarkeit bereitgestellt, wenn bei einem der Hub-Transport-Server ein Fehler auftritt. Der Standardwert für diesen Parameter entspricht dem Namen des Hub-Transport-Servers, auf dem der fremde Connector zuerst installiert wurde.

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

Das folgende Codebeispiel zeigt zwei Beispiele, die das Cmdlet Set-ForeignConnector verwenden.

Das erste Beispiel zeigt einen Set-ForeignConnector-Befehl, der einen vorhandenen fremden Connector mit dem Namen Contoso Foreign Connector" ändert. Der Befehl legt den Parameter MaxMessageSize auf 10 MB fest.

Das zweite Beispiel zeigt einen Set-ForeignConnector-Befehl, der die Adressräume ändert, die von einem vorhandenen fremden Connector mit dem Namen Contoso Foreign Connector" bedient werden. Die Einzelheiten zu den Adressräumen lauten wie folgt:

  • Erster Adressraum:

    • Adressraumtyp: SMTP

    • Adressraum: "*.contoso.com"

    • Adressraumkosten: 1

  • Zweiter Adressraum:

    • Adressraumtyp: Lotus Notes

    • Adressraum: "*@domino"

    • Adressraumkosten: 55

Set-ForeignConnector "Contoso Foreign Connector" -MaxMessageSize 10MB
Set-ForeignConnector "Contoso Foreign Connector" -AddressSpaces ".contoso.com","Lotus Notes:*@domino;55"