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 値。 PeriodMaxSize に設定されている場合は、この属性を構成する必要があります。 サイズは、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  
  

継承階層

EmbeddedObject

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 クラス