HttpLoggingSection クラス 1

HTTP 要求のログを構成します。

構文

class HttpLoggingSection : ConfigurationSection  

メソッド

次の表に、HttpLoggingSection クラスによって公開されるメソッドの一覧を示します。

名前 説明
GetAllowDefinition (ConfigurationSection から継承。)
GetAllowLocation (ConfigurationSection から継承。)
RevertToParent (ConfigurationSection から継承。)
SetAllowDefinition (ConfigurationSection から継承。)
SetAllowLocation (ConfigurationSection から継承。)

プロパティ

次の表は、HttpLoggingSection クラスによって公開されるプロパティの一覧です。

名前 説明
DontLog 読み取り/書き込みの boolean 値。 成功した要求に対してログが無効の場合は true。成功した要求をログする場合は false。 状態コードが 400 未満の場合、その要求は成功したと見なされます。 既定値は、false です。 注: このプロパティは、IIS 6.0 の DontLog メタベース プロパティと同じです。
Location (ConfigurationSection から継承。)キー プロパティ。
Path (ConfigurationSection から継承。)キー プロパティ。
SectionInformation (ConfigurationSection から継承。)
SelectiveLogging ログするイベントを指定する sint32 列挙型。 使用できる値の一覧は、後述の「注釈」セクションに示します。

サブクラス

このクラスにはサブクラスが含まれていません。

解説

このクラスは、ApplicationHost.config ファイルの <system.webServer/httpLogging> セクションに対応します。

次の表に、SelectiveLogging プロパティとして使用できる値の一覧を示します。 既定値は 0 (LogAll) です。

Value キーワード 説明
0 LogAll すべての要求をログします。
1 LogSuccessful 成功した要求のみをログします。 状態コードが 400 未満の場合、その要求は成功したと見なされます。
2 LogError 失敗した要求のみをログします。 状態コードが 400 以上の場合、その要求は失敗したと見なされます。

次のコード例は、SelectiveLogging プロパティを LogError に設定しています。

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject( _  
    "winmgmts:root\WebAdministration")  
  
' Get the HTTP logging section.  
Set oSection = oWebAdmin.Get( _  
    "HttpLoggingSection.Path=" & _  
    "'MACHINE/WEBROOT/APPHOST',Location=''")  
  
' Display the class name of the section.  
WScript.Echo "[ " & oSection.Path_.Class & " ]" & vbCrLf  
  
' Display the initial settings.  
Call DisplaySettings("Initial Values", oSection)  
  
' Set the SelectiveLogging property to LogError.  
    oSection.SelectiveLogging = 2  
  
' Save new values to configuration.  
oSection.Put_  
  
' Refresh the oSection object variable with new values.  
oSection.Refresh_  
  
' Show changed settings.  
Call DisplaySettings("New Values", oSection)  
  
' ==== DisplaySettings helper function. ====  
Function DisplaySettings(HeadingText, oSection)  
  
    ' Display a heading.  
    WScript.Echo String(Len(HeadingText), "-")  
    WScript.Echo HeadingText  
    WScript.Echo String(Len(HeadingText), "-")  
  
    ' Display configuration history section properties.  
    WScript.Echo "Path: " & oSection.Path  
    WScript.Echo "Location: " & oSection.Location  
    WScript.Echo "DontLog: " & oSection.DontLog  
    WScript.Echo "SelectiveLogging: " & _  
        oSection.SelectiveLogging  
    WScript.Echo  
End Function  
  

継承階層

ConfigurationSection

HttpLoggingSection

要件

説明
クライアント - 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 クラス
ConfigurationSection クラス
OdbcLoggingSection クラス
LogSection クラス
SiteLogFile クラス
DontLog メタベース プロパティ (IIS 6.0)