SiteLogFile Class1
Konfiguriert die Protokollierung für eine Website.
Syntax
class SiteLogFile : EmbeddedObject
Methoden
Diese Klasse enthält keine Methoden.
Eigenschaften
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die von der SiteLogFile-Klasse verfügbar gemacht werden.
| Name | Beschreibung |
|---|---|
CustomLogPluginClsid |
Ein string Lese-/Schreibwert, der die GUID eines Plug-In-Moduls angibt, das für die benutzerdefinierte Protokollierung verwendet wird. Der Standardwert ist "FF160663-DE82-11CF-BC0A-00AA006111E0". |
Directory |
Ein nicht leerer string Lese-/Schreibwert, der den Namen des Verzeichnisses angibt, in dem Protokolldateien gespeichert werden. Der Standardwert ist "%SystemDrive%\inetpub\logs\LogFiles". Hinweis: Wenn die Gruppe IIS_IUSRS nicht über die Berechtigung zum Schreiben in dieses Verzeichnis verfügt, werden die Protokolle nicht generiert. Wenn Sie ein anderes Verzeichnis als den Standard angeben, stellen Sie sicher, dass die Gruppe IIS_IUSRS über die Berechtigung zum Schreiben verfügt. |
Enabled |
Ein boolean Lese-/Schreibwert. true wenn die Websiteprotokollierung für eine Website aktiviert ist; andernfalls false. Der Standardwert ist true. |
LocalTimeRollover |
Ein boolean Lese-/Schreibwert. true wenn eine neue Protokolldatei auf lokaler Zeit basiert; false wenn sie auf koordinierter Weltzeit (COORDINATED Universal Time, UTC) basiert. Der Standardwert ist false. |
LogExtFileFlags |
Ein sint32 Lese-/Schreibwert, der eine Maske enthält, die die Attribute angibt, die in der Protokolldatei aufgezeichnet werden sollen. Diese Eigenschaft gilt nur für die W3C-Formatprotokollierung (World Wide Web Consortium). Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt. |
LogFormat |
Eine sint32 Lese-/Schreibaufzählung, die das Format der Protokolldatei angibt. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt. |
Period |
Eine sint32 Enumeration mit Lese-/Schreibzugriff, die angibt, wie häufig Protokolldateiinhalte überrollt werden (d. a. die aktuelle Protokolldatei wird geschlossen und eine neue Protokolldatei gestartet). Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt. |
TruncateSize |
Ein string Lese-/Schreibwert, der die Größe in Bytes angibt, bei der der Inhalt der Protokolldatei abgeschnitten wird. Um diese Eigenschaft zu aktivieren, setzen Sie Period auf MaxSize. Die Größe muss zwischen 1048576 (1 MB) und 4294967295 (4 Gigabyte) betragen. Der Standardwert ist 20971520 (20 Mb). |
Unterklassen
Diese Klasse enthält keine Unterklassen.
Hinweise
Instanzen dieser Klasse sind in der LogFile Eigenschaft der Site und SiteElementDefaults Klassen enthalten.
In der folgenden Tabelle werden die verschiedenen möglichen Werte für die LogExtFileFlags Eigenschaft angezeigt. Die Standardattribute sind ClientIP: , Date, HttpStatus, HttpSubStatus, ServerIPMethodServerPort, UriStemUriQueryUserAgentTime, und UserNameWin32Status.
| Wert | Attribut |
|---|---|
| 1 | Date |
| 2 | Time |
| 4 | ClientIP |
| 8 | UserName |
| 16 | SiteName |
| 32 | ComputerName |
| 64 | ServerIP |
| 128 Bits | Method |
| 256 KB | UriStem |
| 512 | UriQuery |
| 1024 | HttpStatus |
| 2048 | Win32Status |
| 4096 | BytesSent |
| 8192 | BytesRecv |
| 16384 | TimeTaken |
| 32768 | ServerPort |
| 65536 | UserAgent |
| 131072 | Cookie |
| 262144 | Referer |
| 524288 | ProtocolVersion |
| 1048576 | Host |
| 2097152 | HttpSubStatus |
In der folgenden Tabelle werden die verschiedenen möglichen Werte für die LogFormat Eigenschaft angezeigt. Der Standardwert ist 2 (W3C).
| Wert | Schlüsselwort | Beschreibung |
|---|---|---|
| 0 | IIS |
Die Protokolldatei zeichnet im IIS-Format auf. Dieses Format ist fester ASCII-Text und kann nicht angepasst werden. |
| 1 | NCSA |
Die Protokolldatei wird im Common-Protokolldateiformat des National Center for Supercomputing Applications (NCSA) aufgezeichnet. Dieses Format ist fester ASCII-Text und kann nicht angepasst werden. |
| 2 | W3C |
Die Protokolldatei zeichnet im W3C Extended-Protokolldateiformat auf. Dieses Format liegt im ASCII-Text vor und ist anpassbar. |
| 3 | Custom |
Die Protokolldatei zeichnet in einem vom Benutzer festgelegten benutzerdefinierten Format auf. |
In der folgenden Tabelle werden die verschiedenen möglichen Werte für die Period Eigenschaft angezeigt. Der Standardwert ist 1 (Daily).
| Wert | Schlüsselwort | Beschreibung |
|---|---|---|
| 0 | MaxSize |
Die Protokolldatei wird geschlossen, und eine neue Protokolldatei wird gestartet, wenn der Wert TruncateSize erreicht wird. |
| 1 | Daily |
Die Protokolldatei wird geschlossen und eine neue Protokolldatei wird einmal pro Tag gestartet. |
| 2 | Weekly |
Die Protokolldatei wird geschlossen und eine neue Protokolldatei wird einmal pro Woche gestartet. |
| 3 | Monthly |
Die Protokolldatei wird geschlossen und eine neue Protokolldatei wird einmal pro Monat gestartet. |
| 4 | Hourly |
Die Protokolldatei wird geschlossen und eine neue Protokolldatei wird einmal pro Stunde gestartet. |
Vererbungshierarchie
SiteLogFile
Anforderungen
| type | Beschreibung |
|---|---|
| Client | - IIS 7.0 unter Windows Vista. - IIS 7.5 unter Windows 7 - IIS 8.0 unter Windows 8 - IIS 10.0 unter Windows 10 |
| Server | - IIS 7.0 unter Windows Server 2008 - IIS 7.5 unter Windows Server 2008 R2 - IIS 8.0 auf Windows Server 2012 - IIS 8.5 unter Windows Server 2012 R2 - IIS 10.0 auf Windows Server 2016 |
| Produkt | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| MOF-Datei | WebAdministration.mof |
Weitere Informationen
CentralBinaryLogFile Class
CentralW3CLogFile-Klasse
EmbeddedObject-Klasse
LogSection-Klasse
Websiteklasse
SiteElementDefaults-Klasse
Protokolldateiformate in IIS