Verwalten der Agent-Protokollausgabe

Artikel
09/29/2014

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

Letztes Änderungsdatum des Themas: 2007-08-22

In diesem Thema wird erläutert, wie Sie die Datei EdgeTransport.exe.config zum Verwalten der Protokolldateien des Antispam-Agents konfigurieren. Standardmäßig protokolliert Microsoft Exchange Server 2007 alle Aktivitäten des Antispam-Agents im Verzeichnis %programfiles%\Microsoft\Exchange Server\TransportRoles\Logs\AgentLog. Zum Filtern der Protokolle des Antispam-Agents verwenden Sie das Cmdlet Get-AgentLog. Weitere Informationen finden Sie unter Get-AgentLog.

Die Standardkonfiguration der Agent-Protokolldateien sieht folgendermaßen aus:

Maximalgröße des Agent-Protokollverzeichnisses: 250 MB
Maximalgröße für eine einzelne Agent-Protokolldatei: 10 MB
Höchstalter für Protokolldateien: 30 Tage

Wichtig

Exchange 2007 Service Pack 1 (SP1) enthält Schlüssel in der Anwendungskonfigurationsdatei EdgeTransport.exe.config, mit deren Hilfe Sie diese Standardwerte ändern können. Die RTM-Version (Release to Manufacturing) von Exchange 2007 kann die in diesem Thema beschriebenen Schlüssel nicht lesen.

Ändern der Datei "EdgeTransport.exe.config"

Jede Änderung von Konfigurationsoptionen zur Verwaltung der Agent-Protokollausgabe muss in der Datei EdgeTransport.exe.config vorgenommen werden, die sich im Verzeichnis %programfiles%\Microsoft\Exchange Server\Bin befindet. Die Datei EdgeTransport.exe.config ist eine XML-Anwendungskonfigurationsdatei, die der Datei EdgeTransport.exe zugeordnet ist. EdgeTransport.exe und MSExchangeTransport.exe sind die Programmdateien, die vom Microsoft Exchange-Transportdienst verwendet werden. Dieser Dienst wird auf jedem Hub-Transport-Server und Edge-Transport-Server ausgeführt. Änderungen, die in der Datei EdgeTransport.exe.config gespeichert werden, werden nach dem erneuten Starten des Microsoft Exchange-Transportdiensts angewendet. Der Standardwert wird durchgesetzt, wenn eine der folgenden Bedingungen zutrifft:

Eine Konfigurationsoption fehlt.
Eine Konfigurationsoption ist vorhanden und enthält den Standardwert.

Das folgende Beispiel zeigt die typische Struktur der Datei EdgeTransport.exe.config:

<configuration> 
<runtime> 
<gcServer enabled="true" /> 
</runtime> 
<appSettings> 
<add key=" Configuration Option " value=" Value " />

…

</appSettings> 
</configuration>

Sie können im Abschnitt <appSettings> neue Konfigurationsoptionen hinzufügen oder vorhandene Konfigurationsoptionen ändern. Viele der verfügbaren Konfigurationsoptionen beziehen sich nicht auf die Protokollausgabe des Agents. Diese Konfigurationsoptionen werden im vorliegenden Thema nicht behandelt.

Schlüssel für die Agent-Protokollausgabe

Die Agent-Protokollausgabe wird von den folgenden Schlüsseln in der Datei EdgeTransport.exe.config verwaltet:

<add key="AgentLogEnabled" value="system.boolean" />
<add key="AgentLogMaxDirectorySize" value="system.int32" />
<add key="AgentLogMaxFileSize" value="system.int32" />
<add key="AgentLogMaxAge" value="system.timespan" />

Standardmäßig enthält die Datei EdgeTransport.exe.config nur den Schlüssel AgentLogEnabled. Alle anderen Schlüssel müssen Sie hinzufügen. In der folgenden Tabelle werden die einzelnen Schlüssel ausführlicher beschrieben.

