LogSection 类 1

配置服务器或站点的日志记录。

语法

class LogSection : ConfigurationSection  

方法

下表列出了 LogSection 类公开的方法。

名称	描述
GetAllowDefinition	（继承自 ConfigurationSection。）
GetAllowLocation	（从 ConfigurationSection 继承。）
RevertToParent	（从 ConfigurationSection 继承。）
SetAllowDefinition	（从 ConfigurationSection 继承。）
SetAllowLocation	（从 ConfigurationSection 继承。）

属性

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

名称	描述
CentralBinaryLogFile	一个读/写 CentralBinaryLogFile 值，指定了服务器上所有站点集中式二进制日志记录的配置。
CentralLogFileMode	一个读/写 sint32 值，该值指定服务器的集中式日志模式。 后文的“备注”部分列出了可能的值。
CentralW3CLogFile	一个读/写 CentralW3CLogFile 值，该值指定服务器上所有站点的万维网联合会 (W3C) 集中日志记录的配置。
Location	（继承自 ConfigurationSection。）一个键属性。
LogInUTF8	一个读/写 boolean 值。 如果 IIS 以 Unicode 传输格式 8 (UTF-8) 记录所有字符串，则为 true；否则，为 false。 默认为 true。 此设置应用于服务器范围内的所有文本模式日志记录。
Path	（继承自 ConfigurationSection。）一个键属性。
SectionInformation	（从 ConfigurationSection 继承。）

子类

此类不包含子类。

注解

此类对应于 ApplicationHost.config 中的 <system.applicationHost/log> 节。

下表列出了 CentralLogFileMode 属性的可能值。 默认值为 0 (Site)。

值	关键字	说明
0	Site	所有客户端请求都在站点级别记录，而不是在服务器级别集中记录。 日志文件将按每个站点进行生成。
1	CentralBinary	所有站点的所有客户端请求都以集中二进制格式在服务器上的单个日志文件中记录。
2	CentralW3C	所有站点的所有客户端请求都以 W3C 集中式格式在服务器上的单个日志文件中记录。

示例

以下代码示例显示 CentralLogFileMode 属性的值。 帮助程序函数将枚举值转换为文本。

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject( _  
    "winmgmts:root\WebAdministration")  
  
' Get the log section.  
Set oSection = oWebAdmin.Get("LogSection.Path=" & _  
    "'MACHINE/WEBROOT/APPHOST',Location=''")  
  
' Display the class name of the section.  
WScript.Echo "[ " & oSection.Path_.Class & " ]"  
  
' Display the path and location.  
WScript.Echo "Path: " & oSection.Path  
WScript.Echo "Location: " & oSection.Location  
  
' Display the central log file mode.  
WScript.Echo "CentralLogFileMode: " & _  
                GetModeText(oSection.CentralLogFileMode)  
  
' ==== GetModeText helper function. ====  
Function GetModeText(intMode)  
    Select Case intMode  
        Case 0  
            GetModeText="Site"  
        Case 1  
            GetModeText="CentralBinary"  
        Case 2  
            GetModeText="CentralW3C"  
        Case Else  
            GetModeText="Undefined value"  
    End Select  
End Function  
  

继承层次结构

ConfigurationSection

LogSection

要求

类型	描述
客户端	- 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

另请参阅

ConfigurationSection 类
CentralBinaryLogFile 类
CentralW3CLogFile 类
SiteLogFile 类