CentralW3CLogFile (clase 1)

Configura las opciones para el registro centralizado de World Wide Web Consortium (W3C) en un servidor.

Sintaxis

class CentralW3CLogFile : EmbeddedObject  

Métodos

Esta clase no contiene métodos.

Propiedades

La siguiente tabla muestra las propiedades que expone la clase CentralW3CLogFile.

Nombre	Descripción
Directory	Un valor string de lectura y escritura no vacío que especifica el directorio en el que se deben escribir entradas de registro. El valor predeterminado es "%SystemDrive%\inetpub\logs\LogFiles".
Enabled	Valor boolean de lectura y escritura. true si está habilitado el registro centralizado de W3C; de lo contrario, false. El valor predeterminado es true.
LocalTimeRollover	Valor boolean de lectura y escritura. true si un nuevo archivo de registro se basa en la hora local; false si se basa en la hora universal coordinada (UTC). El valor predeterminado es false.
LogExtFileFlags	Valor de lectura y escritura sint32 que contiene una máscara que especifica los atributos que se van a registrar en el archivo de registro. Los valores posibles se enumeran más adelante en la sección Comentarios.
Period	Una enumeración sint32 de lectura y escritura que especifica la frecuencia con la que se cierra el archivo de registro actual y se inicia un nuevo archivo de registro. Los valores posibles se enumeran más adelante en la sección Comentarios.
TruncateSize	Un valor string de lectura y escritura que especifica, en bytes, el tamaño en el que se debe truncar el contenido del archivo de registro. Este atributo debe configurarse cuando Period se establece en MaxSize. El tamaño debe estar entre 1 048 576 (1 megabyte) y 4 294 967 295 (4 gigabytes). El valor predeterminado es 20 971 520 (20 megabytes).

Subclases

Esta clase no contiene subclases.

Comentarios

Las instancias de esta clase se encuentran en la propiedad CentralW3CLogFile de la clase LogSection.

En la siguiente tabla se describen los posibles valores de la propiedad LogExtFileFlags. Los atributos predeterminados son ClientIP, Date, HttpStatus, HttpSubStatus, Method, ServerIP, ServerPort, SiteName, Time, UriQuery, UriStem, UserAgent, UserName y Win32Status.

Valor	Attribute
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

En la siguiente tabla se describen los posibles valores de la propiedad Period. El valor predeterminado es 1 (Daily).

Valor	Palabra clave	Descripción
0	MaxSize	El archivo de registro se cierra y se inicia uno nuevo cuando se alcanza el valor TruncateSize.
1	Daily	El archivo de registro se cierra y se inicia uno nuevo una vez al día.
2	Weekly	El archivo de registro se cierra y se inicia uno nuevo una vez a la semana.
3	Monthly	El archivo de registro se cierra y se inicia uno nuevo una vez al mes.
4	Hourly	El archivo de registro se cierra y se inicia uno nuevo una vez a la hora.

Ejemplo

En el ejemplo de código siguiente se establece el modo de archivo de registro en CentralW3C, se habilita el registro centralW3C, se establece la propiedad Period en MaxSize, se especifica que los archivos de registro usan la hora local y limita el tamaño del registro a 100 megabytes. Las funciones auxiliares muestran la configuración antes y después de realizar los cambios.

' 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  
  

Jerarquía de herencia

EmbeddedObject

CentralW3CLogFile

Requisitos

Tipo	Descripción
Remoto	- IIS 7.0 en Windows Vista - IIS 7.5 en Windows 7 - IIS 8.0 en Windows 8 - IIS 10.0 en Windows 10
Server	- IIS 7.0 en Windows Server 2008 - IIS 7.5 en Windows Server 2008 R2 - IIS 8.0 en Windows Server 2012 - IIS 8.5 en Windows Server 2012 R2 - IIS 10.0 en Windows Server 2016
Producto	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Archivo MOF	WebAdministration.mof

Consulte también

Clase CentralBinaryLogFile
Clase EmbeddedObject
Clase LogSection
Clase SiteLogFile