SiteLogFile Class1
Configura el registro de un sitio web.
Sintaxis
class SiteLogFile : EmbeddedObject
Métodos
Esta clase no contiene métodos.
Propiedades
La siguiente tabla muestra las propiedades expuestas por la clase SiteLogFile
.
Nombre | Descripción |
---|---|
CustomLogPluginClsid |
Valor de lectura y escritura string que especifica el GUID de un módulo de complemento que se usa para el registro personalizado. El valor predeterminado es "FF160663-DE82-11CF-BC0A-00AA006111E0". |
Directory |
Valor de lectura y escritura string no vacío que especifica el nombre del directorio donde se almacenan los archivos de registro. El valor predeterminado es "%SystemDrive%\inetpub\logs\LogFiles". Nota: Si el grupo de IIS_IUSRS no tiene permiso para escribir en este directorio, no se generarán los registros. Si especifica un directorio distinto del valor predeterminado, asegúrese de que el grupo de IIS_IUSRS tiene permiso para escribir en él. |
Enabled |
Valor boolean de lectura y escritura. true si el registro de sitios está habilitado para un sitio web; de lo contrario, false . El valor predeterminado es true . |
LocalTimeRollover |
Valor boolean de lectura y escritura. true si un nuevo archivo de registro se basa en la hora local; false si se basa en la hora universal coordinada (UTC). El valor predeterminado es false . |
LogExtFileFlags |
Valor de lectura y escritura sint32 que contiene una máscara que especifica los atributos que se van a registrar en el archivo de registro. Esta propiedad solo se aplica al registro de formato World Wide Web Consortium (W3C). Los valores posibles se enumeran más adelante en la sección Comentarios. |
LogFormat |
Enumeración de lectura y escritura sint32 que especifica el formato del archivo de registro. Los valores posibles se enumeran más adelante en la sección Comentarios. |
Period |
Enumeración de lectura y escritura sint32 que especifica la frecuencia con la que se revierte el contenido del archivo de registro (es decir, se cierra el archivo de registro actual y se inicia un nuevo archivo de registro). Los valores posibles se enumeran más adelante en la sección Comentarios. |
TruncateSize |
Valor de lectura y escritura string que especifica el tamaño, en bytes, en el que se trunca el contenido del archivo de registro. Para habilitar esta propiedad, establezca Period en MaxSize . El tamaño debe estar entre 1 048 576 (1 megabyte) y 4 294 967 295 (4 gigabytes). El valor predeterminado es 20 971 520 (20 megabytes). |
Subclases
Esta clase no contiene subclases.
Comentarios
Las instancias de esta clase están contenidas en la propiedad LogFile
de las clases Site
y SiteElementDefaults
.
En la siguiente tabla se describen los posibles valores de la propiedad LogExtFileFlags
. Los atributos predeterminados son ClientIP
, Date
, HttpStatus
, HttpSubStatus
, Method
, ServerIP
, ServerPort
, Time
, UriQuery
, UriStem
, UserAgent
, UserName
y Win32Status
.
Valor | Attribute |
---|---|
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 |
En la siguiente tabla se describen los posibles valores de la propiedad LogFormat
. El valor predeterminado es 2 (W3C
).
Valor | Palabra clave | Descripción |
---|---|---|
0 | IIS |
Los registros del archivo de registro en formato IIS. Este formato es texto ASCII fijo y no es personalizable. |
1 | NCSA |
Los registros de archivos de registro en el formato de archivo de registro común del National Center for Supercomputing Applications (NCSA). Este formato es texto ASCII fijo y no es personalizable. |
2 | W3C |
Registros del archivo de registro en formato de archivo de registro extendido W3C. Este formato está en texto ASCII y es personalizable. |
3 | Custom |
Los registros del archivo de registro en un formato personalizado decidido por el usuario. |
En la siguiente tabla se describen los posibles valores de la propiedad Period
. El valor predeterminado es 1 (Daily
).
Valor | Palabra clave | Descripción |
---|---|---|
0 | MaxSize |
El archivo de registro se cierra y se inicia uno nuevo cuando se alcanza el valor TruncateSize . |
1 | Daily |
El archivo de registro se cierra y se inicia uno nuevo una vez al día. |
2 | Weekly |
El archivo de registro se cierra y se inicia uno nuevo una vez a la semana. |
3 | Monthly |
El archivo de registro se cierra y se inicia uno nuevo una vez al mes. |
4 | Hourly |
El archivo de registro se cierra y se inicia uno nuevo una vez a la hora. |
Jerarquía de herencia
SiteLogFile
Requisitos
Tipo | Descripción |
---|---|
Remoto | - IIS 7.0 en Windows Vista - IIS 7.5 en Windows 7 - IIS 8.0 en Windows 8 - IIS 10.0 en Windows 10 |
Server | - IIS 7.0 en Windows Server 2008 - IIS 7.5 en Windows Server 2008 R2 - IIS 8.0 en Windows Server 2012 - IIS 8.5 en Windows Server 2012 R2 - IIS 10.0 en Windows Server 2016 |
Producto | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
Archivo MOF | WebAdministration.mof |
Consulte también
CentralBinaryLogFile Class
CentralW3CLogFile Class
EmbeddedObject Class
LogSection Class
Clase de sitio
SiteElementDefaults Class
Formatos de archivo de registro en IIS