Classe 1 :HttpLoggingSection

Article
03/25/2024

Configure la journalisation des requêtes HTTP.

Syntaxe

class HttpLoggingSection : ConfigurationSection

Méthodes

Le tableau suivant répertorie les méthodes exposées par la classe HttpLoggingSection.

Nom	Description
GetAllowDefinition	(Hérité de ConfigurationSection.)
GetAllowLocation	(Hérité de `ConfigurationSection`.)
RevertToParent	(Hérité de `ConfigurationSection`.)
SetAllowDefinition	(Hérité de `ConfigurationSection`.)
SetAllowLocation	(Hérité de `ConfigurationSection`.)

Propriétés

Le tableau suivant répertorie les propriétés exposées par la classe HttpLoggingSection.

Nom	Description
`DontLog`	Une valeur `boolean` de lecture/écriture. `true` si la journalisation est désactivée pour les requêtes réussies ; `false` si les requêtes réussies sont enregistrées. Une requête est considérée comme réussie si son code d'état est inférieur à 400. Par défaut, il s’agit de `false`. Remarque : cette propriété est identique à la propriété de métabase DontLog dans IIS 6.0.
`Location`	(Hérité de `ConfigurationSection`.) Une propriété clé.
`Path`	(Hérité de `ConfigurationSection`.) Une propriété clé.
`SectionInformation`	(Hérité de `ConfigurationSection`.)
`SelectiveLogging`	Énumération `sint32` qui spécifie les événements à consigner. Les valeurs possibles sont répertoriées plus loin dans la section Remarques.

Sous-classes

Cette classe ne contient aucune sous-classe.

Notes

Cette classe correspond à la section <system.webServer/httpLogging> du fichier ApplicationHost.config.

Le tableau suivant répertorie les valeurs possibles pour la propriété SelectiveLogging. La valeur par défaut est 0 (LogAll).

Valeur	Mot clé	Description
0	`LogAll`	Toutes les requêtes sont enregistrées.
1	`LogSuccessful`	Seules les requêtes réussies sont enregistrées. Une requête est considérée comme réussie si son code d'état est inférieur à 400.
2	`LogError`	Seules les requêtes ayant échoué sont enregistrées. Une requête est considérée comme ayant échoué si son code d'état est supérieur ou égal à 400.

Exemple

L'exemple de code suivant illustre la propriété SelectiveLogging sur 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

Hiérarchie d'héritage

ConfigurationSection

HttpLoggingSection

Spécifications

Type	Description
Client	- IIS 7.0 sur Windows Vista - IIS 7.5 sur Windows 7 - IIS 8.0 sous Windows 8 - IIS 10.0 sur Windows 10
Serveur	- IIS 7.0 sous Windows Server 2008 - IIS 7.5 sous Windows Server 2008 R2 - IIS 8.0 sous Windows Server 2012 - IIS 8.5 sous Windows Server 2012 R2 - IIS 10.0 sur Windows Server 2016
Produit	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
Fichier MOF	WebAdministration.mof

Voir aussi

Classe CentralBinaryLogFile
Classe CentralW3CLogFile
Classe ConfigurationSection
Classe OdbcLoggingSection
Classe LogSection
Classe SiteLogFile
Propriété de métabase DontLog (IIS 6.0)

Partager via