Get-TransportAgent

 

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-TransportAgent, um die Konfiguration eines Transport-Agents auf einem Computer zu anzuzeigen, auf dem die Serverfunktion Edge-Transport oder Hub-Transportin einer Microsoft Exchange Server 2007-Organisation installiert ist.

Syntax

Get-TransportAgent [-Identity <String>] [-DomainController <Fqdn>]

Detaillierte Beschreibung

Das Cmdlet Get-TransportAgent wird verwendet, um die Konfiguration eines Transport-Agents auf einem Edge-Transport-Server oder einem Hub-Transport-Server anzuzeigen.

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

  • Exchange-Administrator mit Leserechten (Rolle)

Um das Cmdlet Get-TransportAgent 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

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

Um den vollqualifizierten Domänennamen (Fully Qualified Domain Name, FQDN) des Domänencontrollers anzugeben, der diese Konfigurationsänderung in den Active Directory-Verzeichnisdienst schreibt, 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 liest und schreibt nur in der lokalen ADAM-Instanz.

Identity

Optional

System.String

Dieser Parameter gibt den Anzeigenamen des anzuzeigenden Transport-Agents an. Die Länge des Namens darf 64 Zeichen nicht überschreiten.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

Ausnahmen

Ausnahmen Beschreibung

Beispiel

Im ersten Beispiel wird gezeigt, wie eine Zusammenfassungsliste aller Transport-Agents angezeigt wird, die auf einem Edge-Transport-Server oder einem Hub-Transport-Server installiert sind.

Im zweiten Beispiel wird gezeigt, wie Informationen zu einem bestimmten Transport-Agent im Listenformat angezeigt werden. Der Get-TransportAgent-Befehl wird an den Format-List-Befehl umgeleitet, um die Detailkonfiguration der angegebenen Transportregel anzuzeigen.

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-TransportAgent
Get-TransportAgent -Identity "Edge Rule Agent" | Format-List