Stato dei Maintenance Plan configurati

Elenca i Maintenance Plan configurati sull’istanza con l’esito della loro ultima esecuzione.

Lo script recupera tutti i Maintenance Plan configurati tramite l’interfaccia grafica di SQL Server e ne verifica l’esito dell’ultima esecuzione, incrociando i dati con i job SQL Agent associati.

Prerequisiti Modulo SqlServer

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.

.\Verifica-MaintenancePlan.ps1

La stessa esecuzione con tutti i parametri scritti per esteso (qui con i valori predefiniti, da adattare al tuo ambiente):

.\Verifica-MaintenancePlan.ps1 -ServerSQL "localhost" -PercorsoCSV "C:\Report\MaintenancePlan.csv"

Parametri

ParametroTipoObbligatorioValore predefinitoA cosa serve
-ServerSQLtestonolocalhostcomputer o istanza su cui lavora Invoke-Sqlcmd
-PercorsoCSVtestonoC:\Report\MaintenancePlan.csvfile CSV in cui viene salvato il risultato

Cosa restituisce

  • Un file CSV in C:\Report\MaintenancePlan.csv (si cambia con -PercorsoCSV) con il punto e virgola come separatore, così Excel in italiano lo apre già diviso in colonne.
  • A video, un riepilogo a colori: verde quando l’esito è positivo.

Requisiti

  • Modulo SqlServer dalla PowerShell Gallery: Install-Module SqlServer -Scope CurrentUser.
  • 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 .\Verifica-MaintenancePlan.ps1.

I comandi usati dallo script

  • Invoke-Sqlcmd: esegue una query T-SQL su un’istanza SQL Server e restituisce le righe come oggetti PowerShell.
  • Export-Csv: salva gli oggetti in un file CSV, una colonna per ogni proprietà.

Il codice completo

È lo stesso contenuto del file scaricabile (21 righe): leggilo prima di eseguirlo, come si dovrebbe fare con qualsiasi script preso da Internet.

<#
.SYNOPSIS
    Elenca i Maintenance Plan configurati sull'istanza con l'esito dell'ultima esecuzione.
#>
param(
    [string]$ServerSQL = "localhost",
    [string]$PercorsoCSV = "C:\Report\MaintenancePlan.csv"
)
Import-Module SqlServer -ErrorAction SilentlyContinue

$query = @"
SELECT sp.name AS NomePiano, sp.description AS Descrizione,
       h.run_date, h.run_status
FROM msdb.dbo.sysmaintplan_plans sp
LEFT JOIN msdb.dbo.sysjobs j ON j.name LIKE '%' + sp.name + '%'
LEFT JOIN msdb.dbo.sysjobhistory h ON h.job_id = j.job_id AND h.step_id = 0
"@

$risultati = Invoke-Sqlcmd -ServerInstance $ServerSQL -Query $query
$risultati | Export-Csv -Path $PercorsoCSV -NoTypeInformation -Encoding UTF8 -Delimiter ";"
Write-Host "Trovati $($risultati.Count) Maintenance Plan configurati." -ForegroundColor Green

Approfondimenti

Privacy Policy Cookie Policy