Classe SiteLogFile1
Configura la registrazione per un sito Web.
Sintassi
class SiteLogFile : EmbeddedObject
Metodi
Questa classe non contiene metodi.
Proprietà
Nella tabella seguente sono elencate le proprietà esposte dalla SiteLogFile classe .
| Nome | Descrizione |
|---|---|
CustomLogPluginClsid |
Valore di lettura/scrittura string che specifica il GUID di un modulo plug-in usato per la registrazione personalizzata. Il valore predefinito è "FF160663-DE82-11CF-BC0A-00AA0611E0". |
Directory |
Valore di lettura/scrittura string non interrotto che specifica il nome della directory in cui vengono archiviati i file di log. Il valore predefinito è "%SystemDrive%\inetpub\logs\LogFiles". Nota: Se il gruppo di IIS_IUSRS non dispone dell'autorizzazione per la scrittura in questa directory, i log non verranno generati. Se si specifica una directory diversa dall'impostazione predefinita, assicurarsi che il gruppo IIS_IUSRS disponga dell'autorizzazione per la scrittura. |
Enabled |
Valore di lettura/scrittura boolean . true se la registrazione del sito è abilitata per un sito Web; in caso contrario, false. Il valore predefinito è true. |
LocalTimeRollover |
Valore di lettura/scrittura boolean . true se un nuovo file di log è basato sull'ora locale; false se si basa sull'ora UTC (Coordinated Universal Time). Il valore predefinito è false. |
LogExtFileFlags |
Valore di lettura/scrittura sint32 che contiene una maschera che specifica gli attributi da registrare nel file di log. Questa proprietà si applica solo alla registrazione del formato World Wide Web Consortium (W3C). I valori possibili sono elencati più avanti nella sezione Osservazioni. |
LogFormat |
Enumerazione di lettura/scrittura sint32 che specifica il formato del file di log. I valori possibili sono elencati più avanti nella sezione Osservazioni. |
Period |
Enumerazione di lettura/scrittura sint32 che specifica la frequenza di roll over del contenuto del file di log, ovvero il file di log corrente viene chiuso e viene avviato un nuovo file di log. I valori possibili sono elencati più avanti nella sezione Osservazioni. |
TruncateSize |
Valore di lettura/scrittura string che specifica le dimensioni, in byte, in cui il contenuto del file di log viene troncato. Per abilitare questa proprietà, impostare Period su MaxSize. Le dimensioni devono essere comprese tra 1048576 (1 megabyte) e 4294967295 (4 gigabyte). Il valore predefinito è 20971520 (20 megabyte). |
Sottoclassi
Questa classe non contiene sottoclassi.
Commenti
Le istanze di questa classe sono contenute nella LogFile proprietà delle Site classi e SiteElementDefaults .
Nella tabella seguente sono elencati i valori possibili per la LogExtFileFlags proprietà. Gli attributi predefiniti sono ClientIP, DateHttpSubStatusServerIPServerPortTimeMethodHttpStatusUriStemUserAgentUriQueryUserNamee .Win32Status
| Value | Attributo |
|---|---|
| 1 | Date |
| 2 | Time |
| 4 | ClientIP |
| 8 | UserName |
| 16 | SiteName |
| 32 | ComputerName |
| 64 | ServerIP |
| 128 | Method |
| 256 | UriStem |
| 512 | UriQuery |
| 1024 | HttpStatus |
| 2048 | Win32Status |
| 4096 | BytesSent |
| 8192 | BytesRecv |
| 16384 | TimeTaken |
| 32768 | ServerPort |
| 65536 | UserAgent |
| 131072 | Cookie |
| 262144 | Referer |
| 524288 | ProtocolVersion |
| 1048576 | Host |
| 2097152 | HttpSubStatus |
Nella tabella seguente sono elencati i valori possibili per la LogFormat proprietà. Il valore predefinito è 2 (W3C).
| Valore | Parola chiave | Descrizione |
|---|---|---|
| 0 | IIS |
Record di file di log in formato IIS. Questo formato è testo ASCII fisso e non è personalizzabile. |
| 1 | NCSA |
I record di file di log in National Center for Supercomputing Applications (NCSA) Formato di file di log comune. Questo formato è testo ASCII fisso e non è personalizzabile. |
| 2 | W3C |
Record di file di log in formato file di log esteso W3C. Questo formato è in testo ASCII ed è personalizzabile. |
| 3 | Custom |
Record di file di log in un formato personalizzato deciso dall'utente. |
Nella tabella seguente sono elencati i valori possibili per la Period proprietà. Il valore predefinito è 1 (Daily).
| Valore | Parola chiave | Descrizione |
|---|---|---|
| 0 | MaxSize |
Il file di log viene chiuso e viene avviato un nuovo file di log quando viene raggiunto il valore in TruncateSize . |
| 1 | Daily |
Il file di log viene chiuso e un nuovo file di log viene avviato una volta al giorno. |
| 2 | Weekly |
Il file di log viene chiuso e viene avviato un nuovo file di log una volta alla settimana. |
| 3 | Monthly |
Il file di log viene chiuso e viene avviato un nuovo file di log una volta al mese. |
| 4 | Hourly |
Il file di log viene chiuso e viene avviato un nuovo file di log una volta all'ora. |
Gerarchia di ereditarietà
SiteLogFile
Requisiti
| Tipo | Descrizione |
|---|---|
| Client | - IIS 7.0 in Windows Vista - IIS 7.5 in Windows 7 - IIS 8.0 in Windows 8 - IIS 10.0 in Windows 10 |
| Server | - IIS 7.0 in Windows Server 2008 - IIS 7.5 in Windows Server 2008 R2 - IIS 8.0 in Windows Server 2012 - IIS 8.5 in Windows Server 2012 R2 - IIS 10.0 in Windows Server 2016 |
| Prodotto | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| File MOF | WebAdministration.mof |
Vedere anche
Classe CentralBinaryLogFile
Classe CentralW3CLogFile
Classe EmbeddedObject
Classe LogSection
Classe site
Classe SiteElementDefaults
Formati di file di log in IIS