CentralBinaryLogFile Class1

为服务器上的集中式二进制日志记录配置设置。

语法

class CentralBinaryLogFile : EmbeddedObject  

方法

此类不包含任何方法。

属性

下表列出了 CentralBinaryLogFile 类公开的属性。

名称	描述
Directory	一个读/写 string 值，指定日志条目应写入的目录。 默认值为“%SystemDrive%\inetpub\logs\LogFiles”。
Enabled	一个读/写 boolean 值。 如果启用了集中式日志记录，则为 true，否则为 false。 默认为 true。
LocalTimeRollover	一个读/写 boolean 值。 如果新的日志文件基于本地时间，则为 true；如果基于协调世界时 (UTC)，则为 false。 默认为 false。
Period	一个读/写 sint32 枚举，指定关闭当前日志文件和启动新日志文件的频率。 后文的“注解”部分列出了可能的值。
TruncateSize	一个读/写 string 值，指定日志文件内容应截断的大小（以字节为单位）。 当 Period 设置为 MaxSize 时，必须配置此属性。 大小须介于 1048576 (1 MB) 和 4294967295 (4 GB) 之间。 默认值为 20971520 (20 MB)。

子类

此类不包含子类。

注解

此类的实例包含在 LogSection 类的 CentralBinaryLogFile 属性中。

下表列出了 Period 属性的可能值。 默认值为 1 (Daily)。

值	关键字	说明
0	MaxSize	达到 TruncateSize 中的值时，关闭日志文件并启动新的日志文件。
1	Daily	每天关闭日志文件并启动新的日志文件。
2	Weekly	每周关闭日志文件并启动新的日志文件。
3	Monthly	每月关闭日志文件并启动新的日志文件。
4	Hourly	每小时关闭日志文件并启动新的日志文件。

示例

以下代码示例将日志文件模式设置为 CentralBinary，启用二进制日志记录，将 Period 属性设置为 Weekly，指定日志文件使用当地时间，并将日志大小限制为 1 GB。 帮助程序函数显示更改前后的设置。

' 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  
  

继承层次结构

EmbeddedObject

CentralBinaryLogFile

要求

类型	描述
客户端	- IIS 7.0（在 Windows Vista 上） - IIS 7.5（在 Windows 7 上） - IIS 8.0（在 Windows 8 上） - IIS 10.0（在 Windows 10 上）
服务器	- IIS 7.0（在 Windows Server 2008 上） - IIS 7.5（在 Windows Server 2008 R2 上） - IIS 8.0（在 Windows Server 2012 上） - IIS 8.5（在 Windows Server 2012 R2 上） - IIS 10.0（在 Windows Server 2016 上）
产品	- IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0
MOF 文件	WebAdministration.mof

另请参阅

CentralW3CLogFile 类
EmbeddedObject 类
LogSection 类
SiteLogFile 类