CentralW3CLogFile Class1

Define configurações para fazer logon centralizado do W3C (World Wide Web Consortium) em um servidor.

Sintaxe

class CentralW3CLogFile : EmbeddedObject  

Métodos

Essa classe não contém métodos.

Propriedades

A tabela a seguir lista as propriedades expostas pela classe CentralW3CLogFile.

Nome	Descrição
Directory	Um valor string de leitura/gravação não vazio que especifica o diretório no qual as entradas de log devem ser gravadas. O padrão é "%SystemDrive%\inetpub\logs\LogFiles".
Enabled	Um valor boolean de leitura/gravação. true se o logon centralizado do W3C estiver habilitado, caso contrário, false. O padrão é true.
LocalTimeRollover	Um valor boolean de leitura/gravação. true se um novo arquivo de log for baseado na hora local, false se for baseado em UTC (Tempo Universal Coordenado). O padrão é false.
LogExtFileFlags	Um valor sint32 de leitura/gravação contendo uma máscara que especifica os atributos a serem registrados no arquivo de log. Os valores possíveis estão listados posteriormente na seção Comentários.
Period	Uma enumeração sint32 de leitura/gravação que especifica com que frequência o arquivo de log atual fechará e um novo arquivo de log iniciará. Os valores possíveis estão listados posteriormente na seção Comentários.
TruncateSize	Um valor string de leitura/gravação que especifica, em bytes, o tamanho no qual o conteúdo do arquivo de log deverá ser truncado. Este atributo deverá ser configurado quando Period estiver definido como MaxSize. O tamanho deverá estar entre 1048576 (1 megabyte) e 4294967295 (4 gigabytes). O padrão é 20971520 (20 megabytes).

Subclasses

Essa classe não contém subclasses.

Comentários

As instâncias dessa classe estão contidas na propriedade CentralW3CLogFile da classe LogSection.

A tabela a seguir lista os possíveis valores da propriedade LogExtFileFlags. Os atributos padrão são ClientIP, Date, HttpStatus, HttpSubStatus, Method, ServerIP, ServerPort, SiteName, Time, UriQuery, UriStem, UserAgent, UserName e Win32Status.

Valor	Atributo
1	Date
2	Time
4	ClientIP
8	UserName
16	SiteName
32	ComputerName
64	ServerIP
128	Method
256	UriStem
512	UriQuery
1024	HttpStatus
2.048	Win32Status
4096	BytesSent
8192	BytesRecv
16384	TimeTaken
32768	ServerPort
65536	UserAgent
131072	Cookie
262144	Referer
524288	ProtocolVersion
1048576	Host
2097152	HttpSubStatus

A tabela a seguir lista os possíveis valores da propriedade Period. O padrão é 1 (Daily).

Valor	Palavra-chave	Descrição
0	MaxSize	O arquivo de log fechará e um novo arquivo de log iniciará quando o valor em TruncateSize for alcançado.
1	Daily	O arquivo de log fechará e um novo arquivo de log iniciará uma vez por dia.
2	Weekly	O arquivo de log fechará e um novo arquivo de log iniciará uma vez por semana.
3	Monthly	O arquivo de log fechará e um novo arquivo de log iniciará uma vez por mês.
4	Hourly	O arquivo de log fechará e um novo arquivo de log iniciará uma vez por hora.

Exemplo

O exemplo de código a seguir define o modo do arquivo de log como CentralW3C, habilita o log centralW3C, define a propriedade Period como MaxSize, especifica que os arquivos de log usam a hora local e limita o tamanho do log a 100 megabytes. As funções auxiliares exibirão as configurações antes e após as alterações serem feitas.

' 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  
  

Hierarquia de herança

EmbeddedObject

CentralW3CLogFile

Requisitos

Tipo	Descrição
Cliente	– IIS 7.0 no Windows Vista – IIS 7.5 no Windows 7 – IIS 8.0 no Windows 8 – IIS 10.0 no Windows 10
Servidor	– IIS 7.0 no Windows Server 2008 – IIS 7.5 no Windows Server 2008 R2 – IIS 8.0 no Windows Server 2012 – IIS 8.5 no Windows Server 2012 R2 – IIS 10.0 no Windows Server 2016
Product	– IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Arquivo MOF	WebAdministration.mof

Confira também

CentralBinaryLogFile Class
Classe EmbeddedObject
Classe LogSection
SiteLogFile Class