Agents-Konfigurationsdateielemente für Exchange 2013
Hier finden Sie Informationen zu den XML-Elementen in der agents.config- und fetagents.config-Konfigurationsdatei in Exchange 2013.
Gilt für: Exchange Server 2013
Wenn Sie die Clientzugriffs- oder Postfachserverrolle auf einem Exchange-Server installieren, erstellt das Installationsprogramm eine XML-Datei, die Konfigurationsinformationen zu agents enthält, die auf dem Server installiert sind. Sie können nicht direkt in diese Datei schreiben.
Der Front-End-Transportdienst wird auf Clientzugriffsservern ausgeführt und schreibt in eine Datei namens fetagents.config. Der Transportdienst und der Postfachtransportdienst werden auf Postfachservern ausgeführt und schreiben in eine Datei namens agents.config. Ein Computer, der sowohl über die Serverrolle Clientzugriff als auch über die Postfachserverrolle verfügt, verfügt sowohl über eine fetagents.config als auch über eine agents.config Datei.
Die einzige unterstützte Möglichkeit zum Schreiben in diese Dateien ist die Verwendung der Transport-Agent-Cmdlets in der Exchange-Verwaltungsshell. Informationen zu den Transport-Agent-Cmdlets finden Sie unter Nachrichtenfluss-Cmdlets auf TechNet.
Hinweis
Um zwischen Agents zu unterscheiden, die den Front-End-Transportdienst auf dem Clientzugriffsserver und den Transportdienst auf dem Postfachserver erweitern, verfügen Transport-Agent-Cmdlets über einen TransportService-Parameter mit dem Wert "Hub" für den Transportdienst und "FrontEnd" für den Front-End-Transportdienst.
Sie können die agents.config- oder fetagents.config-Datei lesen, um das Vorhandensein von - und -Konfigurationsinformationen für einen oder mehrere Agents auf dem Server zu ermitteln. Diese Dokumentation enthält einen Verweis, den Sie verwenden können, um die Informationen entweder in der agents.config-Datei oder in der fetagents.config zu lesen. Das Format für beide Dateien ist identisch. Diese Dokumentation enthält keine Informationen zum Schreiben in die Dateien.
Vorsicht
Die Verwendung nicht unterstützter Methoden zum Schreiben in die agents.config-Datei oder fetagents.config kann zu unerwarteten Ergebnissen führen, einschließlich eines Ausfalls des Transportdiensts oder der Transport-Agents oder beides. Schreiben Sie nicht direkt in eine dieser Dateien. Die einzige unterstützte Methode zum Schreiben in diese Dateien ist die Verwendung der Exchange-Verwaltungsshell-Transport-Agent-Cmdlets.
Speicherort der Konfigurationsdateien des Transport-Agents
Wenn Sie Exchange 2013 installieren, erstellt das Installationsprogramm eine XML-Datei mit dem Namen agents.config.template oder fetagents.config.template, je nach installierter Serverrolle, im <Ordner ExchangeInstallFolder>\TransportRoles\Agents (wobei <ExchangeInstallFolder> der Ordner ist, in dem Sie Exchange 2013 installiert haben). Wenn Sie die Clientzugriffsserverrolle installieren, kopiert Exchange 2013 die Datei fetagents.config.template in fetagents.config. Wenn Sie die Postfachserverrolle installieren, kopiert Exchange 2013 die Datei agents.config.template in agents.config. Exchange 2013 liest und schreibt diese Datei, wenn Sie die Konfiguration der Transport-Agents auf dem Server ändern.
Überprüfen einer Transport-Agent-Installation
Sie können die XML-Funktionen des .NET Framework verwenden, um die agents.config oder die fetagents.config XML-Datei zu lesen und zu überprüfen. Um die Installation und Konfiguration eines Transport-Agents zu überprüfen, lesen Sie den XML-Code in der Konfigurationsdatei, und suchen Sie das Agent-Element , das dem Transport-Agent entspricht. Wenn kein Agent-Element für den spezifischen Transport-Agent vorhanden ist, wird der Transport-Agent nicht installiert. Wenn der Transport-Agent installiert ist, können Sie die Attribute des Agent-Elements lesen, um dessen Konfiguration zu bestimmen.
Hierarchie der Konfigurationsdateielemente
Der folgende Code zeigt die Elementhierarchie in der XML-Konfigurationsdatei.
<configuration>
<mexRuntime>
<monitoring>
<agentExecution/>
<messageSnapshot/>
</monitoring>
<agentList>
<agent/>
<agent/>
<agent />
</agentList>
</mexRuntim>
</configuration>