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 メガバイト) から 4294967295 (4 ギガバイト) の間である必要があります。 既定値は 20971520 (20 メガバイト) です。 |
サブクラス
このクラスにはサブクラスが含まれていません。
解説
このクラスのインスタンスは、LogSection クラスの CentralBinaryLogFile
プロパティに含まれています。
次の表に、Period
プロパティとして使用できる値の一覧を示します。 既定値は 1 (Daily
) です。
Value | キーワード | 説明 |
---|---|---|
0 | MaxSize |
ログ ファイルが閉じられ、値 TruncateSize に達すると新しいログ ファイルが開始されます。 |
1 | Daily |
ログ ファイルが閉じられ、1 日に 1 回新しいログ ファイルが開始されます。 |
2 | Weekly |
ログ ファイルが閉じられ、新しいログ ファイルが 1 週間に 1 回開始されます。 |
3 | Monthly |
ログ ファイルが閉じられ、新しいログ ファイルが 1 か月に 1 回開始されます。 |
4 | Hourly |
ログ ファイルが閉じられ、1 時間に 1 回新しいログ ファイルが開始されます。 |
例
次のコード例では、ログ ファイル モードを CentralBinary
に設定し、バイナリ ログを有効にし、Period
プロパティを Weekly
に設定し、ログ ファイルがローカル時刻を使用することを指定し、ログ サイズを 1GB に制限します。 ヘルパー関数は、変更の前後の設定を表示します。
' 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
継承階層
CentralBinaryLogFile
要件
型 | 説明 |
---|---|
クライアント | - 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 |
参照
CentralW3CLogFile クラス
EmbeddedObject クラス
LogSection クラス
SiteLogFile クラス