4.1 - Convert-DNSDebugLogFile
SYNOPSIS
Trasforma i log di debug del server DNS di Windows in un formato CSV strutturato per analisi e reportistica.
SYNTAX
__AllParameterSets
Convert-DNSDebugLogFile [-InputFile] <string[]> [[-OutputFile] <string>] [[-Delimiter] <string>]
[[-ComputerName] <string>] [[-OutputType] <string>] [[-ContextFilter] <string>]
[[-InputCulture] <cultureinfo>] [[-OutputCulture] <cultureinfo>] [-SkipHeaderValidation]
[-RemoveSourceFile] [-CompressOutput] [-WhatIf] [-Confirm] [<CommonParameters>]
ALIASES
Questo cmdlet ha i seguenti alias,
DESCRIPTION
Converte i file di log di debug del server DNS di Windows in dati CSV strutturati che possono essere analizzati in Excel, Power BI, database SQL o strumenti SIEM. Progettato per analisi di sicurezza, monitoraggio delle prestazioni, risoluzione dei problemi e reportistica di conformità.
Il cmdlet analizza tutti i 17 campi dei log di debug DNS inclusi data/ora, protocollo, IP client, tipo di query, nomi di dominio, codici di risposta, flag, informazioni sugli eventi e nome del computer. Genera un output CSV strutturato con un riepilogo statistico opzionale che aggrega l’attività per client, protocollo e tipo di query.
CARATTERISTICHE PRINCIPALI:
- Parsing ad alte prestazioni ottimizzato per file di grandi dimensioni (oltre 100MB)
- Delimitatore CSV personalizzabile (default: punto e virgola)
- Riepiloghi statistici opzionali con metriche aggregate
- Filtro di contesto (PACKET, EVENT, Note) per focalizzarsi su tipi specifici di voci di log
- Parsing e formattazione delle date sensibili alla cultura per server internazionali
- Supporto pipeline per elaborazione batch di più file
- Compressione opzionale dei file di output (formato ZIP)
- Rimozione automatica opzionale dei file sorgente dopo l’elaborazione
- Validazione dell’intestazione per garantire l’integrità dei dati
FORMATO DI OUTPUT:
La colonna ComputerName è sempre inclusa alla fine di ogni record. Se il parametro -ComputerName non è specificato, la colonna sarà vuota. Questo garantisce una struttura di output coerente per scenari di consolidamento multi-server.
PRESTAZIONI:
Ottimizzato usando StreamReader/StreamWriter con buffer da 64KB, operazioni su stringhe invece di regex, generazione manuale del CSV e raccolta efficiente delle statistiche basata su hashtable.
COMPATIBILITÀ:
- PowerShell 5.1+ (edizioni Desktop e Core)
- Windows Server 2016+
- Formati di log DNS Server da 2012 R2 fino al 2025
EXAMPLES
ESEMPIO 1
PS C:\> Convert-DNSDebugLogFile -InputFile "C:\Logs\dns.log"
Converte il log di debug DNS usando le impostazioni predefinite (sia file dati che statistici con delimitatore punto e virgola).
Output: C:\Logs\dns.csv e C:\Logs\dns_statistic.csv
ESEMPIO 2
PS C:\> Convert-DNSDebugLogFile -InputFile "C:\Logs\dns.log" -OutputType CSV
Genera solo il file dati senza statistiche.
Output: C:\Logs\dns.csv
ESEMPIO 3
PS C:\> Convert-DNSDebugLogFile -InputFile "C:\Logs\dns.log" -OutputType Statistic
Genera solo il file delle statistiche con metriche aggregate.
Output: C:\Logs\dns_statistic.csv
ESEMPIO 4
PS C:\> Convert-DNSDebugLogFile -InputFile "C:\Logs\dns.log" -OutputFile "C:\Output\parsed.csv"
Converte il log in una posizione di output personalizzata.
Output: C:\Output\parsed.csv
ESEMPIO 5
PS C:\> Convert-DNSDebugLogFile -InputFile "C:\Logs\dns.log" -Delimiter "," -ComputerName "DNS01" -OutputType Both
Converte con delimitatore virgola e aggiunge la colonna ComputerName con valore “DNS01”.
Output: C:\Logs\dns.csv e C:\Logs\dns_statistic.csv con colonna ComputerName
ESEMPIO 6
PS C:\> Get-ChildItem "C:\Logs\*.log" | Convert-DNSDebugLogFile -OutputType Both
Elabora in batch più file di log di debug DNS tramite pipeline.
Output: Per ogni file .log genera file .csv e _statistic.csv
ESEMPIO 7
PS C:\> Convert-DNSDebugLogFile -InputFile "C:\Logs\dns.log" -CompressOutput
Converte e comprime l’output in un archivio ZIP.
Output: C:\Logs\dns.zip (contenente dns.csv e dns_statistic.csv)
ESEMPIO 8
PS C:\> Convert-DNSDebugLogFile -InputFile "C:\Logs\dns.log" -RemoveSourceFile -Verbose
Converte il log e rimuove il file sorgente dopo l’elaborazione riuscita.
L’output Verbose conferma la rimozione del file.
ESEMPIO 9
PS C:\> Convert-DNSDebugLogFile -InputFile "C:\Logs\dns.log" -InputCulture 'de-DE' -OutputCulture 'en-US'
Analizza il formato data tedesco (GG.MM.AAAA) e produce output in formato USA (MM/GG/AAAA).
Usa quando si elaborano log da server con impostazioni regionali diverse.
ESEMPIO 10
PS C:\> Convert-DNSDebugLogFile -InputFile "C:\Logs\dns.log" -ContextFilter 'Packet'
Converte solo le voci di pacchetto query/risposta DNS, escludendo EVENT e Note.
Usa per focalizzare l’analisi sul traffico DNS effettivo.
ESEMPIO 11
PS C:\> Get-ChildItem "C:\Logs\*.log" | Convert-DNSDebugLogFile -RemoveSourceFile -CompressOutput
Archiviazione automatica dei log: elabora tutti i log, comprime l’output e rimuove i file sorgente.
Ideale per pipeline di elaborazione log pianificate.
PARAMETERS
-CompressOutput
Comprimi i file CSV di output in un archivio ZIP dopo la creazione.
Crea un file .zip contenente il/i file CSV generato/i, quindi rimuove il/i CSV non compressi.
Il file ZIP viene creato nella stessa directory del CSV di output con lo stesso nome base.
Vantaggi:
- Riduce significativamente lo spazio su disco (i file CSV si comprimono tipicamente oltre il 90%)
- Semplifica la gestione e l’archiviazione dei file
- Adatto per l’archiviazione a lungo termine
Esempio: l’input ‘dns.log’ genera ‘dns.csv’ compresso in ‘dns.zip’, quindi ‘dns.csv’ viene rimosso.
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
Specifica il valore per la colonna ComputerName nell’output CSV.
La colonna ComputerName è sempre presente nell’output; se questo parametro non è specificato, la colonna sarà vuota.
Usalo quando consolidi log da più server DNS per identificare il server di origine nei dataset combinati.
Nota: NON è un parametro di remoting.
Il cmdlet elabora solo file locali.
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
Richiede conferma prima di eseguire il cmdlet.
Se specificato, chiede conferma prima di:
- Elaborare ogni file di log di debug DNS
- Rimuovere i file sorgente (quando specificato -RemoveSourceFile)
- Sovrascrivere file di output esistenti
Utile per elaborazioni interattive quando vuoi controllare quali file vengono processati.
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
Filtra quali tipi di voci di log includere nell’output.
I log di debug DNS contengono diversi tipi di contesto:
- PACKET: informazioni su pacchetti query e risposta DNS (dati principali)
- EVENT: eventi del server DNS (es. “Il server DNS è stato avviato.”)
- Note: note diagnostiche e avvisi (es. errori di socket, stati interni)
Valori validi:
- ‘All’: include tutti i tipi di contesto (default)
- ‘Packet’: include solo le voci PACKET (query/risposte DNS)
- ‘Event’: include solo le voci EVENT (eventi server)
- ‘Note’: include solo le voci Note (informazioni diagnostiche)
Default: All
Nota: filtrando su ‘Event’ o ‘Note’, solo le colonne DateTime, ThreadId, Context e Information conterranno dati.
Le altre colonne (Protocol, ClientIP, ecc.) saranno vuote.
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
Specifica il carattere delimitatore per l’output CSV.
Default: punto e virgola (;)
Alternative comuni: virgola (,), tab (`t), pipe (|)
Usa il punto e virgola nelle regioni dove la virgola è il separatore decimale (Europa).
Usa la virgola per strumenti CSV standard e database che si aspettano valori separati da virgola.
Type: String
DefaultValue: ;
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: 2
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Specifica la cultura/locale da usare per il parsing dei valori data/ora nel log di debug DNS.
I log di debug DNS usano il formato data della locale Windows sul server dove il log è stato generato.
Usa questo parametro quando elabori log da server con impostazioni regionali diverse.
Default: cultura corrente
Esempi comuni:
- ‘de-DE’ o ‘de-AT’: formato tedesco (GG.MM.AAAA o GG/MM/AAAA)
- ’en-US’: formato USA (MM/GG/AAAA con AM/PM)
- ’en-GB’: formato UK (GG/MM/AAAA con orario 24h)
- ‘sv-SE’: formato svedese/ISO (AAAA-MM-GG)
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: ''
Specifica il percorso del file di log di debug DNS da analizzare.
Supporta array per elaborare più file.
Accetta input dalla pipeline da Get-ChildItem o altri cmdlet che producono file.
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: ''
-OutputCulture
Specifica la cultura/locale da usare per formattare i valori data/ora nei file CSV di output.
Controlla come i valori DateTime sono scritti nel CSV.
Usa questo parametro quando i file CSV saranno consumati da applicazioni o sistemi con impostazioni regionali specifiche.
Default: cultura corrente
Esempi comuni:
- ’en-US’: formato USA (MM/GG/AAAA)
- ‘de-DE’: formato tedesco (GG.MM.AAAA)
- ‘sv-SE’ o InvariantCulture: formato ISO (AAAA-MM-GG) per massima compatibilità
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
Specifica il percorso del file CSV di output.
Se non specificato, usa il nome del file di input con estensione .csv nella stessa directory del file di input.
Importante: deve essere un percorso file, non una directory.
Se vuoi usare la directory del file di input con un nome personalizzato, specifica il percorso completo incluso il nome file.
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
Specifica il tipo di output da generare.
Valori validi:
- ‘CSV’: genera solo il file dati con tutte le voci di log analizzate (default)
- ‘Statistic’: genera solo il file delle statistiche con metriche aggregate
- ‘Both’: genera sia i file dati che quelli statistici
Default: Both
Le statistiche forniscono conteggi aggregati per IP client, protocollo, direzione e tipo di query, insieme all’intervallo di date per ogni combinazione unica.
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
Rimuove il file di log di debug DNS sorgente dopo l’elaborazione riuscita.
Usa questo per pipeline di elaborazione log automatizzate o gestione dello spazio su disco.
Il file sorgente viene rimosso solo se l’elaborazione si completa con successo e tutti i file di output sono creati.
Sicurezza: non può essere usato con -SkipHeaderValidation per evitare la cancellazione accidentale di file non validi.
Attenzione: i file sorgente vengono eliminati in modo permanente.
Assicurati che i file di output siano validi prima di usare questa opzione.
Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
Position: Named
IsRequired: false
ValueFromPipeline: false
ValueFromPipelineByPropertyName: false
ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''
Salta il controllo di validazione dell’intestazione del log di debug DNS.
Di default, il cmdlet verifica che i file di input abbiano un’intestazione valida del log di debug DNS Server.
Usa questo switch per elaborare file senza validazione, utile per:
- Formati di log modificati o personalizzati
- Risoluzione di problemi di validazione
- Log non standard o pre-elaborati
Attenzione: può causare errori di elaborazione se il file non è un log DNS valido.
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
Mostra cosa succederebbe se il cmdlet venisse eseguito.
Il cmdlet non viene eseguito.
Se specificato, mostra informazioni dettagliate sulle operazioni che verrebbero eseguite senza effettuarle realmente.
Utile per:
- Anteprima dei file che verrebbero processati
- Verifica dei percorsi dei file di output prima dell’elaborazione
- Test di script prima dell’esecuzione in produzione
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
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per maggiori informazioni, vedi about_CommonParameters.
System.String[]
NOTES
Versione : 1.3.0.1
Autore : Andi Bellstedt, Copilot
Data : 2026-01-23
Parole chiave : Microsoft Windows Server, DNSServer, DNS, DebugLog, LogParser