Import-TransportRuleCollection

Artikel
09/29/2014

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

Letztes Änderungsdatum des Themas: 2007-07-27

Verwenden Sie das Cmdlet Import-TransportRuleCollection zum Importieren einer zuvor exportierten Transportregelsammlung für die Verwendung durch den Transportregel-Agent auf einem Computer, auf dem die Microsoft Exchange Server 2007-Serverfunktion Hub-Transport oder Edge-Transport installiert ist.

Syntax

Import-TransportRuleCollection -FileName <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Das Cmdlet Import-TransportRuleCollection importiert eine zuvor exportierte Transportregelsammlung für die Verwendung durch den Transportregel-Agent.

Achtung:
Beim Importieren einer Transportregelsammlung aus einer XML-Datei werden alle vorher bestehenden Transportregeln entfernt oder überschrieben, die für den Transportregel-Agent definiert waren. Stellen Sie sicher, dass Sie vor dem Importieren über eine Sicherungskopie der aktuellen Transportregelsammlung verfügen, bevor Sie die aktuellen Transportregeln überschreiben. Auf Hub-Transport-Servern überschreibt der Import-TransportRuleCollection-Befehl alle Transportregeln, die in der Exchange 2007-Organisation konfiguriert sind, mit Ausnahme von Transportregeln auf Edge-Transport-Servern. Auf Edge-Transport-Servern überschreibt dieser Befehl nur Transportregeln, die auf dem lokalen Computer konfiguriert sind.

Beim Importieren einer Transportregelsammlung aus einer XML-Datei werden alle vorher bestehenden Transportregeln entfernt oder überschrieben, die für den Transportregel-Agent definiert waren. Stellen Sie sicher, dass Sie vor dem Importieren über eine Sicherungskopie der aktuellen Transportregelsammlung verfügen, bevor Sie die aktuellen Transportregeln überschreiben.
Auf Hub-Transport-Servern überschreibt der Import-TransportRuleCollection-Befehl alle Transportregeln, die in der Exchange 2007-Organisation konfiguriert sind, mit Ausnahme von Transportregeln auf Edge-Transport-Servern. Auf Edge-Transport-Servern überschreibt dieser Befehl nur Transportregeln, die auf dem lokalen Computer konfiguriert sind.

Informationen zum Exportieren einer Transportregelsammlung in eine XML-Datei finden Sie unter Export-TransportRuleCollection.

Informationen über den Agent für Transportregeln finden Sie unter Übersicht über Transportregeln.

Damit Sie das Cmdlet Import-TransportRuleCollection ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:

die Rolle Exchange-Organisationsadministrator

Um das Cmdlet Import-TransportRuleCollection auf einem Computer ausführen zu können, auf dem die Serverfunktion Edge-Transport installiert ist, müssen Sie sich mit einem Konto anmelden, das Mitglied der lokalen Gruppen Administratoren auf diesem Computer ist.

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
FileName	Erforderlich	System.String	Verwenden Sie diesen Parameter, um den vollständigen Pfad und Dateinamen der zu importierenden XML-Datei anzugeben. Wenn der Pfad oder Dateinamen Leerzeichen enthält, schließen Sie die gesamte Zeichenfolge in Leerzeichen ein. Beispiel: `"C:\Transport Rules\New Transport Rules.xml"`
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 Daten aus dem Active Directory-Verzeichnisdienst abruft, fügen Sie dem Befehl den Parameter DomainController hinzu. Der Parameter DomainController wird nicht auf Computern unterstützt, auf denen die Serverfunktion Edge-Transport ausgeführt wird. Die Serverfunktion Edge-Transport schreibt nur in die lokale Active Directory-ADAM-Instanz (Application Mode).
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.

Eingabetypen

Rückgabetypen

Fehler

Fehler	Beschreibung

Ausnahmen

Ausnahmen	Beschreibung

Beispiel

Das folgende Codebeispiel zeigt die Syntax für den Befehl Import-TransportRuleCollection.

Import-TransportRuleCollection -FileName "c:\transport rules\new transport rules.xml"