Install-TransportAgent (RTM)
Gilt für: Exchange Server 2007
Letztes Änderungsdatum des Themas: 2007-06-11
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> [-DomainController <Fqdn>]
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.
.gif "Caution") Achtung: |
|---|
| Transport-Agents haben Vollzugriff 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 Server 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 für die Transport-Agent-Factory an. Der Entwickler des Transport-Agents, der installiert wird, stellt die Transport-Agent-Factory sowie verwandte Informationen bereit. Weitere Informationen finden Sie in der vom Entwickler des Transport-Agents bereitgestellten Dokumentation. |
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
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"