# Convert-DNSDebugLogFile LLMS index: [llms.txt](/llms.txt) --- ## SYNOPSIS Wandelt Windows DNS-Server-Debugprotokolle in ein strukturiertes CSV-Format zur Analyse und Berichterstellung um. ## SYNTAX ### __AllParameterSets ``` Convert-DNSDebugLogFile [-InputFile] [[-OutputFile] ] [[-Delimiter] ] [[-ComputerName] ] [[-OutputType] ] [[-ContextFilter] ] [[-InputCulture] ] [[-OutputCulture] ] [-SkipHeaderValidation] [-RemoveSourceFile] [-CompressOutput] [-NoDetailsParsing] [-WhatIf] [-Confirm] ``` ## ALIASES Dieses Cmdlet hat folgende Aliase, ## BESCHREIBUNG Konvertiert Windows DNS-Server-Debugprotokolldateien in strukturierte CSV-Daten, die in Excel, Power BI, SQL-Datenbanken oder SIEM-Tools analysiert werden können. Entwickelt für Sicherheitsanalysen, Leistungsüberwachung, Fehlerbehebung und Compliance-Berichte. Das Cmdlet analysiert DNS-Debugprotokolle und schreibt eine konsistente CSV-Ausgabe zur Analyse. Die CSV-Ausgabe enthält 18 Spalten, darunter eine `Information`-Spalte für Ereignis-/Diagnosetexte, eine optionale `Details`-JSON-Spalte für Paket-Detailblöcke und eine stets vorhandene `ComputerName`-Spalte (leer, sofern nicht angegeben). WICHTIGE FUNKTIONEN: - Streaming-Verarbeitung vermeidet das Laden der gesamten Datei in den Speicher (geeignet für sehr große Protokolle) - Hochleistungs-Parsing optimiert für große Dateien (100MB+) - Anpassbarer CSV-Trennzeichen (Standard: Semikolon) - Optionale statistische Zusammenfassungen mit aggregierten Metriken - Kontextfilterung (Packet, Event, Note und weitere Kontexte) zur Fokussierung auf bestimmte Protokolleintragstypen - Kulturabhängiges Datumsparsing und -formatierung für internationale Server - Pipeline-Unterstützung für die Stapelverarbeitung mehrerer Dateien - Optionale Komprimierung der Ausgabedateien (ZIP-Format) - Optionale automatische Entfernung der Quelldateien nach der Verarbeitung - Kopfzeilenvalidierung zur Sicherstellung der Datenintegrität AUSGABEFORMAT: Die Spalte ComputerName ist immer am Ende jedes Datensatzes enthalten. Wenn der Parameter -ComputerName nicht angegeben wird, bleibt die Spalte leer. Dies gewährleistet eine konsistente Ausgabestruktur für Multi-Server-Konsolidierungsszenarien. LEISTUNG: Optimiert durch StreamReader/StreamWriter mit 64KB-Puffern, Streaming-Verarbeitung für speichereffiziente Handhabung großer Dateien, String-Operationen statt Regex, manuelle CSV-Erzeugung und effiziente Hashtable-basierte Statistik-Erfassung. KOMPATIBILITÄT: - PowerShell 5.1+ (Desktop- und Core-Editionen) - Windows Server 2016+ - DNS Server 2012 R2 bis 2025 Logformate ## BEISPIELE ### BEISPIEL 1 ```powershell PS C:\> Convert-DNSDebugLogFile -InputFile "C:\Logs\dns.log" ``` Konvertiert das DNS-Debugprotokoll mit Standardeinstellungen (Daten- und Statistikdateien mit Semikolon als Trennzeichen). Ausgabe: - C:\Logs\dns.csv - C:\Logs\dns_Statistic.csv - C:\Logs\dns_PacketStatistic.csv ### BEISPIEL 2 ```powershell PS C:\> Convert-DNSDebugLogFile -InputFile "C:\Logs\dns.log" -OutputType CSV ``` Erzeugt nur die Datendatei ohne Statistiken. Ausgabe: C:\Logs\dns.csv ### BEISPIEL 3 ```powershell PS C:\> Convert-DNSDebugLogFile -InputFile "C:\Logs\dns.log" -OutputType Statistic ``` Erzeugt nur die Statistikdateien mit aggregierten Metriken. Ausgabe: - C:\Logs\dns_Statistic.csv - C:\Logs\dns_PacketStatistic.csv ### BEISPIEL 4 ```powershell PS C:\> Convert-DNSDebugLogFile -InputFile "C:\Logs\dns.log" -OutputFile "C:\Output\parsed.csv" ``` Konvertiert das Protokoll an einen benutzerdefinierten Speicherort. Ausgabe: C:\Output\parsed.csv ### BEISPIEL 5 ```powershell PS C:\> Convert-DNSDebugLogFile -InputFile "C:\Logs\dns.log" -Delimiter "," -ComputerName "DNS01" -OutputType Both ``` Konvertiert mit Komma als Trennzeichen und fügt die Spalte ComputerName mit dem Wert "DNS01" hinzu. Ausgabe: - C:\Logs\dns.csv - C:\Logs\dns_Statistic.csv - C:\Logs\dns_PacketStatistic.csv ### BEISPIEL 6 ```powershell PS C:\> Get-ChildItem "C:\Logs\*.log" | Convert-DNSDebugLogFile -OutputType Both ``` Batch-Verarbeitung mehrerer DNS-Debugprotokolldateien über die Pipeline. Ausgabe: Für jede .log-Datei werden .csv- und _statistic.csv-Dateien erzeugt. ### BEISPIEL 7 ```powershell PS C:\> Convert-DNSDebugLogFile -InputFile "C:\Logs\dns.log" -CompressOutput ``` Konvertiert und komprimiert die Ausgabe in ein ZIP-Archiv. Ausgabe: C:\Logs\dns.zip (enthält dns.csv + Statistikdateien) ### BEISPIEL 8 ```powershell PS C:\> Convert-DNSDebugLogFile -InputFile "C:\Logs\dns.log" -RemoveSourceFile -Verbose ``` Konvertiert das Protokoll und entfernt die Quelldatei nach erfolgreicher Verarbeitung. Verbose-Ausgabe bestätigt die Dateientfernung. ### BEISPIEL 9 ```powershell PS C:\> Convert-DNSDebugLogFile -InputFile "C:\Logs\dns.log" -InputCulture 'de-DE' -OutputCulture 'en-US' ``` Parst deutsches Datumsformat (TT.MM.JJJJ) und gibt im US-Format (MM/TT/JJJJ) aus. Nützlich bei der Verarbeitung von Protokollen von Servern mit unterschiedlichen Regionaleinstellungen. ### BEISPIEL 10 ```powershell PS C:\> Convert-DNSDebugLogFile -InputFile "C:\Logs\dns.log" -ContextFilter 'Packet' ``` Konvertiert nur DNS-Abfrage-/Antwortpakete, schließt EVENT- und Note-Einträge aus. Nützlich, um die Analyse auf den tatsächlichen DNS-Verkehr zu fokussieren. ### BEISPIEL 11 ```powershell PS C:\> Convert-DNSDebugLogFile -InputFile "C:\Logs\dns.log" -ContextFilter 'Packet','Event' ``` Konvertiert sowohl DNS-Abfrage-/Antwortpakete als auch Serverereignisse, schließt Note- und andere Einträge aus. Nützlich zur Analyse von DNS-Verkehr zusammen mit Serverereignissen. ### BEISPIEL 12 ```powershell PS C:\> Get-ChildItem "C:\Logs\*.log" | Convert-DNSDebugLogFile -RemoveSourceFile -CompressOutput ``` Automatisierte Protokollarchivierung: verarbeitet alle Protokolle, komprimiert die Ausgabe und entfernt die Quelldateien. Ideal für geplante Protokollverarbeitungspipelines. ### BEISPIEL 13 ```powershell PS C:\> Convert-DNSDebugLogFile -InputFile "C:\Logs\large-dns.log" -NoDetailsParsing ``` Verarbeitet eine große Protokolldatei mit deaktiviertem Detail-Parsing für maximale Leistung. PACKET-Detailblöcke werden übersprungen, die Details-Spalte bleibt leer. Nützlich bei sehr großen Dateien, wenn die detaillierte Paketstruktur nicht benötigt wird. ## PARAMETER ### -CompressOutput Komprimiert die ausgegebenen CSV-Dateien nach der Erstellung in ein ZIP-Archiv. Erstellt eine .zip-Datei mit den generierten CSV-Dateien und entfernt anschließend die unkomprimierten CSV(s). Die ZIP-Datei wird im selben Verzeichnis wie die Ausgabedatei mit demselben Basisnamen erstellt. Vorteile: - Reduziert den Speicherplatzbedarf erheblich (CSV-Dateien komprimieren sich typischerweise um 90%+) - Vereinfacht Dateiverwaltung und Archivierung - Geeignet für Langzeitspeicherung Beispiel: Eingabedatei 'dns.log' erzeugt 'dns.csv', die zu 'dns.zip' komprimiert wird, danach wird 'dns.csv' entfernt. ```yaml Type: SwitchParameter DefaultValue: False SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` ### -ComputerName Legt den Wert für die Spalte ComputerName in der CSV-Ausgabe fest. Die Spalte ComputerName ist immer in der Ausgabe enthalten – wenn dieser Parameter nicht angegeben wird, bleibt die Spalte leer. Verwende dies bei der Konsolidierung von Protokollen mehrerer DNS-Server, um die Quelle in kombinierten Datensätzen zu identifizieren. Hinweis: Dies ist kein Remoting-Parameter. Er kennzeichnet nur die Ausgabe. Wenn du -InputFile auf einen UNC-Pfad setzt, wird die Datei von diesem Pfad gelesen (keine WinRM-/Remote-Ausführung). ```yaml Type: String DefaultValue: '' SupportsWildcards: false Aliases: - Server - DNSServer - HostName ParameterSets: - Name: (All) Position: 3 IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` ### -Confirm Fordert vor Ausführung des Cmdlets eine Bestätigung an. Wenn angegeben, wird vor Folgendem um Bestätigung gebeten: - Verarbeitung jeder DNS-Debugprotokolldatei - Entfernen von Quelldateien (bei Angabe von -RemoveSourceFile) - Überschreiben vorhandener Ausgabedateien Nützlich bei interaktiver Verarbeitung, wenn du steuern möchtest, welche Dateien verarbeitet werden. ```yaml Type: SwitchParameter DefaultValue: '' SupportsWildcards: false Aliases: - cf ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` ### -ContextFilter Filtert, welche Protokolleintragstypen in die Ausgabe aufgenommen werden. Akzeptiert einzelne oder mehrere Werte. DNS-Debugprotokolle enthalten verschiedene Kontexttypen: - PACKET: DNS-Abfrage- und Antwortpaketinformationen (primäre Daten) - EVENT: DNS-Serverereignisse (z.B. "Der DNS-Server wurde gestartet.") - Note: Diagnosenotizen und Warnungen (z.B. Socket-Fehler, interne Zustände) - DSPoll, Init, Lookup, Recurse, Remote, Tombstone: Weitere Kontexttypen Gültige Werte: - 'All': Alle Kontexttypen einschließen (Standard) - 'Packet': Nur PACKET-Einträge einschließen (DNS-Abfragen/-Antworten) - 'Event': Nur EVENT-Einträge einschließen (Serverereignisse) - 'Note': Nur Note-Einträge einschließen (Diagnoseinformationen) - Beliebige Kombination: Mehrere Werte angeben, um spezifische Kontexttypen einzuschließen Standard: All Beispiele: - 'Packet' filtert nur DNS-Verkehr - 'Packet','Event' umfasst DNS-Verkehr und Serverereignisse - 'Note','Event' umfasst Diagnosenotizen und Serverereignisse Hinweis: Bei Filterung auf 'Event' oder 'Note' enthalten nur die Spalten DateTime, ThreadId, Context und Information Daten. Andere Spalten (Protokoll, ClientIP usw.) bleiben leer. ```yaml Type: String[] DefaultValue: "@('All')" SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: 5 IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` ### -Delimiter Legt das Trennzeichen für die CSV-Ausgabe fest. Standard: Semikolon (;) Gängige Alternativen: Komma (,), Tabulator (`t), Pipe (|) Verwende Semikolon in Regionen, in denen Komma als Dezimaltrennzeichen verwendet wird (Europa). Verwende Komma für Standard-CSV-Tools und Datenbanken, die komma-getrennte Werte erwarten. ```yaml Type: String DefaultValue: ; SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: 2 IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` ### -InputCulture Legt die Kultur/Region fest, die zum Parsen von Datums-/Uhrzeitwerten im DNS-Debugprotokoll verwendet wird. DNS-Server-Debugprotokolle verwenden das Datumsformat der Windows-Region auf dem Server, auf dem das Protokoll erstellt wurde. Verwende diesen Parameter bei der Verarbeitung von Protokollen von Servern mit unterschiedlichen Regionaleinstellungen. Standard: Aktuelle Kultur Gängige Beispiele: - 'de-DE' oder 'de-AT': Deutsches Format (TT.MM.JJJJ oder TT/MM/JJJJ) - 'en-US': US-Format (MM/TT/JJJJ mit AM/PM) - 'en-GB': UK-Format (TT/MM/JJJJ mit 24-Stunden-Zeit) - 'sv-SE': Schwedisches/ISO-Format (JJJJ-MM-TT) ```yaml Type: CultureInfo DefaultValue: '[System.Globalization.CultureInfo]::CurrentCulture' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: 6 IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` ### -InputFile Legt den Pfad zur zu parsenden DNS-Debugprotokolldatei fest. Unterstützt Arrays zur Verarbeitung mehrerer Dateien. Akzeptiert Pipeline-Eingaben von Get-ChildItem oder anderen Cmdlets, die Dateien liefern. ```yaml Type: String[] DefaultValue: '' SupportsWildcards: false Aliases: - FullName - FilePath - InputPath - File - Path ParameterSets: - Name: (All) Position: 0 IsRequired: true ValueFromPipeline: true ValueFromPipelineByPropertyName: true ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` ### -NoDetailsParsing Überspringt das Parsen von PACKET-Detailblöcken in ein strukturiertes JSON-Format. Wenn angegeben, enthalten PACKET-Datensätze mit Detailblöcken nur die TCP/UDP-Infozeile in der Spalte Information, während die Spalte Details leer bleibt. Dies verbessert die Verarbeitungsleistung bei großen Protokolldateien erheblich, wenn keine detaillierte Paketstruktur-Analyse benötigt wird. Verwende diesen Schalter, wenn: - Sehr große Protokolldateien (100MB+) verarbeitet werden und nur Basisabfrageinformationen benötigt werden - Die Detailstruktur (Nachrichtenflags, DNS-Abschnitte) für die Analyse nicht erforderlich ist - Die maximale Parsing-Geschwindigkeit wichtiger ist als die Vollständigkeit der Daten Leistungsverbesserung: Kann die Verarbeitungsgeschwindigkeit um 30-50% bei Protokollen mit vielen PACKET-Detailblöcken steigern. ```yaml Type: SwitchParameter DefaultValue: False SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` ### -OutputCulture Legt die Kultur/Region fest, die zum Formatieren von Datums-/Uhrzeitwerten in den Ausgabedateien verwendet wird. Steuert, wie DateTime-Werte in die CSV geschrieben werden. Verwende dies, wenn CSV-Dateien von Anwendungen oder Systemen mit spezifischen Regionaleinstellungen genutzt werden. Standard: Aktuelle Kultur Gängige Beispiele: - 'en-US': US-Format (MM/TT/JJJJ) - 'de-DE': Deutsches Format (TT.MM.JJJJ) - 'sv-SE' oder InvariantCulture: ISO-Format (JJJJ-MM-TT) für maximale Kompatibilität ```yaml Type: CultureInfo DefaultValue: '[System.Globalization.CultureInfo]::CurrentCulture' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: 7 IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` ### -OutputFile Legt den Pfad für die Ausgabedatei im CSV-Format fest. Wenn nicht angegeben, wird der Eingabedateiname mit der Erweiterung .csv im selben Verzeichnis wie die Eingabedatei verwendet. Wichtig: Muss ein Dateipfad sein, kein Verzeichnis. Wenn du das Verzeichnis der Eingabedatei mit einem benutzerdefinierten Namen verwenden möchtest, gib den vollständigen Pfad inklusive Dateiname an. ```yaml Type: String DefaultValue: '' SupportsWildcards: false Aliases: - Output - Destination - OutFile - OutputPath ParameterSets: - Name: (All) Position: 1 IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` ### -OutputType Legt fest, welche Art von Ausgabe erzeugt wird. Gültige Werte: - 'CSV': Nur die Datendatei mit allen geparsten Protokolleinträgen erzeugen - 'Statistic': Nur die Statistikdateien mit aggregierten Metriken erzeugen - 'Both': Sowohl Daten- als auch Statistikdateien erzeugen (Standard) Standard: Both Wenn Statistiken erzeugt werden, entstehen zwei separate Dateien: - '_Statistic.csv': Zusammenfassende Zählungen pro Kontexttyp und Tag (Datum, Kontext, Anzahl, ComputerName) - '_PacketStatistic.csv': Detaillierte PACKET-Zählungen pro Tag nach Client-IP, Protokoll, Richtung und Abfragetyp (Datum, ClientIP, Protokoll, Richtung, FrageTyp, Anzahl, ComputerName) ```yaml Type: String DefaultValue: Both SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: 4 IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` ### -RemoveSourceFile Entfernt die Quell-DNS-Debugprotokolldatei nach erfolgreicher Verarbeitung. Verwende dies für automatisierte Protokollverarbeitungspipelines oder zur Speicherplatzverwaltung. Die Quelldatei wird nur entfernt, wenn die Verarbeitung erfolgreich abgeschlossen wurde und alle Ausgabedateien erstellt sind. Sicherheit: Kann nicht zusammen mit -SkipHeaderValidation verwendet werden, um versehentliches Löschen ungültiger Dateien zu verhindern. Warnung: Quelldateien werden dauerhaft gelöscht. Stelle sicher, dass die Ausgabedateien gültig sind, bevor du diese Option verwendest. ```yaml Type: SwitchParameter DefaultValue: False SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` ### -SkipHeaderValidation Umgeht die Validierung der DNS-Debugprotokoll-Kopfzeile. Standardmäßig prüft das Cmdlet, ob Eingabedateien eine gültige DNS-Server-Debugprotokoll-Kopfzeile besitzen. Verwende diesen Schalter, um Dateien ohne Validierung zu verarbeiten, was nützlich sein kann bei: - Modifizierten oder benutzerdefinierten Protokollformaten - Fehlerbehebung bei Validierungsproblemen - Nicht standardmäßigen oder vorverarbeiteten Protokollen Warnung: Kann zu Verarbeitungsfehlern führen, wenn die Datei kein gültiges DNS-Protokoll ist. ```yaml Type: SwitchParameter DefaultValue: False SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` ### -WhatIf Zeigt an, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt. Wenn angegeben, werden detaillierte Informationen über die auszuführenden Operationen angezeigt, ohne diese tatsächlich auszuführen. Nützlich für: - Vorschau, welche Dateien verarbeitet würden - Überprüfung der Ausgabepfade vor der Verarbeitung - Testen von Skripten vor dem produktiven Einsatz ```yaml Type: SwitchParameter DefaultValue: '' SupportsWildcards: false Aliases: - wi ParameterSets: - Name: (All) Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` ### CommonParameters Dieses Cmdlet unterstützt die Common-Parameter: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ## EINGABEN ### System.String[] ## HINWEISE Version : 1.7.2.1 Autor : Andi Bellstedt, Copilot, Patrick Charbonnier (Silent Waters IT Consulting S.L.) Datum : 2026-07-24 Schlüsselwörter : Microsoft Windows Server, DNSServer, DNS, DebugLog, LogParser ## VERWANDTE LINKS - [github.com/AndiBellstedt/DNSServer.DebugLogParser](https://github.com/AndiBellstedt/DNSServer.DebugLogParser)