Clase1 CentralBinaryLogFile
Configura las opciones para el registro binario centralizado en un servidor.
Sintaxis
class CentralBinaryLogFile : EmbeddedObject
Métodos
Esta clase no contiene métodos.
Propiedades
La siguiente tabla muestra las propiedades que expone la clase CentralBinaryLogFile.
| Nombre | Descripción |
|---|---|
Directory |
Un valor string de lectura y escritura que especifica el directorio en el que se deben escribir entradas de registro. El valor predeterminado es "%SystemDrive%\inetpub\logs\LogFiles". |
Enabled |
Valor boolean de lectura y escritura. true si está habilitado el registro binario centralizado; de lo contrario, es 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. |
Period |
Una enumeración sint32 de lectura y escritura que especifica la frecuencia con la que 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 |
Un valor string de lectura y escritura que especifica, en bytes, el tamaño en el que se debe truncar el contenido del archivo de registro. Este atributo debe configurarse cuando Period se establece 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 se encuentran en la propiedad CentralBinaryLogFile de la clase LogSection.
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. |
Ejemplo
En el ejemplo de código siguiente se establece el modo de archivo de registro en CentralBinary, se habilita el registro binario, se establece la propiedad Period en Weekly, se especifica que los archivos de registro usan la hora local y limita el tamaño del registro a 1 gigabyte. Las funciones auxiliares muestran la configuración antes y después de realizar los cambios.
' 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 CentralBinary.
oSection.CentralLogFileMode = 1
' Enable central binary logging.
oSection.CentralBinaryLogFile.Enabled = True
' Set local time rollover to true.
oSection.CentralBinaryLogFile.LocalTimeRollover = True
' Set the Period property to Weekly.
oSection.CentralBinaryLogFile.Period = 2
' Set the log truncate size to 1 gigabyte.
oSection.CentralBinaryLogFile.TruncateSize = 1073741824
' 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 binary log file properties.
Call ShowPropVals(oSection.CentralBinaryLogFile)
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
Jerarquía de herencia
CentralBinaryLogFile
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
Clase CentralW3CLogFile
Clase EmbeddedObject
Clase LogSection
Clase SiteLogFile