Install-TransportAgent
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.
.gif "Caution") 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. |
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 unterstützt, auf denen die Serverfunktion Edge-Transport ausgefü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"