Elenca i client con lease DHCP che scadranno entro un intervallo di tempo configurabile.
Lo script recupera tutti i lease attivi su uno o piu scope DHCP e riporta quelli la cui scadenza rientra nella finestra temporale specificata, insieme all’indirizzo MAC e al nome host del client associato.
Come si usa
Scarica il file, apri PowerShell nella cartella in cui l’hai salvato e avvialo indicando i parametri obbligatori:
.\Report-LeaseDHCPScadenza.ps1 -ScopeId "<ScopeId>"
Sostituisci i valori tra < > con i tuoi.
La stessa esecuzione con tutti i parametri scritti per esteso (qui con i valori predefiniti, da adattare al tuo ambiente):
.\Report-LeaseDHCPScadenza.ps1 -ScopeId "<ScopeId>" -OreFinestra 4 -PercorsoCSV "C:\Report\LeaseDHCPScadenza.csv"
Parametri
| Parametro | Tipo | Obbligatorio | Valore predefinito | A cosa serve |
|---|---|---|---|---|
-ScopeId | testo | sì | — | passato a Get-DhcpServerv4Lease -ScopeId |
-OreFinestra | numero intero | no | 4 | — |
-PercorsoCSV | testo | no | C:\Report\LeaseDHCPScadenza.csv | file CSV in cui viene salvato il risultato |
Cosa restituisce
- Un file CSV in
C:\Report\LeaseDHCPScadenza.csv(si cambia con-PercorsoCSV) con il punto e virgola come separatore, così Excel in italiano lo apre già diviso in colonne. Colonne:IPAddress,ClientId,HostName,Scadenza. - A video, un riepilogo a colori: giallo per avvisi e valori da controllare.
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-LeaseDHCPScadenza.ps1.
I comandi usati dallo script
Get-DhcpServerv4Lease: elenca i lease IPv4 di un ambito (scope) DHCP con la loro scadenza.Export-Csv: salva gli oggetti in un file CSV, una colonna per ogni proprietà.
Il codice completo
È lo stesso contenuto del file scaricabile (22 righe): leggilo prima di eseguirlo, come si dovrebbe fare con qualsiasi script preso da Internet.
<#
.SYNOPSIS
Elenca i client con lease DHCP che scadranno entro una finestra di tempo configurabile.
#>
param(
[Parameter(Mandatory=$true)]
[string]$ScopeId,
[int]$OreFinestra = 4,
[string]$PercorsoCSV = "C:\Report\LeaseDHCPScadenza.csv"
)
Import-Module DhcpServer
$dataLimite = (Get-Date).AddHours($OreFinestra)
$lease = Get-DhcpServerv4Lease -ScopeId $ScopeId | Where-Object { $_.LeaseExpiryTime -lt $dataLimite }
$risultati = $lease | Select-Object IPAddress, ClientId, HostName,
@{N="Scadenza";E={$_.LeaseExpiryTime.ToString("dd/MM/yyyy HH:mm")}}
$risultati | Sort-Object Scadenza | Export-Csv -Path $PercorsoCSV -NoTypeInformation -Encoding UTF8 -Delimiter ";"
Write-Host "Trovati $($risultati.Count) lease in scadenza entro $OreFinestra ore." -ForegroundColor Yellow
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