Schlüssel	Werttyp	Beschreibung
`AgentLogEnabled`	System.Boolean	Dieser Schlüssel ist standardmäßig in der Datei EdgeTransport.exe.config vorhanden. Gültige Werte für diesen Schlüssel sind `true` oder `false`. Der Standardwert ist `true`.
`AgentLogMaxDirectorySize`	System.Int32	Dieser Schlüssel ist in der Datei EdgeTransport.exe.config standardmäßig nicht vorhanden. Der Wert dieses Schlüssels gibt die maximale Größe des Verzeichnisses AgentLog in Byte an. Wird dieser Wert überschritten, wird die älteste Protokolldatei im Verzeichnis gelöscht und eine neue Protokolldatei erstellt. Wird dieser Schlüssel nicht festgelegt, beträgt der Standardwert in Exchange 2007 RTM und Exchange 2007 SP1 "250 MB", bzw. 262144000 Byte (25010241024).
`AgentLogMaxFileSize`	System.Int32	Dieser Schlüssel ist in der Datei EdgeTransport.exe.config standardmäßig nicht vorhanden. Der Wert dieses Schlüssels gibt die maximale Größe (in Byte) für jede einzelne Protokolldatei im Verzeichnis an. Wenn eine Protokolldatei die maximale Größe erreicht, wird eine neue Protokolldatei erstellt. Wird dieser Schlüssel nicht festgelegt, beträgt der Standardwert in Exchange 2007 RTM und Exchange 2007 SP1 "10 MB", bzw. 10485760 Byte (1010241024).
`AgentLogMaxAge`	System.TimeSpan	Dieser Schlüssel ist in der Datei EdgeTransport.exe.config standardmäßig nicht vorhanden. Der Wert dieses Schlüssels legt das Höchstalter für eine bestimmte Protokolldatei fest. Überschreitet eine Protokolldatei ihr Höchstalter, wird sie gelöscht. Der Schlüssel verfügt über den Systemtyp `TimeSpan.`. Der Wert dieses Schlüssels kann als Zeichenfolge im Format d.hh:mm:ss.ff angegeben werden, wobei d die Tage, hh die Stunden, mm die Minuten, ss die Sekunden und ff die Bruchteile einer Sekunde angibt. Wird dieser Schlüssel nicht festgelegt, beträgt der Standardwert in Exchange 2007 RTM und Exchange 2007 SP1 "30 Tage", bzw. `30.00:00:00.00`.

Bevor Sie beginnen

Damit Sie das nachstehende Verfahren ausführen können, muss Folgendes an das verwendete Konto delegiert worden sein:

Mitglied der lokalen Administratorgruppe auf dem Computer

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.

Verfahren

So können Sie die Schlüssel für die Agent-Protokollausgabe in der Datei "EdgeTransport.exe.config" hinzufügen und konfigurieren

Öffnen Sie auf dem Hub-Transport-Server oder dem Edge-Transport-Server, auf dem Sie die Agent-Protokollausgabe verwalten möchten, die Datei EdgeTransport.exe.config in einem ASCII-Texteditor, z. B. dem Windows-Editor. Die Datei EdgeTransport.exe.config befindet sich im Ordner %programfiles%\Microsoft\Exchange Server\Bin.
Suchen Sie den Schlüssel AgentLogEnabled. Standardmäßig sind die Schlüssel in alphabetischer Reihenfolge unter <appsettings> aufgelistet.

Kopieren Sie die folgenden Schlüssel, und fügen Sie sie unter dem Schlüssel AgentLogEnabled ein:

<add key="AgentLogMaxDirectorySize" value="system.int32" />
<add key="AgentLogMaxFileSize" value="system.int32" />
<add key="AgentLogMaxAge" value="system.timespan" />

Vergewissern Sie sich, das der Schlüssel AgentLogEnabled auf true festgelegt ist, und fügen Sie Werte für die anderen Schlüssel ein.
Nachdem Sie die Datei EdgeTransport.exe.config aktualisiert haben, speichern und schließen Sie sie.
Die Konfigurationsänderungen werden erst nach einem Neustart des Microsoft Exchange-Transportdiensts wirksam.

Weitere Informationen

Weitere Informationen finden Sie unter Get-AgentLog.