EventLog.ModifyOverflowPolicy(OverflowAction, Int32) Metoda

Definicja

Zmienia skonfigurowane zachowanie podczas 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 ustawiono wartość OverwriteOlder.

Atrybuty

Wyjątki

action jest nieprawidłową OverflowAction wartością.

retentionDays 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ę dzieje, 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, jak system operacyjny obsługuje nowe wpisy zapisane przez wszystkie źródła zdarzeń zarejestrowane w dzienniku zdarzeń.

action Ustaw parametr , aby wskazaćOverwriteAsNeeded, że nowy wpis zastępuje najstarszy wpis, gdy EventLog osiągnie maksymalny rozmiar. Jeśli parametr ma wartość OverwriteAsNeeded, wartość parametru retentionDays action jest ignorowana.

Ustaw parametr , action aby wskazać OverwriteOlder , że każdy nowy wpis zastępuje starsze wpisy, gdy EventLog osiągnie maksymalny rozmiar. Określ liczbę dni, w których zdarzenia muszą być przechowywane w dzienniku przy użyciu parametru retentionDays . Zdarzenia zapisane w zakresie przechowywania nie są zastępowane przez nowe wpisy.

Ustaw parametr , action aby odrzucić DoNotOverwrite nowe zdarzenia po osiągnięciu maksymalnego rozmiaru dziennika. Jeśli parametr ma wartość DoNotOverwrite, wartość parametru retentionDays action 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.

Dotyczy

Zobacz też