SiteLogFile Class1
Web サイトのログ記録を構成します。
構文
class SiteLogFile : EmbeddedObject
メソッド
このクラスにはメソッドが含まれていません。
プロパティ
次の表は、SiteLogFile クラスによって公開されるプロパティの一覧です。
| 名前 | 説明 |
|---|---|
CustomLogPluginClsid |
カスタム ログ記録に使用されるプラグイン モジュールの GUID を指定する読み取り/書き込み string 値。 既定値は "FF160663-DE82-11CF-BC0A-00AA006111E0" です。 |
Directory |
ログ ファイルが格納されるディレクトリの名前を指定する空でない読み取り/書き込み string 値。 既定値は "%SystemDrive%\inetpub\logs\LogFiles" です。 注: IIS_IUSRS グループにこのディレクトリに書き込む権限がない場合、ログは生成されません。 既定以外のディレクトリを指定する場合は、IIS_IUSRS グループに書き込むアクセス許可があることを確認してください。 |
Enabled |
読み取り/書き込みの boolean 値。 Web サイトに対してサイト ログが有効になっている場合は true、それ以外の場合は false です。 既定値は、true です。 |
LocalTimeRollover |
読み取り/書き込みの boolean 値。 新しいログ ファイルが現地時刻に基づいている場合は true、協定世界時 (UTC) に基づいている場合は false です。 既定値は、false です。 |
LogExtFileFlags |
ログ ファイルに記録する属性を指定するマスクを含む読み取り/書き込み sint32 値。 このプロパティは、World Wide Web Consortium (W3C) 形式のログ記録にのみ適用されます。 使用できる値の一覧は、後述の「注釈」セクションに示します。 |
LogFormat |
ログ ファイルの形式を指定する読み取り/書き込み sint32 列挙型。 使用できる値の一覧は、後述の「注釈」セクションに示します。 |
Period |
ログ ファイルの内容をロール オーバーする頻度 (つまり、現在のログ ファイルが閉じられ、新しいログ ファイルが開始される) を指定する読み取り/書き込み sint32 列挙型。 使用できる値の一覧は、後述の「注釈」セクションに示します。 |
TruncateSize |
ログ ファイルの内容が切り捨てられるサイズをバイト単位で指定する読み取り/書き込み string 値。 このプロパティを有効にするには、Period を MaxSize に設定します。 サイズは、1048576 (1 メガバイト) から 4294967295 (4 ギガバイト) の間である必要があります。 既定値は 20971520 (20 メガバイト) です。 |
サブクラス
このクラスにはサブクラスが含まれていません。
解説
このクラスのインスタンスは、Site クラスと SiteElementDefaults クラスの LogFile プロパティに含まれています。
次の表に、LogExtFileFlags プロパティとして使用できる値の一覧を示します。 デフォルトの属性は、ClientIP、Date、HttpStatus、HttpSubStatus、Method、ServerIP、ServerPort、Time、UriQuery、UriStem、UserAgent、UserName、および Win32Status です。
| Value | Attribute |
|---|---|
| 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) です。
| Value | キーワード | 説明 |
|---|---|---|
| 0 | IIS |
ログ ファイルは IIS 形式で記録されます。 この形式は固定の ASCII テキストであり、カスタマイズできません。 |
| 1 | NCSA |
このログ ファイルは、National Center for Supercomputing Applications (NCSA) の共通ログ ファイル形式で記録されます。 この形式は固定の ASCII テキストであり、カスタマイズできません。 |
| 2 | W3C |
ログ ファイルは W3C 拡張ログ ファイル形式で記録されます。 この形式は ASCII テキストであり、カスタマイズ可能です。 |
| 3 | Custom |
ログ ファイルは、ユーザーが決定したカスタム形式で記録されます。 |
次の表に、Period プロパティとして使用できる値の一覧を示します。 既定値は 1 (Daily) です。
| Value | キーワード | 説明 |
|---|---|---|
| 0 | MaxSize |
ログ ファイルが閉じられ、値 TruncateSize に達すると新しいログ ファイルが開始されます。 |
| 1 | Daily |
ログ ファイルが閉じられ、1 日に 1 回新しいログ ファイルが開始されます。 |
| 2 | Weekly |
ログ ファイルが閉じられ、新しいログ ファイルが 1 週間に 1 回開始されます。 |
| 3 | Monthly |
ログ ファイルが閉じられ、新しいログ ファイルが 1 か月に 1 回開始されます。 |
| 4 | Hourly |
ログ ファイルが閉じられ、1 時間に 1 回新しいログ ファイルが開始されます。 |
継承階層
SiteLogFile
要件
| 型 | 説明 |
|---|---|
| クライアント | - Windows Vista 上の IIS 7.0 - Windows 7 上の IIS 7.5 - Windows 8 上の IIS 8.0 - Windows 10 上の IIS 10.0 |
| [サーバー] | - Windows Server 2008 上の IIS 7.0 - Windows Server 2008 R2 上の IIS 7.5 - Windows Server 2012 上の IIS 8.0 - Windows Server 2012 R2 上の IIS 8.5 - Windows Server 2016 上の IIS 10.0 |
| Product | - 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 のログ ファイルの形式