Install-TransportAgent

Artikel
09/29/2014

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

Letztes Änderungsdatum des Themas: 2007-07-27

Verwenden Sie das Cmdlet Install-TransportAgent, um einen Transport-Agent auf einem Computer zu registrieren, auf dem die Serverfunktion Edge-Transport oder Hub-Transport in einer Microsoft Exchange Server 2007-Organisation installiert ist.

Syntax

Install-TransportAgent -Name <String> -AssemblyPath <String> -TransportAgentFactory <String> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]

Detaillierte Beschreibung

Das Cmdlet Install-TransportAgent wird verwendet, um einen Transport-Agent für die Verwendung auf einem Edge-Transport- oder Hub-Transport-Server zu registrieren.

Achtung:
Transport-Agents haben vollen Zugriff auf alle gefundenen E-Mail-Nachrichten. Exchange schränkt das Verhalten eines Transport-Agents nicht ein. Transport-Agents, die instabil sind oder Sicherheitsfehler enthalten, können die Stabilität und Sicherheit von Exchange beeinträchtigen. Aus diesem Grund dürfen Sie nur Transport-Agents installieren, die uneingeschränkt vertrauenswürdig sind und vollständig in einer Testumgebung getestet wurden.

Transport-Agents haben vollen Zugriff auf alle gefundenen E-Mail-Nachrichten. Exchange schränkt das Verhalten eines Transport-Agents nicht ein. Transport-Agents, die instabil sind oder Sicherheitsfehler enthalten, können die Stabilität und Sicherheit von Exchange beeinträchtigen. Aus diesem Grund dürfen Sie nur Transport-Agents installieren, die uneingeschränkt vertrauenswürdig sind und vollständig in einer Testumgebung getestet wurden.

Damit Sie das Cmdlet Install-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 Install-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 2007 erforderlich sind, finden Sie unter Überlegungen zu Berechtigungen.

Parameter

Parameter	Erforderlich	Typ	Beschreibung
AssemblyPath	Erforderlich	System.String	Dieser Parameter gibt den Speicherort der Microsoft .NET-Assembly für den Transport-Agent an. UNC-Dateipfade (Universal Naming Convention) können nicht verwendet werden.
Name	Erforderlich	System.String	Dieser Parameter gibt den Anzeigenamen des zu installierenden Transport-Agents an. Die Länge des Namens darf 64 Zeichen nicht überschreiten.
TransportAgentFactory	Erforderlich	System.String	Dieser Parameter gibt den Microsoft .NET-Klassentyp der Transport-Agent-Factory an. Der Entwickler des Transport-Agents, der installiert wird, stellt die Transport-Agent-Factory und die zugehörigen Informationen zur Verfügung. Weitere Informationen finden Sie in der vom Entwickler des Transport-Agents bereitgestellten Dokumentation.
Confirm	Optional	System.Management.Automation.SwitchParameter	Der Parameter Confirm bewirkt eine Unterbrechung der Befehlsausführung und zwingt Sie, die Aktion des Befehls zu bestätigen, bevor die Verarbeitung fortgesetzt wird. Für den Parameter Confirm 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 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 unterstützt, auf denen die Serverfunktion Edge-Transport ausgeführt wird. Die Serverfunktion Edge-Transport liest und schreibt nur in der lokalen ADAM-Instanz.
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 Parameters WhatIf können Sie eine Vorschau der Änderungen anzeigen, ohne diese Änderungen wirklich übernehmen zu müssen. Für den Parameter WhatIf muss kein Wert angegeben werden.

Eingabetypen

Rückgabetypen

Fehler

Fehler	Beschreibung

Ausnahmen

Ausnahmen	Beschreibung

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie eine fiktive Antivirusanwendung auf einem Edge-Transport-Server oder einem Hub-Transport-Server installiert wird.

Install-TransportAgent -Name "Antivirus for Exchange" -TransportAgentFactory "vendor.exchange.avTransportAgentfactory" -AssemblyPath "c:\Program Files\Vendor\TransportAgent\AvTransportAgentFactory.dll"

Freigeben über