Set-TransportRule

  • Artikel

 

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 Set-TransportRule, um eine vorhandene Transportregel zu ändern, die vom Transportregel-Agent zum Verarbeiten von E-Mail-Nachrichten auf einem Computer verwendet wird, auf dem die Serverfunktion Hub-Transport oder Edge-Transport installiert ist.

Syntax

Set-TransportRule -Identity <RuleIdParameter> [-Actions <TransportRuleAction[]>] [-Comments <String>] [-Conditions <TransportRulePredicate[]>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Exceptions <TransportRulePredicate[]>] [-Name <String>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

Set-TransportRule [-Actions <TransportRuleAction[]>] [-Comments <String>] [-Conditions <TransportRulePredicate[]>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Exceptions <TransportRulePredicate[]>] [-Instance <Rule>] [-Name <String>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Mit dem Cmdlet Set-TransportRule können Sie eine vorhandene Transportregel ändern, die vom Transportregel-Agent zum Verarbeiten von E-Mail-Nachrichten auf einem Hub-Transport-Server oder einem Edge-Transport-Server verwendet wird.

Jede Bedingung und jede Ausnahme muss ein unterstütztes Transportregelprädikat verwenden. Jedes Prädikat besteht aus mindestens einer Bedingung und den Werten, auf die die Bedingung prüft.

Eine Liste der unterstützten Transportregelprädikate finden Sie unter Transportregelprädikate.

Jede Aktion muss eine unterstützte Transportregelaktion verwenden. Jede Aktion besteht aus mindestens einer Aktion und den Werten, die von der Aktion zum Ausführen ihrer Aufgabe verwendet werden.

Eine Liste mit unterstützten Regelaktionen finden Sie unter Aktionen von Transportregeln.

Ausführliche Informationen zum Ändern einer vorhandenen Transportregel finden Sie unter Ändern einer Transportregel.

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

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

  • die Rolle Exchange-Organisationsadministrator

Um das Cmdlet Set-TransportRule 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 Gruppe Administratoren auf diesem Computer ist.

Weitere Informationen zu Berechtigungen, zum Delegieren von Rollen und zu den Rechten, die für die Verwaltung von Microsoft Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.RuleIdParameter

Verwenden Sie diesen Parameter, um die GUID der Transportregel oder des Regelnamens anzugeben, die vom Administrator beim Erstellen der Regel konfiguriert wurde.

Actions

Optional

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRuleAction[]

Verwenden Sie diesen Parameter, um die Aktionen anzugeben, die von der Transportregel auf die E-Mail-Nachricht angewendet werden, wenn alle Bedingungen erfüllt sind und keine Ausnahmen auftreten. Für jede Regel muss mindestens eine Aktion angegeben werden.

Comments

Optional

System.String

Verwenden Sie diesen Parameter, um der Transportregel informative Kommentare hinzuzufügen, wie etwa, wofür die Regel verwendet wird oder wie sie im Lauf der Zeit geändert wurde. Die Länge des Kommentars darf 512 Zeichen nicht überschreiten.

Conditions

Optional

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRulePredicate[]

Verwenden Sie diesen Parameter, um die Bedingungen anzugeben, die vom Transportregel-Agent auf E-Mail-Nachrichten angewendet werden, die an den Transportregel-Agent gesendet werden. Wenn Sie für eine Regel keine Bedingung konfigurieren, wird die Regel auf alle Nachrichten angewendet, wenn keine Übereinstimmung mit Bedingungen besteht.

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 Active Directory 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).

Exceptions

Optional

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRulePredicate[]

Verwenden Sie diesen Parameter, um die Ausnahmen anzugeben, die vom Transportregel-Agent auf die E-Mail-Nachricht angewendet werden. Wenn eine Nachricht mit einer Ausnahme übereinstimmt, werden keine der für die Regel angegebenen Aktionen auf die Nachricht angewendet.

Instance

Optional

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.Rule

Verwenden Sie diesen Parameter, um dem zu verarbeitenden Befehl ein gesamtes Objekt zu übergeben. Dieser Parameter wird hauptsächlich in Skripts verwendet, in denen ein gesamtes Objekt an den Befehl übergeben werden muss.

Name

Optional

System.String

Verwenden Sie diesen Parameter, um den Anzeigenamen der zu erstellenden Transportregel anzugeben. Die Länge des Namens darf 64 Zeichen nicht überschreiten.

Priority

Optional

System.Int32

Verwenden Sie diesen Parameter, um die Reihenfolge anzugeben, in der die Transportregeln angewendet werden. Wenn Sie die Priorität der Regel ändern, ändert sich die Position der Regel in der Regelliste, so dass sie mit der angegebenen Priorität übereinstimmt, und der Transportregel-Agent legt für alle Regeln einen höheren Prioritätswert fest. Regeln mit niedrigerem Prioritätswert werden zuerst verarbeitet. Der Wert dieses Parameters muss größer als oder gleich 0 sein.

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

Der folgende Absatz stellt ein vollständiges Beispiel dar, in dem das Ändern einer vorhandenen Transportregel auf einem Hub-Transport-Server veranschaulicht wird. Das Beispiel zeigt, wie Sie die Bedingungen für eine Transportregel ohne Auswirkung auf die Ausnahmen oder Aktionen für die betreffende Regel ändern können.

Die Regel wird geändert, um die folgende Bedingung anzuwenden:

  • von Mitglied von Verteilerliste   Der Wert für diese Bedingung ist die Verteilergruppe "Sales Group".
$Condition = Get-TransportRulePredicate FromMemberOf
$Condition.Addresses = @((Get-DistributionGroup "Sales Group"))
Set-TransportRule "Sales-Brokerage Wall" -Condition @($condition)