Classe 1 : LogSection
Configure la journalisation d'un serveur ou d'un site.
Syntaxe
class LogSection : ConfigurationSection
Méthodes
Le tableau suivant répertorie les méthodes exposées par la classe LogSection
.
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 LogSection
.
Nom | Description |
---|---|
CentralBinaryLogFile |
Valeur CentralBinaryLogFile en lecture/écriture qui spécifie la configuration de la journalisation binaire centralisée pour tous les sites sur un serveur. |
CentralLogFileMode |
Valeur sint32 en lecture/écriture qui spécifie le mode journalisation centralisé pour le serveur. Les valeurs possibles sont répertoriées plus loin dans la section Remarques. |
CentralW3CLogFile |
Valeur CentralW3CLogFile en lecture/écriture qui spécifie la configuration de la journalisation centralisée W3C (World Wide Web Consortium) pour tous les sites sur un serveur. |
Location |
(Hérité de ConfigurationSection .) Une propriété clé. |
LogInUTF8 |
Une valeur boolean en lecture/écriture. true si IIS journalise toutes les chaînes en UTF-8. Sinon, false . Par défaut, il s’agit de true . Ce paramètre s'applique à l'échelle du serveur à l'ensemble de la journalisation en mode Texte. |
Path |
(Hérité de ConfigurationSection .) Une propriété clé. |
SectionInformation |
(Hérité de ConfigurationSection .) |
Sous-classes
Cette classe ne contient aucune sous-classe.
Notes
Cette classe correspond à la section <system.applicationHost/log>
dans ApplicationHost.config.
Le tableau suivant répertorie les valeurs possibles pour la propriété CentralLogFileMode
. La valeur par défaut est 0 (Site
).
Valeur | Mot clé | Description |
---|---|---|
0 | Site |
Toutes les requêtes des clients sont enregistrées au niveau du site, et non de manière centralisée au niveau du serveur. Les fichiers journaux sont générés par site. |
1 | CentralBinary |
Toutes les requêtes clientes pour tous les sites sont enregistrées dans un fichier journal unique au format binaire centralisé sur le serveur. |
2 | CentralW3C |
Toutes les requêtes clientes pour tous les sites sont enregistrées dans un fichier journal unique au format centralisé W3C sur le serveur. |
Exemple
L'exemple de code suivant affiche la valeur de la propriété CentralLogFileMode
. Une fonction d'assistance traduit la valeur d'énumération en texte.
' Connect to the WMI WebAdministration namespace.
Set oWebAdmin = GetObject( _
"winmgmts:root\WebAdministration")
' Get the log section.
Set oSection = oWebAdmin.Get("LogSection.Path=" & _
"'MACHINE/WEBROOT/APPHOST',Location=''")
' Display the class name of the section.
WScript.Echo "[ " & oSection.Path_.Class & " ]"
' Display the path and location.
WScript.Echo "Path: " & oSection.Path
WScript.Echo "Location: " & oSection.Location
' Display the central log file mode.
WScript.Echo "CentralLogFileMode: " & _
GetModeText(oSection.CentralLogFileMode)
' ==== GetModeText helper function. ====
Function GetModeText(intMode)
Select Case intMode
Case 0
GetModeText="Site"
Case 1
GetModeText="CentralBinary"
Case 2
GetModeText="CentralW3C"
Case Else
GetModeText="Undefined value"
End Select
End Function
Hiérarchie d'héritage
LogSection
Spécifications
Type | Description |
---|---|
Client | - IIS 7.0 sous 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 ConfigurationSection
Classe CentralBinaryLogFile
Classe CentralW3CLogFile
Classe SiteLogFile