Get-TransportRule

  • Artikel

 

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

Letztes Änderungsdatum des Themas: 2007-06-28

Verwenden Sie das Cmdlet Get-TransportRule, um Transportregeln anzuzeigen, die auf einem Computer konfiguriert sind, auf dem die Microsoft Exchange Server 2007-Serverfunktion Hub-Transport oder Edge-Transport installiert ist.

Syntax

Get-TransportRule [-Identity <RuleIdParameter>] [-DomainController <Fqdn>] [-State <Enabled | Disabled>]

Detaillierte Beschreibung

Mithilfe des Cmdlets Get-TransportRule können Sie die Konfiguration der auf einem Hub-Transport- oder Edge-Transport-Server definierten Transportregeln anzeigen. Wenn dieser Befehl auf einem Hub-Transport-Server ausgeführt wird, werden alle in der Organisation konfigurierten Transportregeln, mit Ausnahme der auf einem Edge-Transport-Server konfigurierten Regeln, angezeigt. Wenn dieser Befehl auf einem Edge-Transport-Server ausgeführt wird, werden nur die auf dem lokalen Edge-Transport-Server konfigurierten Regeln angezeigt.

Informationen über das Konfigurieren von Transportregeln, die für E-Mail-Nachrichten in einer Exchange 2007-Organisation ausgeführt werden, finden Sie unter Set-TransportRule.

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

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

  • Exchange-Administratoren mit Leserechten (Rolle)

Zum Ausführen des Cmdlets Get-TransportRule auf einem Computer, 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

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

Identity

Optional

Microsoft.Exchange.MessagingPolicies.Rules.Tasks.RuleIdParameter

Verwenden Sie diesen Parameter, um die anzuzeigende Transportregel anzuzeigen. Geben Sie die GUID oder den Namen der Regel ein. Sie können die Parameterbeschriftung Identity weglassen.

State

Optional

Microsoft.Exchange.MessagingPolicies.Rules.RuleState

Verwenden Sie diesen Parameter, um die Ergebnisse des Befehls Get-TransportRule zu filtern. Die folgenden Werte sind für diesen Parameter gültig:

  • Enabled   Weist den Befehl an, nur die Regeln zurückzugeben, die aktiviert sind und auf E-Mail-Nachrichten angewendet werden, wenn die Bedingungen erfüllt sind.

  • Disabled   Weist den Befehl an, nur die Regeln zurückzugeben, die deaktiviert sind und nicht auf E-Mail-Nachrichten angewendet werden.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

 

Ausnahmen

Ausnahmen Beschreibung

 

 

Beispiel

Das folgende Codebeispiel zeigt die Syntax für den Befehl Get-TransportRule. Das erste Beispiel gibt nur die Regel zurück, die dem Namen "Block e-mail messages between Sales and Brokerage Groups" entspricht. Der Befehl wird an den Format-List-Befehl umgeleitet, um die Detailkonfiguration der angegebenen Transportregel anzuzeigen.

Das zweite Beispiel gibt eine Zusammenfassungsliste aller Transportregeln zurück, die in einer Exchange-Organisation konfiguriert sind, wenn der Befehl auf einem Hub-Transport-Server ausgeführt wird, oder die Regeln, die auf dem lokalen Computer konfiguriert sind, wenn der Befehl auf einem Edge-Transport-Server ausgeführt wird.

Weitere Informationen zum Pipelining finden Sie unter Pipelining.

Weitere Informationen zum Arbeiten mit der Ausgabe einer Befehls finden Sie unter Arbeiten mit Ausgaben von Befehlen.

Get-TransportRule "Block e-mail messages between Sales and Brokerage Groups" | Format-List
Get-TransportRule