Classe CentralBinaryLogFile1

Articolo
07/19/2023

Configura le impostazioni per la registrazione binaria centralizzata in un server.

Sintassi

class CentralBinaryLogFile : EmbeddedObject

Metodi

Questa classe non contiene metodi.

Proprietà

Nella tabella seguente sono elencate le proprietà esposte dalla CentralBinaryLogFile classe .

Nome	Descrizione
`Directory`	Valore di lettura/scrittura `string` che specifica la directory in cui scrivere le voci di log. Il valore predefinito è "%SystemDrive%\inetpub\logs\LogFiles".
`Enabled`	Valore di lettura/scrittura `boolean` . `true` se la registrazione binaria centralizzata è abilitata; in caso contrario, `false`. Il valore predefinito è `true`.
`LocalTimeRollover`	Valore di lettura/scrittura `boolean` . `true` se un nuovo file di log è basato sull'ora locale; `false` se si basa sull'ora UTC (Coordinated Universal Time). Il valore predefinito è `false`.
`Period`	Enumerazione di lettura/scrittura `sint32` che specifica la frequenza di chiusura del file di log corrente e l'avvio di un nuovo file di log. I valori possibili sono elencati più avanti nella sezione Osservazioni.
`TruncateSize`	Valore di lettura/scrittura `string` che specifica, in byte, le dimensioni in cui il contenuto del file di log deve essere troncato. Questo attributo deve essere configurato quando `Period` è impostato su `MaxSize`. Le dimensioni devono essere comprese tra 1048576 (1 megabyte) e 4294967295 (4 gigabyte). Il valore predefinito è 20971520 (20 megabyte).

Sottoclassi

Questa classe non contiene sottoclassi.

Commenti

Le istanze di questa classe sono contenute nella CentralBinaryLogFile proprietà della classe LogSection .

Nella tabella seguente sono elencati i valori possibili per la Period proprietà . Il valore predefinito è 1 (Daily).

Valore	Parola chiave	Descrizione
0	`MaxSize`	Il file di log viene chiuso e viene avviato un nuovo file di log quando viene raggiunto il valore in `TruncateSize` .
1	`Daily`	Il file di log viene chiuso e viene avviato un nuovo file di log una volta al giorno.
2	`Weekly`	Il file di log viene chiuso e viene avviato un nuovo file di log una volta alla settimana.
3	`Monthly`	Il file di log viene chiuso e viene avviato un nuovo file di log una volta al mese.
4	`Hourly`	Il file di log viene chiuso e viene avviato un nuovo file di log una volta all'ora.

Esempio

L'esempio di codice seguente imposta la modalità file di log su CentralBinary, abilita la registrazione binaria, imposta la Period proprietà su Weekly, specifica che i file di log usano l'ora locale e limitano le dimensioni del log a 1 gigabyte. Le funzioni helper visualizzano le impostazioni prima e dopo le modifiche apportate.

' 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

Gerarchia di ereditarietà

EmbeddedObject

CentralBinaryLogFile

Requisiti

Tipo	Descrizione
Client	- IIS 7.0 in Windows Vista - IIS 7.5 in Windows 7 - IIS 8.0 in Windows 8 - IIS 10.0 in Windows 10
Server	- IIS 7.0 in Windows Server 2008 - IIS 7.5 in Windows Server 2008 R2 - IIS 8.0 in Windows Server 2012 - IIS 8.5 in Windows Server 2012 R2 - IIS 10.0 in Windows Server 2016
Prodotto	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
File MOF	WebAdministration.mof

Vedere anche

Classe CentralW3CLogFile
Classe EmbeddedObject
Classe LogSection
Classe SiteLogFile

Condividi tramite