Freigeben über


Uninstall-TransportAgent (RTM)

 

Gilt für: Exchange Server 2007

Letztes Änderungsdatum des Themas: 2007-06-11

Mit dem Cmdlet Uninstall-TransportAgent können Sie die Registrierung eines Transport-Agents aufheben, der nicht mehr auf einem Computer benötigt wird, auf dem die Serverfunktion Edge-Transport oder Hub-Transport in einer Microsoft Exchange Server 2007-Organisation installiert ist.

Syntax

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

Detaillierte Beschreibung

Mit dem Cmdlet Uninstall-TransportAgent können Sie die Registrierung eines Transport-Agents aufheben, der auf einem Edge-Transport- oder Hub-Transport-Server nicht mehr benötigt wird.

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

  • die Rolle Exchange-Serveradministrator und die Mitgliedschaft in der lokalen Gruppe Administratoren für den Zielserver

Um das Cmdlet Uninstall-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 Microsoft Exchange Server 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.

Parameter

Parameter Erforderlich Typ Beschreibung

Identity

Erforderlich

System.String

Mit diesem Parameter können Sie den Anzeigenamen des zu deinstallierenden Transport-Agents angeben. Die Länge des Namens darf 64 Zeichen nicht überschreiten.

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.

Eingabetypen

Rückgabetypen

Fehler

Fehler Beschreibung

 

Ausnahmen

Ausnahmen Beschreibung

 

Beispiel

Das folgende Beispiel zeigt, wie ein fiktives Virenschutzprogramm von einem Edge-Transport- oder Hub-Transport-Server deinstalliert wird.

Uninstall-TransportAgent -Identity "Antivirus for Exchange"