Questa è la versione stampabile multipagina di questa sezione. Clicca qui per stampare.

Torna alla visualizzazione normale di questa pagina.

Riferimento ai comandi del modulo

1: Convert-DNSDebugLogFile

Qui puoi trovare un riferimento per tutti i comandi del modulo. Questo riferimento è pensato per aiutarti a trovare rapidamente il comando di cui hai bisogno e a capire come usarlo efficacemente.

Cliccando su un comando, verrai portato a una pagina dettagliata che fornisce informazioni complete sul comando, inclusi sintassi, parametri, esempi e eventuali note o suggerimenti aggiuntivi per l’uso.

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] [-NoDetailsParsing] [-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 i log di debug DNS e scrive un output CSV coerente per l’analisi. L’output CSV contiene 18 colonne, inclusa una colonna Information per testo di eventi/diagnostica, una colonna JSON opzionale Details per i blocchi di dettaglio del pacchetto, e una colonna ComputerName sempre presente (vuota se non specificata).

CARATTERISTICHE PRINCIPALI:

Elaborazione in streaming per evitare il caricamento completo del file in memoria (adatto a log molto grandi)
Parsing ad alte prestazioni ottimizzato per file di grandi dimensioni (oltre 100MB)
Delimitatore CSV personalizzabile (default: punto e virgola)
Sommari statistici opzionali con metriche aggregate
Filtraggio per contesto (Packet, Event, Note e altri) 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 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, elaborazione in streaming per gestione efficiente in memoria di file grandi, operazioni su stringhe invece di regex, generazione manuale CSV, e raccolta efficiente di statistiche basate su hashtable.

COMPATIBILITÀ:

PowerShell 5.1+ (edizioni Desktop e Core)
Windows Server 2016+
Formati 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 (file dati e statistiche con delimitatore punto e virgola). Output:

C:\Logs\dns.csv
C:\Logs\dns_Statistic.csv
C:\Logs\dns_PacketStatistic.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 i file di statistiche con metriche aggregate. Output:

C:\Logs\dns_Statistic.csv
C:\Logs\dns_PacketStatistic.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
C:\Logs\dns_Statistic.csv
C:\Logs\dns_PacketStatistic.csv

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 + file di statistiche)

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 pacchetti query/response DNS, escludendo EVENT e Note. Usa per focalizzare l’analisi sul traffico DNS reale.

ESEMPIO 11

PS C:\> Convert-DNSDebugLogFile -InputFile "C:\Logs\dns.log" -ContextFilter 'Packet','Event'

Converte sia pacchetti query/response DNS che eventi del server, escludendo Note e altre voci. Usa per analizzare il traffico DNS insieme al contesto degli eventi server.

ESEMPIO 12

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.

ESEMPIO 13

PS C:\> Convert-DNSDebugLogFile -InputFile "C:\Logs\large-dns.log" -NoDetailsParsing

Elabora un file di log grande con parsing dei dettagli disabilitato per massimizzare le prestazioni. I blocchi di dettaglio PACKET sono saltati, mantenendo vuota la colonna Details. Usa quando si elaborano file molto grandi e non è necessaria l’analisi dettagliata della struttura del pacchetto.

PARAMETERS

-CompressOutput

Comprimi i file CSV di output in un archivio ZIP dopo la creazione.

Crea un file .zip contenente il/i file CSV generati, quindi rimuove 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 si consolidano log da più server DNS per identificare il server di origine nei dataset combinati.

Nota: NON è un parametro di remoting. Etichetta solo l’output. Se si punta -InputFile a un percorso UNC, il file viene letto da quel percorso (non viene eseguito WinRM/esecuzione remota).

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, richiede 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 elaborazione interattiva 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. Accetta valori singoli o multipli.

I log di debug DNS contengono diversi tipi di contesto:

PACKET: informazioni sui pacchetti di query e risposta DNS (dati primari)
EVENT: eventi del server DNS (es. “Il server DNS è stato avviato.”)
Note: note diagnostiche e avvisi (es. errori di socket, stati interni)
DSPoll, Init, Lookup, Recurse, Remote, Tombstone: altri tipi di contesto

Valori validi:

‘All’: include tutti i tipi di contesto (default)
‘Packet’: include solo voci PACKET (query/risposte DNS)
‘Event’: include solo voci EVENT (eventi server)
‘Note’: include solo voci Note (informazioni diagnostiche)
Qualsiasi combinazione: specifica più valori per includere tipi di contesto specifici

Default: All

Esempi:

‘Packet’ filtra solo il traffico DNS
‘Packet’,‘Event’ include sia traffico DNS che eventi server
‘Note’,‘Event’ include note diagnostiche ed eventi server

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: ''

-InputCulture

Specifica la cultura/locale da usare per il parsing dei valori data/ora nel log di debug DNS.

I log di debug del server 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: ''

-InputFile

Specifica il percorso del file di log di debug DNS da analizzare. Supporta array per elaborare più file.

Accetta input da 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: ''

-NoDetailsParsing

Salta il parsing dei blocchi di dettaglio PACKET in formato JSON strutturato.

Se specificato, i record PACKET con blocchi di dettaglio avranno la linea info TCP/UDP nella colonna Information, ma la colonna Details rimarrà vuota. Questo migliora significativamente le prestazioni di elaborazione per file di log grandi quando non è necessaria l’analisi dettagliata della struttura del pacchetto.

Usa questo switch quando:

Elabori file di log molto grandi (oltre 100MB) e ti servono solo informazioni base sulle query
La struttura dettagliata (flag messaggi, sezioni DNS) non è richiesta per l’analisi
Vuoi massimizzare la velocità di parsing a scapito della completezza dei dati

Impatto sulle prestazioni: può migliorare la velocità di elaborazione del 30-50% per log con molti blocchi di dettaglio PACKET.

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

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 per il 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
‘Statistic’: genera solo i file di statistiche con metriche aggregate
‘Both’: genera sia file dati che statistiche (default)

Default: Both

Quando si generano statistiche, vengono creati due file separati:

‘_Statistic.csv’: conteggi riepilogativi per tipo di contesto per giorno (Data, Contesto, Conteggio, ComputerName)
‘_PacketStatistic.csv’: conteggi dettagliati PACKET per giorno per IP client, protocollo, direzione, e tipo di query (Data, ClientIP, Protocollo, Direzione, QuestionType, Conteggio, ComputerName)

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 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.

Avviso: i file sorgente sono 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: ''

-SkipHeaderValidation

Ignora 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 di 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

Avviso: 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 eseguirle 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.

INPUTS

System.String[]

NOTES

Versione : 1.7.1.1 Autore : Andi Bellstedt, Copilot Data : 2026-01-26 Parole chiave : Microsoft Windows Server, DNSServer, DNS, DebugLog, LogParser

github.com/AndiBellstedt/DNSServer.DebugLogParser