New-TransportRule (RTM)
Gilt für: Exchange Server 2007
Letztes Änderungsdatum des Themas: 2007-06-08
Mit dem Cmdlet New-TransportRule können Sie eine neue Transportregel erstellen, die der Agent für Transportregeln beim Verarbeiten von E-Mail-Nachrichten anwendet, die einen Computer durchlaufen, auf dem die Serverfunktion Hub-Transport oder Edge-Transport installiert ist.
Syntax
New-TransportRule -Name <String> -Actions <TransportRuleAction[]> [-Comments <String>] [-Conditions <TransportRulePredicate[]>] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-Exceptions <TransportRulePredicate[]>] [-Priority <Int32>] [-TemplateInstance <PSObject>]
Detaillierte Beschreibung
Mit dem Cmdlet New-TransportRule können Sie eine neue Transportregel erstellen, die der Agent für Transportregeln beim Verarbeiten von E-Mail-Nachrichten anwendet, die einen Hub-Transport- oder Edge-Transport-Server in einer Exchange 2007-Organisation durchlaufen.
Für jede Bedingung und Ausnahme ist ein unterstütztes Regelprädikat erforderlich. Jedes Prädikat besteht aus dem Prädikat selbst und dem Wert, der getestet werden soll.
Eine Liste der unterstützten Transportregelprädikate finden Sie unter Transportregelprädikate.
Für jede Aktion ist ein unterstütztes Regelprädikat erforderlich. Jede Aktion besteht aus der Aktion selbst und den Werten, welche die Aktion zum Ausführen ihrer Aufgabe verwendet.
Eine Liste unterstützter Transportregelaktionen finden Sie unter Aktionen von Transportregeln.
Ausführliche Anweisungen zum Erstellen einer neuen Transportregel finden Sie unter Erstellen einer neuen Transportregel.
Informationen zum Agent für Transportregeln finden Sie unter Übersicht über Transportregeln.
Damit Sie das Cmdlet New-TransportRule ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- die Rolle Exchange-Organisationsadministrator
Um das Cmdlet New-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 Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Aktionen |
Erforderlich |
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. |
Name |
Erforderlich |
System.String |
Verwenden Sie diesen Parameter, um den Anzeigenamen der zu erstellenden Transportregel anzugeben. Die Länge des Namens darf 64 Zeichen nicht überschreiten. |
Comments |
Optional |
System.String |
Mit diesem Parameter fügen Sie der Regel informative Kommentare hinzu, z. B. den Zweck der Regel oder die bisherigen Änderungen. Die Länge des Kommentars darf 1024 Zeichen nicht überschreiten. |
Bedingungen |
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. |
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). |
Enabled |
Optional |
System.Boolean |
Mit diesem Parameter können Sie bei der Erstellung der Transportregel angeben, ob diese aktiviert oder deaktiviert werden soll. Der Standardwert ist |
Ausnahmen |
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 eine Ausnahme erfüllt, wird keine für diese Regel angegebene Aktion auf die Nachricht angewendet. |
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. |
TemplateInstance |
Optional |
System.Management.Automation.PSObject |
Wenn ein vorhandenes Objekt an diesen Parameter übergeben wird, verwendet der Befehl die Konfiguration des Objekts zum Erstellen eines duplizierten Objekts auf einem lokalen oder Zielserver. |
Eingabetypen
Rückgabetypen
Fehler
| Fehler | Beschreibung |
|---|---|
|
|
Ausnahmen
| Ausnahmen | Beschreibung |
|---|---|
|
|
Beispiel
Das folgende Beispiel zeigt, wie eine neue Transportregel auf einem Hub-Transport-Server erstellt wird.
Für diese Regel gelten die folgenden Bedingungen:
- zwischen Verteilerliste und Verteilerliste Der erste Prädikatseigenschaftswert dieser Bedingung ist die Verteilergruppe "Sales Group". Der zweite Prädikateigenschaftswert für diese Bedingung ist die Verteilergruppe "Brokerage Group".
Die folgenden Ausnahmen gelten:
mit Textmustern im Betreff Der Wert für diese Ausnahme ist "Press Release" und "Corporate Communication".
von Benutzern Die Werte dieser Ausnahme sind die Benutzer Ted Bremer und Pilar Ackerman.
Die folgenden Aktionen werden auf Nachrichten angewendet, welche die zuvor genannten Bedingungen erfüllen, jedoch nicht mit den Ausnahmen "mit Textmustern im Betreff" oder "von Benutzern" übereinstimmen:
Unzustellbarkeitsnachricht an Absender senden Der Wert für diese Aktion lautet "E-mail messages sent between the Sales department and the Brokerage department are prohibited".
Ereignis mit Nachricht protokollieren Der Wert für diese Aktion lautet "A prohibited e-mail message has been rejected".
$Condition1 = Get-TransportRulePredicate BetweenMemberOf
$Condition1.Addresses = @((Get-DistributionGroup "Sales Group"))
$Condition1.Addresses2 = @((Get-DistributionGroup "Brokerage Group"))
$Exception1 = GetTransportRulePredicate From
$Exception1.Addresses = @((Get-MailUser "Ted Bremer"), (Get-MailUser "Pilar Ackerman"))
$Exception2 = Get-TransportRulePredicate SubjectContains
$Exception2.Words = @("Press Release", "Corporate Communication")
$Action1 = Get-TransportRuleAction RejectMessage
$Action1.RejectReason = "E-mail messages sent between the Sales department and the Brokerage department are prohibited."
$Action2 = Get-TransportRuleAction LogEvent
$Action2.EventMessage = "A prohibited e-mail message has been rejected."
New-TransportRule -name "Block e-mail messages between Sales and Brokerage groups" -Condition @($Condition1) -Exception @($Exception1, $Exception2) -Action @($Action1, $Action2)