New-TransportRule
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2007-08-13
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[]>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-Exceptions <TransportRulePredicate[]>] [-Priority <Int32>] [-TemplateInstance <PSObject>] [-WhatIf [<SwitchParameter>]]
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 unterstützter 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 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.
Parameter
| Parameter | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
Actions |
Erforderlich |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRuleAction[] |
Mit diesem Parameter geben Sie die Aktionen an, welche die Transportregel auf die E-Mail-Nachricht anwendet, wenn alle Bedingungen und keine Ausnahmen erfüllt sind. Pro Regel muss mindestens eine Aktion angegeben werden. |
Name |
Erforderlich |
System.String |
Mit diesem Parameter können Sie den Anzeigenamen der zu erstellenden Transportregel angeben. 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. |
Conditions |
Optional |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRulePredicate[] |
Mit diesem Parameter geben Sie die Bedingungen an, welche die Transportregel auf E-Mail-Nachrichten anwendet, die an den Agent für Transportregeln übermittelt werden. Wenn Sie für eine Regel keine Bedingung konfigurieren, gilt die Regel für alle Nachrichten, sollten keine Ausnahmen erfüllt sein. |
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). |
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 |
Exceptions |
Optional |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.TransportRulePredicate[] |
Mit diesem Parameter können Sie die Ausnahmen angeben, welche die Transportregel auf die E-Mail-Nachricht anwendet. Wenn eine Nachricht eine Ausnahme erfüllt, wird keine für diese Regel angegebene Aktion auf die Nachricht angewendet. |
Priority |
Optional |
System.Int32 |
Mit diesem Parameter können Sie die Reihenfolge angeben, in der Transportregeln angewendet werden. Wenn Sie die Priorität der Regel ändern, wird die Position der Regel in der Regeliste entsprechend geändert, und der Agent für Transportregeln versieht alle Regeln mit einem höheren Prioritätswert. Regeln mit einem niedrigeren Prioritätswert werden zuerst verarbeitet. Der Wert dieses Parameters muss größer 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 einer identischen Kopie des Objekts auf einem lokalen oder Zielserver. Weitere Informationen finden Sie unter Vorlagen. |
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 Beispiel veranschaulicht das Erstellen einer neuen Transportregel auf einem Hub-Transport-Server.
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ädikatseigenschaftswert dieser Bedingung ist die Verteilergruppe "Brokerage Group".
Die folgenden Ausnahmen gelten:
mit Textmustern im Betreff Der Wert dieser Ausnahme ist "Press Release" oder "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)