Riepiloga tutti gli scope DHCP configurati con percentuale di utilizzo degli indirizzi disponibili.
Lo script recupera tutti gli scope configurati sul server DHCP e, per ciascuno, calcola quanti indirizzi sono stati assegnati rispetto al totale disponibile, segnalando gli scope che si avvicinano all’esaurimento.
Come si usa
Scarica il file, apri PowerShell nella cartella in cui l’hai salvato ed eseguilo: tutti i parametri hanno un valore predefinito, quindi basta il nome dello script.
.\Report-ScopeDHCP.ps1
La stessa esecuzione con tutti i parametri scritti per esteso (qui con i valori predefiniti, da adattare al tuo ambiente):
.\Report-ScopeDHCP.ps1 -SogliaAllarmePercento 85 -PercorsoCSV "C:\Report\ScopeDHCP.csv"
Parametri
| Parametro | Tipo | Obbligatorio | Valore predefinito | A cosa serve |
|---|---|---|---|---|
-SogliaAllarmePercento | numero intero | no | 85 | — |
-PercorsoCSV | testo | no | C:\Report\ScopeDHCP.csv | file CSV in cui viene salvato il risultato |
Cosa restituisce
- Un file CSV in
C:\Report\ScopeDHCP.csv(si cambia con-PercorsoCSV) con il punto e virgola come separatore, così Excel in italiano lo apre già diviso in colonne. Colonne:Scope,Rete,IndirizziTotali,IndirizziInUso,PercentualeUso,Allarme. - A video, un riepilogo a colori: rosso per errori e problemi, verde quando l’esito è positivo.
Requisiti
- Modulo DhcpServer: presente sui server DHCP, altrove con
Install-WindowsFeature RSAT-DHCP. - La cartella di destinazione (
C:\Report) deve già esistere: lo script non la crea. - Se Windows blocca l’esecuzione perché il file arriva da Internet, sbloccalo una volta con
Unblock-File .\Report-ScopeDHCP.ps1.
I comandi usati dallo script
Get-DhcpServerv4Scope: elenca gli ambiti DHCP IPv4 configurati sul server.Get-DhcpServerv4ScopeStatistics: restituisce indirizzi liberi, in uso e percentuale di occupazione di ogni ambito.Export-Csv: salva gli oggetti in un file CSV, una colonna per ogni proprietà.
Il codice completo
È lo stesso contenuto del file scaricabile (29 righe): leggilo prima di eseguirlo, come si dovrebbe fare con qualsiasi script preso da Internet.
<#
.SYNOPSIS
Riepiloga tutti gli scope DHCP configurati con percentuale di utilizzo.
#>
param(
[int]$SogliaAllarmePercento = 85,
[string]$PercorsoCSV = "C:\Report\ScopeDHCP.csv"
)
Import-Module DhcpServer
$scope = Get-DhcpServerv4Scope
$risultati = foreach ($s in $scope) {
$stats = Get-DhcpServerv4ScopeStatistics -ScopeId $s.ScopeId
[PSCustomObject]@{
Scope = $s.Name
Rete = $s.ScopeId
IndirizziTotali = $stats.Free + $stats.InUse
IndirizziInUso = $stats.InUse
PercentualeUso = [math]::Round($stats.PercentageInUse, 1)
Allarme = if ($stats.PercentageInUse -ge $SogliaAllarmePercento) {"SI"} else {"NO"}
}
}
$risultati | Export-Csv -Path $PercorsoCSV -NoTypeInformation -Encoding UTF8 -Delimiter ";"
$inAllarme = ($risultati | Where-Object {$_.Allarme -eq "SI"}).Count
Write-Host "Controllati $($scope.Count) scope. In allarme (oltre $SogliaAllarmePercento%): $inAllarme" -ForegroundColor $(if($inAllarme -gt 0){"Red"}else{"Green"})
Approfondimenti
- Come impostare uno scope DHCP su Windows Server
- Come configurare una riserva DHCP per un dispositivo specifico
- Per farlo girare ogni giorno in automatico: Come pianificare uno script con Task Scheduler
- Tutte le guide Networking
- Gli altri script Networking