SiteLogFile 类 1
配置网站的日志记录。
语法
class SiteLogFile : EmbeddedObject
方法
此类不包含任何方法。
属性
下表列出了 SiteLogFile 类公开的属性。
| 名称 | 描述 |
|---|---|
CustomLogPluginClsid |
一个读/写 string 值，指定用于自定义日志记录的插件模块的 GUID。 默认值为“FF160663-DE82-11CF-BC0A-00AA006111E0”。 |
Directory |
一个非空读/写 string 值，指定存储日志文件的目录的名称。 默认值为“%SystemDrive%\inetpub\logs\LogFiles”。 注意：如果 IIS_IUSRS 组对此目录没有写入权限，则不会生成日志。 如果指定默认目录以外的目录，请确保 IIS_IUSRS 组对该目录具有写入权限。 |
Enabled |
一个读/写 boolean 值。 如果为网站启用了网站日志记录，则为 true；否则为 false。 默认为 true。 |
LocalTimeRollover |
一个读/写 boolean 值。 如果新的日志文件基于本地时间，则为 true；如果基于协调世界时 (UTC)，则为 false。 默认为 false。 |
LogExtFileFlags |
一个读/写 sint32 值，该值包含一个掩码，指定要在日志文件中记录的属性。 此属性仅适用于万维网联合会 (W3C) 格式日志记录。 后文的“备注”部分列出了可能的值。 |
LogFormat |
一个读/写 sint32 枚举，指定日志文件格式。 后文的“备注”部分列出了可能的值。 |
Period |
一个读/写 sint32 枚举，指定滚动更新日志文件内容（即关闭当前日志文件并启动新日志文件）的频率。 后文的“备注”部分列出了可能的值。 |
TruncateSize |
一个读/写 string 值，指定在哪个大小（以字节为单位）处截断日志文件内容。 若要启用此属性，请将 Period 设置为 MaxSize。 大小须介于 1048576 (1 MB) 和 4294967295 (4 GB) 之间。 默认值为 20971520 (20 MB)。 |
子类
此类不包含子类。
注解
此类的实例包含在 Site 和 SiteElementDefaults 类的 LogFile 属性中。
下表列出了 LogExtFileFlags 属性的可能值。 默认属性为 ClientIP、Date、HttpStatus、HttpSubStatus、Method、ServerIP、ServerPort、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 |
下表列出了 LogFormat 属性的可能值。 默认值为 2 (W3C)。
| 值 | 关键字 | 说明 |
|---|---|---|
| 0 | IIS |
日志文件以 IIS 格式记录。 此格式是固定的 ASCII 文本，不可自定义。 |
| 1 | NCSA |
日志文件以美国国家超级计算技术应用中心 (NCSA) 通用日志文件格式记录。 此格式是固定的 ASCII 文本，不可自定义。 |
| 2 | W3C |
日志文件以 W3C 扩展日志文件格式记录。 此格式为 ASCII 文本，并且可自定义。 |
| 3 | Custom |
日志文件以用户决定的自定义格式记录。 |
下表列出了 Period 属性的可能值。 默认值为 1 (Daily)。
| 值 | 关键字 | 说明 |
|---|---|---|
| 0 | MaxSize |
达到 TruncateSize 中的值时，关闭日志文件并启动新的日志文件。 |
| 1 | Daily |
每天关闭日志文件并启动新的日志文件。 |
| 2 | Weekly |
每周关闭日志文件并启动新的日志文件。 |
| 3 | Monthly |
每月关闭日志文件并启动新的日志文件。 |
| 4 | Hourly |
每小时关闭日志文件并启动新的日志文件。 |
继承层次结构
SiteLogFile
要求
| 类型 | 描述 |
|---|---|
| 客户端 | - 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 类
CentralW3CLogFile 类
EmbeddedObject 类
LogSection 类
Site 类
SiteElementDefaults 类
IIS 中的日志文件格式