Write-Log

ÜBERSICHT

Schreibt eine Nachricht mit Zeitstempel in eine Logdatei mit automatischer Retry-Logik bei parallelen Schreibzugriffen.

SYNTAX

Write-Log [[-Message] <string>] [[-LogFile] <string>] [<CommonParameters>]

BESCHREIBUNG

Die Funktion `Write-Log` schreibt eine angegebene Nachricht mit einem vorangestellten Zeitstempel im Format `yyyy-MM-dd HH:mm:ss` in eine Logdatei. Um Konflikte bei parallelen Schreibzugriffen wie z.B. aus mehreren Jobs oder Prozessen, zu reduzieren. Entsprechend enthält die Funktion eine automatische Retry-Logik. Falls die Datei temporär gesperrt ist, versucht die Funktion bis zu 15-mal, die Nachricht erneut zu schreiben, mit einer zufälligen Verzögerung zwischen 50 und 250 Millisekunden zwischen den Versuchen.

Falls alle 15 Versuche fehlschlagen, wird eine Warnung über `Write-Warning` ausgegeben.

PARAMETER

-Message

Type: string

Der Text, der in die Logdatei geschrieben werden soll.

-LogFile

Type: string

Der vollständige Pfad zur Logdatei.

AUSGABEN

void

Keinen direkten Rückgabewert. Gibt Verbose-Nachrichten aus, wenn Retrys benötigt wurden, und eine Warnung, falls alle Retrys fehlschlagen.

BEISPIELE

# Schreibt den Eintrag "2025-06-23 10:20:30 - Prozess erfolgreich gestartet" in die Datei "app.log".
Write-Log -Message "Prozess erfolgreich gestartet" -LogFile "C:\Logs\app.log"

# Schreibt eine Nachricht in das Logfile und gibt zusätzlich die Anzahl der benötigten Retrys bei Konflikten über den Verbose-Stream aus.
Write-Log -Message "Fehler beim Zugriff auf die Datenbank" -LogFile $logPath -Verbose

HINWEISE

Geeignet für parallele Szenarien, insbesondere in Multi-Job-Umgebungen oder Skripten mit parallelen Prozessen.