Verwalten von Transport-Agents in Exchange Server

  • Artikel

Transport-Agents verwenden SMTP-Ereignisse, um Nachrichten zu bearbeiten, während die Nachrichten die Transportpipeline durchlaufen. Die meisten integrierten Transport-Agents, die in Microsoft Exchange Server 2016 oder 2019 enthalten sind, sind unsichtbar und unüberschaubar. Sie können in Ihrer Organisation jedoch Transport-Agents von Drittanbietern auf Exchange-Servern installieren und konfigurieren. Weitere Informationen zu Transport-Agents finden Sie unter Transport-Agents in Exchange Server.

Was sollten Sie wissen, bevor Sie beginnen?

  • Geschätzte Zeit bis zum Abschließen der einzelnen Verfahren: 10 Minuten

  • Bevor Sie diese Verfahren ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Informationen zu den von Ihnen benötigten Berechtigungen finden Sie unter "Transport-Agents" im Thema Berechtigungen für den Nachrichtenfluss.

  • Die Exchange-Verwaltungsshell kann nur für diesen Vorgang verwendet werden.

  • Informationen zu Tastenkombinationen für die Verfahren in diesem Thema finden Sie unter Tastenkombinationen in der Exchange-Verwaltungskonsole.

Tipp

Liegt ein Problem vor? Bitten Sie in den Exchange-Foren um Hilfe. Besuchen Sie die Foren auf: Exchange Server.

Verwenden der Exchange-Verwaltungsshell zum Installieren eines Transport-Agents

Wenn Sie einen Transport-Agent installieren, registriert Exchange nur die DLLs, die dem Transport-Agent zugeordnet sind. Sie müssen sicherstellen, dass alle Dateien, Registrierungsschlüssel und anderen Objekte, von denen der Transport-Agent abhängig ist, ordnungsgemäß installiert und konfiguriert sind. Nachdem Exchange die DLLs geladen hat, wird nach Abschluss der Ausführung des Befehls weiterhin auf die DLLs verwiesen.

Transport-Agents haben Vollzugriff auf alle gefundenen E-Mails. 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 werden in deaktiviertem Zustand installiert, um sicherzustellen, dass der Nachrichtenfluss von noch nicht konfigurierten Transport-Agents unbeeinträchtigt bleibt. Sie müssen daher den Transport-Agent aktivieren, nachdem er ordnungsgemäß konfiguriert wurde.

Verwenden Sie die folgende Syntax, um einen Transport-Agent zu installieren.

Install-TransportAgent -Name <TransportAgentIdentity> -TransportAgentFactory <"TransportAgentFactory"> -AssemblyPath <"FilePath">

In diesem Beispiel wird ein fiktiver Transport-Agent namens Contoso Transport Agent im Transportdienst installiert.

Install-TransportAgent -Name "Contoso Transport Agent" -TransportAgentFactory "vendor.exchange.ContosoTransportAgentfactory" -AssemblyPath "C:\Program Files\Vendor\TransportAgent\ContosoTransportAgentFactory.dll"

Woher wissen Sie, dass dieses Verfahren erfolgreich war?

Um zu überprüfen, ob Sie den Transport-Agent erfolgreich installiert haben, führen Sie den Befehl aus Get-TransportAgent , und vergewissern Sie sich, dass der Transport-Agent aufgeführt ist.

Verwenden der Exchange-Verwaltungsshell zum Aktivieren eines Transport-Agents

Verwenden Sie die folgende Syntax, um einen Transport-Agent zu aktivieren.

Enable-TransportAgent <TransportAgentIdentity>

In diesem Beispiel wird der Transport-Agent mit dem Namen Contoso Transport Agent im Transportdienst aktiviert.

Enable-TransportAgent "Contoso Transport Agent"

Woher wissen Sie, dass dieses Verfahren erfolgreich war?

