CentralBinaryLogFile Class1

Define configurações para log binário centralizado em um servidor.

Sintaxe

class CentralBinaryLogFile : EmbeddedObject  

Métodos

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

Propriedades

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

Nome	Descrição
Directory	Um valor string de leitura/gravação que especifica o diretório no qual as entradas de log deverão ser gravadas. O padrão é "%SystemDrive%\inetpub\logs\LogFiles".
Enabled	Um valor boolean de leitura/gravação. true se o logon centralizado 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.
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 CentralBinaryLogFile da classe LogSection.

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 de arquivo de log como CentralBinary, habilita o log binário, define a propriedade Period como Weekly, especifica que os arquivos de log usam a hora local e limita o tamanho do log a 1 gigabyte. 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 CentralBinary.  
oSection.CentralLogFileMode = 1  
  
' Enable central binary logging.  
oSection.CentralBinaryLogFile.Enabled = True  
  
' Set local time rollover to true.  
oSection.CentralBinaryLogFile.LocalTimeRollover = True  
  
' Set the Period property to Weekly.  
oSection.CentralBinaryLogFile.Period = 2  
  
' Set the log truncate size to 1 gigabyte.  
oSection.CentralBinaryLogFile.TruncateSize = 1073741824  
  
' 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 binary log file properties.  
   Call ShowPropVals(oSection.CentralBinaryLogFile)  
  
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

CentralBinaryLogFile

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

Classe CentralW3CLogFile
Classe EmbeddedObject
Classe LogSection
SiteLogFile Class