Set-ForeignConnector (RTM)

  • Artikel

 

Gilt für: Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-06-11

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>] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>]

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

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. Sie können mehrere Adressräume angeben, indem Sie diese durch Komma trennen. Die vollständige Syntax zur Eingabe der einzelnen Adressräume lautet:

<ConnectorScope>:<AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • ConnectorScope   Wenn Sie einen Wert von Local angeben, kann der Connector nur von anderen Hub-Transport-Servern verwendet werden, die am gleichen Active Directory-Standort wie der Hub-Transport-Quellserver vorhanden sind, auf dem das Cmdlet New-SendConnector ausgeführt wird. Wenn Sie den Qualifizierer ConnectorScope auslassen, kann der Connector von allen Hub-Transport-Servern verwendet werden, die in der gesamten Exchange 2007-Organisation vorhanden sind.

  • AddressSpaceType   Im Falle von SMTP-Adressräumen muss dieser Wert "SMTP" lauten. Bei anderen Adressräumen als SMTP kann dieser Wert eine beliebige beschreibende Textzeichenfolge sein, z. B. "Lotus Notes".

  • AddressSpace   Im Falle von SMTP-Adressräumen kann das DNS (Domain Name System)-Platzhalterzeichen (*) verwendet werden, wie es in RFC 1035 definiert ist, z. B. "*", "*.com." oder *.contoso.com". Bei anderen Adressräumen als SMTP können Platzhalterzeichen (*) und andere Zeichen verwendet werden, z. B. "*contoso.com" oder "@contoso".

  • AddressSpaceCost   Der gültige Eingabebereich für die Kosten beträgt 1 bis 100. Ein niedrigerer Kostenwert zeigt eine bessere Route an. Dieser Parameter ist optional. Wenn Sie den Qualifizierer AddressSpaceCost bei Eingabe eines Adressraums unter Verwendung der vollständigen Syntax auslassen, werden Connectorkosten mit dem Wert 1 vorausgesetzt.

Sie müssen die vollständige Syntax für den Parameter AddressSpaces nur unter folgenden Bedingungen verwenden:

  • Connectors mit Gültigkeitsbereich, die über den Qualifizierer Local verfügen

  • Andere Adressräume als SMTP

  • SMTP-Adressräume mit Kosten ungleich 1

Wenn Sie einen Domänennamen oder eine durch Kommas getrennte Liste von Domänennamen für den Wert des Parameters AddressSpaces eingeben, werden SMTP als Adressraumtyp und der Wert 1 als Kosten für jeden Domänennamen angenommen.

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

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 dieser Parameter leer. Dies gibt an, dass der Wert von RootDropDirectoryPath dem Exchange 2007-Installationsordner entspricht. Der standardmäßige Exchange 2007-Installationsordner lautet 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 (Byte)

  • KB (Kilobyte)

  • MB (Megabyte)

  • GB (Gigabyte)

  • TB (Terabytes)

Nicht qualifizierte Werte werden als "Byte" behandelt. Der gültige Eingabebereich für diesen Parameter liegt zwischen 1 und 2147483647 Byte. 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.

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.

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 (Byte)

  • KB (Kilobyte)

  • MB (Megabyte)

  • GB (Gigabyte)

  • TB (Terabytes)

Nicht qualifizierte Werte werden als "Kilobyte" 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. 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.

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"