SiteLogFile Class1
Настраивает ведение журнала для веб-сайта.
Синтаксис
class SiteLogFile : EmbeddedObject
Методы
Этот класс не содержит методов.
Свойства
В следующей таблице перечислены свойства, предоставляемые классом SiteLogFile .
| Имя | Описание |
|---|---|
CustomLogPluginClsid |
Значение для чтения и записи string , указывающее GUID подключаемого модуля, используемого для пользовательского ведения журнала. Значение по умолчанию — "FF160663-DE82-11CF-BC0A-00AA006111E0". |
Directory |
Непустое значение для чтения и записи string , указывающее имя каталога, в котором хранятся файлы журнала. Значение по умолчанию — "%SystemDrive%\inetpub\logs\LogFiles". Примечание: Если группа IIS_IUSRS не имеет разрешения на запись в этот каталог, журналы создаваться не будут. Если вы указываете каталог, отличный от каталога по умолчанию, убедитесь, что группа IIS_IUSRS имеет разрешение на запись в него. |
Enabled |
Значение для чтения и записи boolean . true Значение , если для веб-сайта включено ведение журнала; в противном случае — false. Значение по умолчанию — true. |
LocalTimeRollover |
Значение для чтения и записи boolean . true Значение , если новый файл журнала основан на местном времени; false Значение , если оно основано на формате UTC. Значение по умолчанию — false. |
LogExtFileFlags |
Значение для чтения и записи sint32 , содержащее маску, указывающую атрибуты, записываемые в файл журнала. Это свойство применяется только к ведению журнала в формате консорциума W3C. Возможные значения перечислены далее в разделе Примечания. |
LogFormat |
Перечисление для чтения и записи sint32 , задающее формат файла журнала. Возможные значения перечислены далее в разделе Примечания. |
Period |
Перечисление для чтения и записи sint32 , указывающее, как часто выполняется переключение содержимого файла журнала (т. е. текущий файл журнала закрывается и запускается новый файл журнала). Возможные значения перечислены далее в разделе Примечания. |
TruncateSize |
Значение для чтения и записи string , указывающее размер в байтах, при котором усекается содержимое файла журнала. Чтобы включить это свойство, задайте для значение PeriodMaxSize. Размер должен быть от 1048576 (1 мегабайт) до 4294967295 (4 гигабайта). Значение по умолчанию — 20971520 (20 мегабайт). |
используются подклассы ;
Этот класс не содержит подклассов.
Комментарии
Экземпляры этого класса содержатся в свойстве LogFileSite классов и SiteElementDefaults .
В следующей таблице перечислены возможные LogExtFileFlags значения для свойства . Атрибуты по умолчанию: , , , HttpSubStatus, MethodServerIP, ServerPort, Time, UriStemUriQuery, UserAgent, UserName, и Win32Status. HttpStatusDateClientIP
| Значение | Атрибут |
|---|---|
| 1 | Date |
| 2 | Time |
| 4 | ClientIP |
| 8 | UserName |
| 16 | SiteName |
| 32 | ComputerName |
| 64 | ServerIP |
| 128 | Method |
| 256 | 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 |
В следующей таблице перечислены возможные LogFormat значения для свойства . Значение по умолчанию — 2 (W3C).
| Значение | Ключевое слово | Описание |
|---|---|---|
| 0 | IIS |
Записи в файле журнала в формате IIS. Этот формат является фиксированным текстом ASCII и не настраивается. |
| 1 | NCSA |
Файл журнала записывается в общий формат файла журнала Национального центра суперкомпьютерных приложений (NCSA). Этот формат является фиксированным текстом ASCII и не настраивается. |
| 2 | W3C |
Записи файла журнала в формате расширенного журнала W3C. Этот формат имеет текст ASCII и настраивается. |
| 3 | Custom |
Файлы журнала записываются в пользовательском формате, определяемом пользователем. |
В следующей таблице перечислены возможные Period значения для свойства . Значение по умолчанию — 1 (Daily).
| Значение | Ключевое слово | Описание |
|---|---|---|
| 0 | MaxSize |
Файл журнала закрывается, и при достижении значения в TruncateSize запускается новый файл журнала. |
| 1 | Daily |
Файл журнала закрывается, а новый файл журнала запускается один раз в день. |
| 2 | Weekly |
Файл журнала закрывается, а новый файл журнала запускается один раз в неделю. |
| 3 | Monthly |
Файл журнала закрывается, а новый файл журнала запускается один раз в месяц. |
| 4 | Hourly |
Файл журнала закрывается, а новый файл журнала запускается один раз в час. |
Иерархия наследования
SiteLogFile
Требования
| Тип | Описание |
|---|---|
| клиент | — IIS 7.0 в Windows Vista — IIS 7.5 в Windows 7 — IIS 8.0 в Windows 8 — IIS 10.0 в Windows 10 |
| Сервер | — IIS 7.0 в Windows Server 2008 — IIS 7.5 в Windows Server 2008 R2 — IIS 8.0 в Windows Server 2012 — IIS 8.5 в Windows Server 2012 R2 — IIS 10.0 в Windows Server 2016 |
| Продукт | — IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| MOF-файл | WebAdministration.mof |
См. также:
Класс CentralBinaryLogFile
Класс CentralW3CLogFile
Класс EmbeddedObject
Класс LogSection
Класс сайта
Класс SiteElementDefaults
Форматы файлов журнала в IIS