Um zu überprüfen, ob Sie einen Transport-Agent erfolgreich aktiviert haben, führen Sie den Befehl aus Get-TransportAgent | Format-List Name,Enabled , und vergewissern Sie sich, dass der Transport-Agent aktiviert ist.

Verwenden der Exchange-Verwaltungsshell zum Deaktivieren eines Transport-Agents

Verwenden Sie die folgende Syntax, um einen Transport-Agent zu deaktivieren:

Disable-TransportAgent <TransportAgentIdentity>

In diesem Beispiel wird der Transport-Agent mit dem Namen Fabrikam-Transport-Agent im Transportdienst deaktiviert.

Disable-TransportAgent "Fabrikam Transport Agent"

Woher wissen Sie, dass dieses Verfahren erfolgreich war?

Um zu überprüfen, ob Sie einen Transport-Agent erfolgreich deaktiviert haben, führen Sie den Befehl aus Get-TransportAgent | Format-List Name,Enabled , und vergewissern Sie sich, dass der Transport-Agent deaktiviert ist.

Verwenden der Exchange-Verwaltungsshell zum Anzeigen von Transport-Agents

Führen Sie zum Anzeigen einer Übersichtsliste aller Transport-Agents den folgenden Befehl aus:

Get-TransportAgent

Führen Sie zum Anzeigen der ausführlichen Konfiguration eines bestimmten Transport-Agents den folgenden Befehl aus:

Get-TransportAgent <TransportAgentIdentity> | Format-List

In diesem Beispiel wird eine ausführliche Konfiguration des Transport-Agents mit dem Namen Transportregel-Agent bereitgestellt.

Get-TransportAgent "Transport Rule Agent" | Format-List

Verwenden der Exchange-Verwaltungsshell zum Konfigurieren der Priorität eines Transport-Agents

Transport-Agents mit einer Priorität, die 0 am nächsten ist, verarbeiten E-Mails zuerst. Das SMTP-Ereignis in der Transportpipeline, in der der Transport-Agent registriert ist, kann dazu führen, dass ein Agent mit niedrigerer Priorität die Nachricht bearbeitet, bevor ein Agent mit höherer Priorität die Möglichkeit dazu erhält.

Führen Sie den folgenden Befehl aus, um die Priorität eines vorhandenen Transport-Agents zu ändern:

Set-TransportAgent <TransportAgentIdentity> -Priority <Integer>

In diesem Beispiel wird der Prioritäts-Agent-Wert 3 für den vorhandenen Transport-Agent mit dem Namen Contoso Transport Agent im Transportdienst festgelegt.

Set-TransportAgent "Contoso Transport Agent" -Priority 3

Woher wissen Sie, dass dieses Verfahren erfolgreich war?

Um zu überprüfen, ob Sie die Priorität eines Transport-Agents erfolgreich konfiguriert haben, führen Sie den Befehl aus Get-TransportAgent | Format-List Name,Priority , und bestätigen Sie den Prioritätswert des Transport-Agents.

Verwenden der Exchange-Verwaltungsshell zum Deinstallieren eines Transport-Agents

Wenn der Transport-Agent deinstalliert wird, hebt Exchange die Registrierung der mit dem Agent verwendeten DLL-Dateien auf. Exchange entfernt keine Dateien, Registrierungsschlüssel oder anderen Objekte, die durch die Installation des Transport-Agents hinzugefügt wurden.

Führen Sie den folgenden Befehl aus, um einen Transport-Agent zu deinstallieren:

Uninstall-TransportAgent <TransportAgentIdentity>

In diesem Beispiel wird der Transport-Agent mit dem Namen Fabrikam Transport Agent aus dem Transportdienst deinstalliert.

Uninstall-TransportAgent "Fabrikam Transport Agent"

Woher wissen Sie, dass dieses Verfahren erfolgreich war?

Um zu überprüfen, ob Sie den Transport-Agent erfolgreich deinstalliert haben, führen Sie den Befehl aus Get-TransportAgent , und vergewissern Sie sich, dass der Transport-Agent nicht aufgeführt ist.