Client con lease DHCP in scadenza

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.

Prerequisiti Modulo DhcpServer (RSAT), eseguito sul server DHCP

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

ParametroTipoObbligatorioValore predefinitoA cosa serve
-ScopeIdtestosì—passato a Get-DhcpServerv4Lease -ScopeId
-OreFinestranumero interono4—
-PercorsoCSVtestonoC:\Report\LeaseDHCPScadenza.csvfile 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

Privacy Policy Cookie Policy