EventLog.ModifyOverflowPolicy-Methode

Das Überlaufverhalten für ein Ereignisprotokoll bestimmt das Verhalten beim Schreiben neuer Einträge in ein Protokoll, dessen maximale Dateigröße erreicht wurde.

Hinweis
Die Überlaufverhalten wird nur wirksam, wenn die maximale Dateigröße eines Ereignisprotokolls erreicht wird. Es wirkt sich nicht auf das Schreiben eines neues Eintrags in ein Protokoll aus, das zusätzliche Ereignisprotokolleinträge aufnehmen kann.

Die ModifyOverflowPolicy-Methode konfiguriert das Überlaufverhalten eines Ereignisprotokolls. EventLog-Instanz. Nach dem Aufruf dieser Methode für das durch die Log-Eigenschaft angegebene Ereignisprotokoll geben der OverflowAction-Eigenschaftswert und der MinimumRetentionDays-Eigenschaftswert das neu konfigurierte Überlaufverhalten wieder.

Hinweis
Bei dieser Eigenschaft handelt es sich um eine Konfigurationseinstellung für das Ereignisprotokoll, die durch diese Instanz dargestellt wird. Wenn die maximale Größe des Ereignisprotokolls erreicht wird, gibt diese Eigenschaft an, wie das Betriebssystem neue Einträge behandelt, die von allen für das Ereignisprotokoll registrierten Ereignisquellen geschrieben werden.

Legt den action-Parameter auf OverwriteAsNeeded fest, um anzugeben, dass ein neuer Eintrag den ältesten Eintrag überschreibt, wenn die maximale Größe des EventLog erreicht wird. Wenn der action-Parameter auf OverwriteAsNeeded festgelegt ist, wird der retentionDays-Parameterwert ignoriert.

Legt den action-Parameter auf OverwriteOlder fest, um anzugeben, dass jeder neue Eintrag einen älteren Eintrag überschreibt, wenn die maximale Größe des EventLog erreicht wird. Gibt mit dem retentionDays-Parameter die Anzahl von Tagen an, für die Ereignisse im Protokoll beibehalten werden müssen. Während des Beibehaltungszeitraums geschriebene Ereignisse werden nicht von neuen Einträgen überschrieben.

Legen Sie den action-Parameter auf DoNotOverwrite fest, wenn neue Ereignisse beim Erreichen der maximalen Protokollgröße verworfen werden sollen. Wenn der action-Parameter auf DoNotOverwrite festgelegt ist, wird der retentionDays-Parameterwert ignoriert.

Vorsicht
Durch Festlegen der Überlaufrichtlinie auf DoNotOverwrite wird angegeben, dass neue Einträge verworfen werden, wenn das Ereignisprotokoll voll ist. Stellen Sie bei Verwendung dieser Einstellung das regelmäßige Archivieren und Löschen des Ereignisprotokolls sicher, um zu vermeiden, dass seine Größenbeschränkung erreicht wird.

Im folgenden Beispiel wird die für ein bestimmtes Ereignisprotokoll konfigurierte Überlaufrichtlinie angezeigt und dem Benutzer die Möglichkeit gegeben, eine neue Überlaufrichtlinieneinstellung für das Ereignisprotokoll auswählen.

// 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);
    }
}

.NET Framework

.NET Framework Client Profile

• EventLogPermission  

  für das Verwalten von Ereignisprotokollinformationen auf dem Computer. Zugeordnete Enumeration: EventLogPermissionAccess.Administer

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

Referenz