Classe CentralW3CLogFile1

Articolo
07/19/2023

Configura le impostazioni per la registrazione centralizzata di World Wide Web Consortium (W3C) in un server.

Sintassi

class CentralW3CLogFile : EmbeddedObject

Metodi

Questa classe non contiene metodi.

Proprietà

Nella tabella seguente sono elencate le proprietà esposte dalla CentralW3CLogFile classe .

Nome	Descrizione
`Directory`	Valore di lettura/scrittura `string` nonempty che specifica la directory in cui devono essere scritte le voci di log. Il valore predefinito è "%SystemDrive%\inetpub\logs\LogFiles".
`Enabled`	Valore di lettura/scrittura `boolean` . `true` se la registrazione centralizzata W3C è abilitata; 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. I valori possibili sono elencati più avanti nella sezione Osservazioni.
`Period`	Enumerazione di lettura/scrittura `sint32` che specifica la frequenza di chiusura del file di log corrente e l'avvio di un nuovo file di log. I valori possibili sono elencati più avanti nella sezione Osservazioni.
`TruncateSize`	Valore di lettura/scrittura `string` che specifica, in byte, le dimensioni in cui il contenuto del file di log deve essere troncato. Questo attributo deve essere configurato quando `Period` è impostato 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 CentralW3CLogFile proprietà della classe LogSection .

Nella tabella seguente sono elencati i valori possibili per la LogExtFileFlags proprietà . Gli attributi predefiniti sono ClientIP, Date, HttpStatusHttpSubStatus, Method, , ServerIP, ServerPort, SiteNameTime, UserAgentUserNameUriQueryUriSteme .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 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 viene avviato un nuovo file di log 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.

Esempio

L'esempio di codice seguente imposta la modalità file di log su CentralW3C, abilita la registrazione centralW3C, imposta la Period proprietà su MaxSize, specifica che i file di log usano l'ora locale e limitano le dimensioni del log a 100 megabyte. Le funzioni helper visualizzano le impostazioni prima e dopo le modifiche apportate.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the log configuration section.  
Set oSection = oWebAdmin.Get("LogSection.Path=" & _  
   "'MACHINE/WEBROOT/APPHOST',Location=''")  
  
' Show the initial settings.  
DisplaySettings("Initial Values")  
  
' Set the log file mode to CentralW3C.  
oSection.CentralLogFileMode = 2  
  
' Enable central W3C logging.  
oSection.CentralW3CLogFile.Enabled = True  
  
' Set local time rollover to true.  
oSection.CentralW3CLogFile.LocalTimeRollover = True  
  
' Set the Period property to MaxSize.  
oSection.CentralW3CLogFile.Period = 0  
  
' Set the log truncate size to 100 megabytes.  
oSection.CentralW3CLogFile.TruncateSize = 104857600  
  
' Save the values to configuration.  
oSection.Put_  
  
' Refresh the oSection object variable with the new values.  
oSection.Refresh_  
  
' Show the changed settings.  
Call DisplaySettings("New Values")  
  
' ==== This section contains helper functions. ====  
Function DisplaySettings(HeadingText)  
   WScript.Echo String(Len(HeadingText), "=")  
   WScript.Echo HeadingText  
   WScript.Echo String(Len(HeadingText), "=")  
  
   ' Display the current central log file mode.  
   WScript.Echo "CentralLogFileMode: " & _  
      oSection.CentralLogFileMode  
  
   ' Display the current W3C log file properties.  
   Call ShowPropVals(oSection.CentralW3CLogFile)  
  
End Function  
  
' Display the property values.  
Function ShowPropVals(oObject)  
  
   For Each Prop In oObject.Properties_  
      WScript.Echo Prop.Name & ": " & Prop.Value  
   Next  
  
   WScript.Echo  
  
End Function

Gerarchia di ereditarietà

EmbeddedObject

CentralW3CLogFile

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 EmbeddedObject
Classe LogSection
Classe SiteLogFile

Condividi tramite