CentralW3CLogFile, classe1

Article
03/19/2024

Configure les paramètres pour la journalisation centralisée W3C (World Wide Web Consortium) sur un serveur.

Syntaxe

class CentralW3CLogFile : EmbeddedObject

Méthodes

Cette classe ne contient aucune méthode.

Propriétés

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

Nom	Description
`Directory`	Valeur de `string` en lecture/écriture non vide qui spécifie le répertoire dans lequel les entrées de journal doivent être écrites. La valeur par défaut est « %SystemDrive%\inetpub\logs\LogFiles ».
`Enabled`	Une valeur `boolean` en lecture/écriture. `true` si la journalisation centralisée W3C est activée ; sinon, `false`. Par défaut, il s’agit de `true`.
`LocalTimeRollover`	Une valeur `boolean` en lecture/écriture. `true` si un nouveau fichier journal est basé sur l’heure locale ; `false` si elle est basée sur le temps universel coordonné (UTC). Par défaut, il s’agit de `false`.
`LogExtFileFlags`	Valeur de `sint32` en lecture/écriture qui contient un masque qui spécifie les attributs à enregistrer dans le fichier journal. Les valeurs possibles sont répertoriées plus loin dans la section Remarques.
`Period`	Énumération en lecture/écriture `sint32` qui spécifie la fréquence à laquelle le fichier journal actuel est fermé et un nouveau fichier journal est démarré. Les valeurs possibles sont répertoriées plus loin dans la section Remarques.
`TruncateSize`	Valeur de `string` en lecture/écriture qui spécifie, en octets, la taille à laquelle le contenu du fichier journal doit être tronqué. Cet attribut doit être configuré lorsque `Period` est défini sur `MaxSize`. La taille doit être comprise entre 1048576 (1 mégaoctet) et 4294967295 (4 gigaoctets). La valeur par défaut est 20971520 (20 mégaoctets).

Sous-classes

Cette classe ne contient aucune sous-classe.

Notes

Les instances de cette classe sont contenues dans la CentralW3CLogFile propriété de la classe LogSection .

Le tableau suivant répertorie les valeurs possibles pour la propriété LogExtFileFlags. Les attributs par défaut sont ClientIP, Date, HttpStatus, HttpSubStatus, Method, ServerIP, ServerPort, SiteName, Time, UriQuery, UriStem, UserAgent, UserNameet Win32Status.

Valeur	Attribut
1	`Date`
2	`Time`
4	`ClientIP`
8	`UserName`
16	`SiteName`
32	`ComputerName`
64	`ServerIP`
128	`Method`
256	`UriStem`
512	`UriQuery`
1 024	`HttpStatus`
2 048	`Win32Status`
4096	`BytesSent`
8192	`BytesRecv`
16384	`TimeTaken`
32 768	`ServerPort`
65536	`UserAgent`
131072	`Cookie`
262144	`Referer`
524288	`ProtocolVersion`
1048576	`Host`
2097152	`HttpSubStatus`

Le tableau suivant répertorie les valeurs possibles pour la propriété Period. La valeur par défaut est 1 (Daily).

Valeur	Mot clé	Description
0	`MaxSize`	Le fichier journal est fermé et un nouveau fichier journal est démarré lorsque la valeur dans `TruncateSize` est atteinte.
1	`Daily`	Le fichier journal est fermé et un nouveau fichier journal est démarré une fois par jour.
2	`Weekly`	Le fichier journal est fermé et un nouveau fichier journal est démarré une fois par semaine.
3	`Monthly`	Le fichier journal est fermé et un nouveau fichier journal est démarré une fois par mois.
4	`Hourly`	Le fichier journal est fermé et un nouveau fichier journal est démarré une fois par heure.

Exemple

L’exemple de code suivant définit le mode fichier journal sur CentralW3C, active la journalisation centralW3C, définit la propriété Period sur MaxSize, spécifie que les fichiers journaux utilisent l’heure locale et limite la taille du journal à 100 mégaoctets. Les fonctions d’assistance affichent les paramètres avant et après la modification.

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the log configuration section.  
Set oSection = oWebAdmin.Get("LogSection.Path=" & _  
   "'MACHINE/WEBROOT/APPHOST',Location=''")  
  
' Show the initial settings.  
DisplaySettings("Initial Values")  
  
' Set the log file mode to CentralW3C.  
oSection.CentralLogFileMode = 2  
  
' Enable central W3C logging.  
oSection.CentralW3CLogFile.Enabled = True  
  
' Set local time rollover to true.  
oSection.CentralW3CLogFile.LocalTimeRollover = True  
  
' Set the Period property to MaxSize.  
oSection.CentralW3CLogFile.Period = 0  
  
' Set the log truncate size to 100 megabytes.  
oSection.CentralW3CLogFile.TruncateSize = 104857600  
  
' Save the values to configuration.  
oSection.Put_  
  
' Refresh the oSection object variable with the new values.  
oSection.Refresh_  
  
' Show the changed settings.  
Call DisplaySettings("New Values")  
  
' ==== This section contains helper functions. ====  
Function DisplaySettings(HeadingText)  
   WScript.Echo String(Len(HeadingText), "=")  
   WScript.Echo HeadingText  
   WScript.Echo String(Len(HeadingText), "=")  
  
   ' Display the current central log file mode.  
   WScript.Echo "CentralLogFileMode: " & _  
      oSection.CentralLogFileMode  
  
   ' Display the current W3C log file properties.  
   Call ShowPropVals(oSection.CentralW3CLogFile)  
  
End Function  
  
' Display the property values.  
Function ShowPropVals(oObject)  
  
   For Each Prop In oObject.Properties_  
      WScript.Echo Prop.Name & ": " & Prop.Value  
   Next  
  
   WScript.Echo  
  
End Function

Hiérarchie d'héritage

EmbeddedObject

CentralW3CLogFile

Spécifications

Type	Description
Client	- IIS 7.0 sur Windows Vista - IIS 7.5 sous Windows 7 - IIS 8.0 sous Windows 8 - IIS 10.0 sous Windows 10
Serveur	- IIS 7.0 sur Windows Server 2008 - IIS 7.5 sur Windows Server 2008 R2 - IIS 8.0 sur Windows Server 2012 - IIS 8.5 sur Windows Server 2012 R2 - IIS 10.0 sous 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 EmbeddedObject
Classe LogSection
Classe SiteLogFile

Partager via