Класс HttpLoggingSection1

Статья
07/19/2023

Настраивает ведение журнала HTTP-запросов.

Синтаксис

class HttpLoggingSection : ConfigurationSection

Методы

В следующей таблице перечислены методы, предоставляемые классом HttpLoggingSection .

Имя	Описание
GetAllowDefinition	(Наследуется от ConfigurationSection.)
GetAllowLocation	(Является наследником `ConfigurationSection`)
RevertToParent	(Является наследником `ConfigurationSection`)
SetAllowDefinition	(Является наследником `ConfigurationSection`)
SetAllowLocation	(Является наследником `ConfigurationSection`)

Свойства

В следующей таблице перечислены свойства, предоставляемые классом HttpLoggingSection .

Имя	Описание
`DontLog`	Значение для чтения и записи `boolean` . `true` Значение , если ведение журнала отключено для успешных запросов; `false` Значение , если успешные запросы регистрируются в журнале. Запрос считается успешным, если его код состояния меньше 400. Значение по умолчанию — `false`. Примечание: Это свойство совпадает со свойством метабазы DontLog в IIS 6.0.
`Location`	(Наследуется от `ConfigurationSection`.) Свойство ключа.
`Path`	(Наследуется от `ConfigurationSection`.) Свойство ключа.
`SectionInformation`	(Является наследником `ConfigurationSection`)
`SelectiveLogging`	Перечисление `sint32` , указывающее события для записи в журнал. Возможные значения перечислены далее в разделе Примечания.

используются подклассы ;

Этот класс не содержит подклассов.

Значение	Ключевое слово	Описание
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

Требования

Тип	Описание
клиент	— IIS 7.0 в Windows Vista — IIS 7.5 в Windows 7 — IIS 8.0 в Windows 8 — IIS 10.0 в Windows 10
Сервер	— IIS 7.0 в Windows Server 2008 — IIS 7.5 в Windows Server 2008 R2 — IIS 8.0 в Windows Server 2012 — IIS 8.5 в Windows Server 2012 R2 — IIS 10.0 в Windows Server 2016
Продукт	— 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)

Поделиться через