Gestione dell'output del registro dell'agente

  • Articolo

 

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007

Ultima modifica dell'argomento: 2007-08-22

In questo argomento viene descritto come configurare il file EdgeTransport.exe.config per la gestione dei file di registro dell'agente protezione posta indesiderata. Per impostazione predefinita, Microsoft Exchange Server 2007 registra tutta l'attività dell'agente protezione posta indesiderata nella directory %programfiles%\Microsoft\Exchange Server\TransportRoles\Logs\AgentLog. Per filtrare i registri dell'agente protezione posta indesiderata, utilizzare il cmdlet Get-AgentLog. Per ulteriori informazioni, vedere Get-AgentLog.

La configurazione predefinita dei file di registro dell'agente è la seguente:

  • Dimensione massima della directory dei registri dell'agente: 250 MB

  • Dimensione massima di un singolo file di registro dell'agente: 10 MB

  • Limite massimo di durata dei file di registro: 30 giorni

Importante

Exchange 2007 Service Pack 1 (SP1) include le chiavi presenti nel file di configurazione dell'applicazione EdgeTransport.exe.config che consentono di modificare questi valori predefiniti. La versione di produzione (RTM, Release To Manufacturing) di Exchange 2007 non legge le chiavi descritte in questo argomento.

Modifica del file EdgeTransport.exe.config

Tutte le modifiche alle opzioni di configurazione per la gestione dell'output del registro dell'agente devono essere eseguite nel file EdgeTransport.exe.config che si trova nella directory %programfiles%\Microsoft\Exchange Server\Bin. Il file EdgeTransport.exe.config è un file di configurazione dell'applicazione XML associato al file EdgeTransport.exe. EdgeTransport.exe e MSExchangeTransport.exe sono i file eseguibili che vengono utilizzati dal servizio di trasporto di Microsoft Exchange. Questo servizio viene eseguito su ogni server Trasporto Hub o Trasporto Edge. Le modifiche salvate nel file EdgeTransport.exe.config vengono applicate dopo che è stato riavviato il servizio di trasporto di Microsoft Exchange. Il valore predefinito viene applicato se si verifica una delle seguenti condizioni:

  • Manca un'opzione di configurazione.

  • È presente un'opzione di configurazione che contiene il valore predefinito.

Di seguito è riportato un esempio della struttura tipica del file EdgeTransport.exe.config:

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

…

</appSettings> 
</configuration>

È possibile aggiungere nuove opzioni di configurazione o modificare le opzioni di configurazione esistenti dalla sezione <appSettings>. Molte delle opzioni di configurazione disponibili non sono collegate all'output del registro dell'agente. Le opzioni di configurazione che non sono collegate all'output del registro dell'agente non rientrano nell'ambito di questo argomento.

Chiavi di output del registro dell'agente

L'output del registro dell'agente viene gestito dalle seguenti chiavi nel file EdgeTransport.exe.config:

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

Per impostazione predefinita, solo la chiave AgentLogEnabled è presente nel file EdgeTransport.exe.config. È necessario aggiungere tutte le altre chiavi. Nella seguente tabella viene illustrata dettagliatamente ciascuna chiave.

Chiave Tipo di valore Descrizione

AgentLogEnabled

System.Boolean

Per impostazione predefinita, questa chiave esiste nel file EdgeTransport.exe.config. I valori validi per questa chiave sono true o false. Il valore predefinito è true.

AgentLogMaxDirectorySize

System.Int32

Per impostazione predefinita, questa chiave non esiste nel file EdgeTransport.exe.config. Il valore di questa chiave specifica la dimensione massima, espressa in byte, della directory AgentLog. Quando questo valore viene superato, viene eliminato il file di registro meno recente presente nella directory e viene creato un nuovo file di registro.

Se questa chiave non viene specificata, il valore predefinito è 250 MB, ovvero 262144000 byte (250*1024*1024) in Exchange 2007 RTM e Exchange 2007 SP1.

AgentLogMaxFileSize

System.Int32

Per impostazione predefinita, questa chiave non esiste nel file EdgeTransport.exe.config. Il valore di questa chiave specifica la dimensione massima, espressa in byte, di ciascun file di registro presente nella directory. Quando un file di registro raggiunge la dimensione specificata, ne viene creato uno nuovo.

Se questa chiave non viene specificata, il valore predefinito è 10 MB, ovvero 10485760 byte (10*1024*1024) in Exchange 2007 RTM e Exchange 2007 SP1.

AgentLogMaxAge

System.TimeSpan

Per impostazione predefinita, questa chiave non esiste nel file EdgeTransport.exe.config. Il valore di questa chiave specifica il limite massimo di durata di un determinato file di registro. Quando un file di registro supera il periodo di validità, viene eliminato.

Questa chiave è di tipo di sistema TimeSpan. Il valore di questa chiave può essere rappresentato come una stringa in formato g.hh:mm:ss.ff dove g rappresenta i giorni, hh le ore, mm i minuti, ss i secondi e ff le frazioni di secondo.

Se questa chiave non viene specificata, il valore predefinito è 30 giorni, ovvero 30.00:00:00.00 in Exchange 2007 RTM and Exchange 2007 SP1.

Informazioni preliminari

Per eseguire questa procedura, è necessario utilizzare un account che disponga della seguente delega:

  • Membro del gruppo Administrators locale del computer

Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Exchange 2007, vedere Considerazioni sulle autorizzazioni.

Procedura

Per aggiungere e configurare le chiavi di output del registro dell'agente nel file EdgeTransport.exe.config

  1. Sul server Trasporto Hub o Trasporto Edge in cui si desidera gestire l'output del registro dell'agente, aprire il file EdgeTransport.exe.config in un editor di testo ASCII quale Blocco note. Il file EdgeTransport.exe.config si trova nella directory %programfiles%\Microsoft\Exchange Server\Bin.

  2. Individuare la chiave AgentLogEnabled. Per impostazione predefinita, le chiavi sono elencate in ordine alfabetico sotto <appsettings>.

  3. Copiare e incollare le chiavi seguenti sotto la chiave AgentLogEnabled:

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

  4. Verificare che la chiave AgentLogEnabled sia impostata su true e aggiungere i valori per le altre chiavi.

  5. Una volta terminato l'aggiornamento del file EdgeTransport.exe.config, salvare il file e chiuderlo.

  6. Per rendere effettive le modifiche alla configurazione è necessario riavviare il servizio di trasporto di Microsoft Exchange.

Ulteriori informazioni

Per ulteriori informazioni, vedere Get-AgentLog.