EventLog.ModifyOverflowPolicy(OverflowAction, Int32) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zmienia zachowanie skonfigurowane do zapisywania nowych wpisów, gdy dziennik zdarzeń osiągnie maksymalny rozmiar pliku.
public:
void ModifyOverflowPolicy(System::Diagnostics::OverflowAction action, int retentionDays);
public void ModifyOverflowPolicy (System.Diagnostics.OverflowAction action, int retentionDays);
[System.Runtime.InteropServices.ComVisible(false)]
public void ModifyOverflowPolicy (System.Diagnostics.OverflowAction action, int retentionDays);
member this.ModifyOverflowPolicy : System.Diagnostics.OverflowAction * int -> unit
[<System.Runtime.InteropServices.ComVisible(false)>]
member this.ModifyOverflowPolicy : System.Diagnostics.OverflowAction * int -> unit
Public Sub ModifyOverflowPolicy (action As OverflowAction, retentionDays As Integer)
Parametry
- action
- OverflowAction
Zachowanie przepełnienia podczas zapisywania nowych wpisów w dzienniku zdarzeń.
- retentionDays
- Int32
Minimalna liczba dni przechowywania każdego wpisu dziennika zdarzeń. Ten parametr jest używany tylko wtedy, gdy action
jest ustawiony na OverwriteOlderwartość .
- Atrybuty
Wyjątki
action
jest nieprawidłową OverflowAction wartością.
retentionDays
wartość jest mniejsza niż jedna lub większa niż 365.
Wartość Log nie jest prawidłową nazwą dziennika.
-lub-
Nie można otworzyć klucza rejestru dziennika zdarzeń na komputerze docelowym.
Przykłady
Poniższy przykład przedstawia skonfigurowane zasady przepełnienia dla określonego dziennika zdarzeń i umożliwia użytkownikowi wybranie nowego ustawienia zasad przepełnienia dla dziennika zdarzeń.
// Display the current event log overflow settings, and
// prompt the user to input a new overflow setting.
void ChangeEventLogOverflowAction( String^ logName )
{
if ( EventLog::Exists( logName ) )
{
// Display the current overflow setting of the
// specified event log.
EventLog^ inputLog = gcnew EventLog( logName );
Console::WriteLine( " Event log {0}", inputLog->Log );
OverflowAction logOverflow = inputLog->OverflowAction;
Int32 numDays = inputLog->MinimumRetentionDays;
Console::WriteLine( " Current overflow setting = {0}", logOverflow );
if ( logOverflow == OverflowAction::OverwriteOlder )
{
Console::WriteLine( "\t Entries are retained a minimum of {0} days.", numDays );
}
// Prompt user for a new overflow setting.
GetNewOverflowSetting( &logOverflow, &numDays );
// Change the overflow setting on the event log.
if ( logOverflow != inputLog->OverflowAction )
{
inputLog->ModifyOverflowPolicy( logOverflow, numDays );
Console::WriteLine( "Event log overflow policy was modified successfully!" );
}
else
{
Console::WriteLine( "Event log overflow policy was not modified." );
}
}
else
{
Console::WriteLine( "Event log {0} was not found.", logName );
}
}
// Display the current event log overflow settings, and
// prompt the user to input a new overflow setting.
public static void ChangeEventLogOverflowAction(String logName)
{
if (EventLog.Exists(logName))
{
// Display the current overflow setting of the
// specified event log.
EventLog inputLog = new EventLog(logName);
Console.WriteLine(" Event log {0}", inputLog.Log);
OverflowAction logOverflow = inputLog.OverflowAction;
Int32 numDays = inputLog.MinimumRetentionDays;
Console.WriteLine(" Current overflow setting = {0}",
logOverflow.ToString());
if (logOverflow == OverflowAction.OverwriteOlder)
{
Console.WriteLine("\t Entries are retained a minimum of {0} days.",
numDays.ToString());
}
// Prompt user for a new overflow setting.
GetNewOverflowSetting(ref logOverflow, ref numDays);
// Change the overflow setting on the event log.
if (logOverflow != inputLog.OverflowAction)
{
inputLog.ModifyOverflowPolicy(logOverflow, numDays);
Console.WriteLine("Event log overflow policy was modified successfully!");
}
else
{
Console.WriteLine("Event log overflow policy was not modified.");
}
}
else
{
Console.WriteLine("Event log {0} was not found.", logName);
}
}
' Display the current event log overflow settings, and
' prompt the user to input a new overflow setting.
Shared Sub ChangeEventLogOverflowAction(logName As String)
If EventLog.Exists(logName) Then
Dim inputLog As EventLog = New EventLog(logName)
Console.WriteLine(" Event log {0}", inputLog.Log)
Dim logOverflow As OverflowAction = inputLog.OverflowAction
Dim numDays As Int32 = inputLog.MinimumRetentionDays
Console.WriteLine(" Current overflow setting = {0}", _
logOverflow.ToString())
' Prompt user for a new overflow setting.
GetNewOverflowSetting(logOverflow, numDays)
If Not logOverflow = inputLog.OverflowAction Then
inputLog.ModifyOverflowPolicy(logOverflow, numDays)
Console.WriteLine("Event log overflow policy was modified successfully!")
Else
Console.WriteLine("Event log overflow policy was not modified.")
End If
Else
Console.WriteLine("Event log {0} was not found.", logName)
End If
End Sub
Uwagi
Zachowanie przepełnienia dziennika zdarzeń określa, co się stanie, gdy nowe wpisy mają być zapisywane w dzienniku, który osiągnął maksymalny rozmiar pliku.
Uwaga
Zachowanie przepełnienia ma zastosowanie tylko wtedy, gdy dziennik zdarzeń osiągnie maksymalny rozmiar pliku. Zachowanie przepełnienia nie ma wpływu na zapisywanie nowego wpisu w dzienniku, który może pomieścić dodatkowe wpisy dziennika zdarzeń.
Metoda ModifyOverflowPolicy konfiguruje zachowanie przepełnienia dziennika zdarzeń. EventLog Wystąpienie. Po wywołaniu tej metody dla dziennika zdarzeń określonego Log przez właściwość OverflowAction wartości właściwości i MinimumRetentionDays odzwierciedlają nowo skonfigurowane zachowanie przepełnienia.
Uwaga
Ta właściwość reprezentuje ustawienie konfiguracji dziennika zdarzeń reprezentowanego przez to wystąpienie. Gdy dziennik zdarzeń osiągnie maksymalny rozmiar, ta właściwość określa sposób obsługi nowych wpisów zapisywanych przez wszystkie źródła zdarzeń zarejestrowane w dzienniku zdarzeń.
Ustaw parametr , action
aby OverwriteAsNeeded wskazać, że nowy wpis zastępuje najstarszy wpis, gdy EventLog osiągnie maksymalny rozmiar. action
Jeśli parametr jest ustawiony na OverwriteAsNeededwartość , wartość parametru retentionDays
jest ignorowana.
Ustaw parametr na action
OverwriteOlder , aby wskazać, że każdy nowy wpis zastępuje starsze wpisy, gdy EventLog osiągnie maksymalny rozmiar. Określ liczbę dni przechowywania zdarzeń w dzienniku przy użyciu parametru retentionDays
. Zdarzenia zapisane w zakresie przechowywania nie są zastępowane przez nowe wpisy.
Ustaw parametr na wartość , action
aby DoNotOverwrite odrzucić nowe zdarzenia po osiągnięciu maksymalnego rozmiaru dziennika. action
Jeśli parametr jest ustawiony na DoNotOverwritewartość , wartość parametru retentionDays
jest ignorowana.
Przestroga
Ustawienie zasad przepełnienia w celu DoNotOverwrite określenia, że nowe wpisy są odrzucane, gdy dziennik zdarzeń jest pełny. Jeśli używasz tego ustawienia, upewnij się, że dziennik zdarzeń jest regularnie archiwizowany i czyszczone, aby uniknąć osiągnięcia maksymalnego limitu rozmiaru.