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
継承階層
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)