Remove-TransportRule
Gilt für: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Letztes Änderungsdatum des Themas: 2007-07-27
Mit dem Cmdlet Remove-TransportRule können Sie eine Transportregel aus dem Transportregel-Agent auf einem Computer entfernen, auf dem die Serverfunktion Edge-Transport oder Hub-Transport in einer Microsoft Exchange Server 2007-Organisation installiert ist.
Syntax
Remove-TransportRule -Identity <RuleIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
Detaillierte Beschreibung
Mit dem Cmdlet Remove-TransportRule können Sie eine nicht mehr erforderliche Transportregel entfernen.
Informationen zum Agent für Transportregeln finden Sie unter Übersicht über Transportregeln.
Damit Sie das Cmdlet Remove-TransportRule ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:
- die Rolle Exchange-Organisationsadministrator
Um das Cmdlet Remove-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 |
|---|---|---|---|
Identity |
Erforderlich |
Microsoft.Exchange.MessagingPolicies.Rules.Tasks.RuleIdParameter |
Dieser Parameter gibt die zu entfernende Transportregel an. Geben Sie die GUID oder den Namen (im Parameter Name) der Regel ein. Sie können die Parameterbeschriftung Identity weglassen. |
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 Beispiel zeigt die Syntax des Befehls Remove-TransportRule zum Entfernen einer einzelnen Transportregel. Der Parameter WhatIf dient zum Anzeigen der vorzunehmenden Änderungen, ohne diese zu speichern. Wenn der Parameter WhatIf entfernt und der Befehl erneut ausgeführt wird, erfolgt die Entfernung der Transportregel.
Remove-TransportRule "Redirect messages to kim@contoso.com to legal@contoso.com" -WhatIf