Classe1 SiteLogFile
Configure la journalisation pour un site Web.
Syntaxe
class SiteLogFile : EmbeddedObject
Méthodes
Cette classe ne contient pas de méthodes.
Propriétés
Le tableau suivant répertorie les propriétés exposées par la classe SiteLogFile.
| Nom | Description |
|---|---|
CustomLogPluginClsid |
Valeur en lecture/écriture string qui spécifie le GUID d’un module de plug-in utilisé pour la journalisation personnalisée. La valeur par défaut est « FF160663-DE82-11CF-BC0A-00AA006111E0 ». |
Directory |
Valeur de lecture/écriture string non vide qui spécifie le nom du répertoire dans lequel les fichiers journaux sont stockés. La valeur par défaut est « %SystemDrive%\inetpub\logs\LogFiles ». Remarque : Si le groupe IIS_IUSRS n’a pas l’autorisation d’écrire dans ce répertoire, les journaux d’activité ne sont pas générés. Si vous spécifiez un répertoire autre que la valeur par défaut, assurez-vous que le groupe IIS_IUSRS a l’autorisation d’y écrire. |
Enabled |
Une valeur boolean en lecture/écriture. true si la journalisation de site est activée pour un site web ; 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. Cette propriété s’applique uniquement à la journalisation au format W3C (World Wide Web Consortium). Les valeurs possibles sont répertoriées plus loin dans la section Remarques. |
LogFormat |
Énumération en lecture/écriture sint32 qui spécifie le format du 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 contenu du fichier journal est roulé (autrement dit, 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 en lecture/écriture string qui spécifie la taille, en octets, à laquelle le contenu du fichier journal est tronqué. Pour activer cette propriété, définissez Period 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 propriété LogFile de la classe SiteServerSiteElementDefaults.
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, Time, UriQuery, UriStem, UserAgent, UserName, et 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é LogFormat. La valeur par défaut est 2 (W3C).
| Valeur | Mot clé | Description |
|---|---|---|
| 0 | IIS |
Enregistrements du fichier journal au format IIS. Ce format est fixe texte ASCII et n’est pas personnalisable. |
| 1 | NCSA |
Les enregistrements des fichiers journaux dans le format de fichier journal commun du Centre national pour les applications de supercomputation (NCSA). Ce format est fixe texte ASCII et n’est pas personnalisable. |
| 2 | W3C |
Les enregistrements du fichier journal au format de fichier journal étendu W3C. Ce format est en texte ASCII et est personnalisable. |
| 3 | Custom |
Les enregistrements du fichier journal dans un format personnalisé ont été décidés par l’utilisateur. |
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. |
Hiérarchie d'héritage
SiteLogFile
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 CentralW3CLogFile
Classe EmbeddedObject
Classe LogSection
Classe de site
Classe SiteElementDefaults
Formats de fichier journal dans IIS