CentralW3CLogFile 类 1
为服务器上的万维网联盟 (W3C) 集中式日志记录配置设置。
语法
class CentralW3CLogFile : EmbeddedObject
方法
此类不包含任何方法。
属性
下表列出了 CentralW3CLogFile
类公开的属性。
名称 | 描述 |
---|---|
Directory |
一个非空读/写 string 值,用于指定日志条目应写入的目录。 默认为“%SystemDrive%\inetpub\logs\LogFiles”。 |
Enabled |
一个读/写 boolean 值。 启用了 W3C 集中式日志记录时,为 true ,否则为 false 。 默认为 true 。 |
LocalTimeRollover |
一个读/写 boolean 值。 新的日志文件基于当地时间时,为 true ;基于协调世界时 (UTC) 时,则为 false 。 默认为 false 。 |
LogExtFileFlags |
一个读/写 sint32 值,该值包含一个掩码,指定要在日志文件中记录的属性。 后文的“备注”部分列出了可能的值。 |
Period |
一个读/写 sint32 枚举,该值指定当前日志文件关闭的频率以及启动新日志文件的频率。 后文的“备注”部分列出了可能的值。 |
TruncateSize |
一个读/写 string 值,该值指定日志文件内容应截断的大小(以字节为单位)。 当 Period 设置为 MaxSize 时,必须配置此属性。 大小须介于 1048576 (1 MB) 和 4294967295 (4 GB) 之间。 默认为 20971520 (20 MB)。 |
子类
此类不包含子类。
注解
此类的实例包含在 LogSection 类的 CentralW3CLogFile
属性中。
下表列出了 LogExtFileFlags
属性可能的值。 默认属性为 ClientIP
、Date
、HttpStatus
、HttpSubStatus
、Method
、ServerIP
、ServerPort
、SiteName
、Time
、UriQuery
、UriStem
、UserAgent
、UserName
和 Win32Status
。
值 | 属性 |
---|---|
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 |
下表列出了 Period
属性可能的值。 默认值为 1 (Daily
)。
值 | 关键字 | 说明 |
---|---|---|
0 | MaxSize |
达到 TruncateSize 中的值时,关闭日志文件并启动新的日志文件。 |
1 | Daily |
每天关闭日志文件并启动新的日志文件。 |
2 | Weekly |
每周关闭日志文件并启动新的日志文件。 |
3 | Monthly |
每月关闭日志文件并启动新的日志文件。 |
4 | Hourly |
每小时关闭日志文件并启动新的日志文件。 |
示例
以下代码示例将日志文件模式设置为 CentralW3C
,启用 centralW3C 日志记录,将 Period
属性设置为 MaxSize
,指定日志文件使用当地时间,并将日志大小限制为 100 MB。 帮助程序函数显示更改前后的设置。
' 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
继承层次结构
CentralW3CLogFile
要求
类型 | 描述 |
---|---|
客户端 | - 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 |
另请参阅
CentralBinaryLogFile 类
EmbeddedObject 类
LogSection 类
SiteLogFile 类