Verifica l’esito dell’ultima esecuzione di ogni job pianificato su SQL Server Agent.
Lo script recupera tutti i job configurati su SQL Server Agent e ne verifica l’esito dell’ultima esecuzione registrata, segnalando quelli falliti.
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-JobSQLAgent.ps1
La stessa esecuzione con tutti i parametri scritti per esteso (qui con i valori predefiniti, da adattare al tuo ambiente):
.\Verifica-JobSQLAgent.ps1 -ServerSQL "localhost" -PercorsoCSV "C:\Report\JobSQLAgent.csv"
Parametri
| Parametro | Tipo | Obbligatorio | Valore predefinito | A cosa serve |
|---|---|---|---|---|
-ServerSQL | testo | no | localhost | computer o istanza su cui lavora Invoke-Sqlcmd |
-PercorsoCSV | testo | no | C:\Report\JobSQLAgent.csv | file CSV in cui viene salvato il risultato |
Cosa restituisce
- Un file CSV in
C:\Report\JobSQLAgent.csv(si cambia con-PercorsoCSV) con il punto e virgola come separatore, così Excel in italiano lo apre già diviso in colonne. Colonne:NomeJob,Abilitato,UltimoEsito. - A video, un riepilogo a colori: rosso per errori e problemi, 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-JobSQLAgent.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 (27 righe): leggilo prima di eseguirlo, come si dovrebbe fare con qualsiasi script preso da Internet.
<#
.SYNOPSIS
Verifica l'esito dell'ultima esecuzione di ogni job di SQL Server Agent.
#>
param(
[string]$ServerSQL = "localhost",
[string]$PercorsoCSV = "C:\Report\JobSQLAgent.csv"
)
Import-Module SqlServer -ErrorAction SilentlyContinue
$query = @"
SELECT j.name AS NomeJob, j.enabled AS Abilitato,
h.run_date, h.run_time, h.run_status
FROM msdb.dbo.sysjobs j
LEFT JOIN msdb.dbo.sysjobhistory h ON h.job_id = j.job_id AND h.step_id = 0
WHERE h.instance_id = (SELECT MAX(instance_id) FROM msdb.dbo.sysjobhistory h2 WHERE h2.job_id = j.job_id AND h2.step_id = 0)
"@
$risultati = Invoke-Sqlcmd -ServerInstance $ServerSQL -Query $query
$statoTesto = @{0="Fallito"; 1="Riuscito"; 3="Annullato"; 4="In corso"}
$report = $risultati | Select-Object NomeJob, Abilitato,
@{N="UltimoEsito";E={$statoTesto[[int]$_.run_status]}}
$report | Export-Csv -Path $PercorsoCSV -NoTypeInformation -Encoding UTF8 -Delimiter ";"
$falliti = ($report | Where-Object {$_.UltimoEsito -eq "Fallito"}).Count
Write-Host "Controllati $($report.Count) job. Falliti nell'ultima esecuzione: $falliti" -ForegroundColor $(if($falliti -gt 0){"Red"}else{"Green"})
Approfondimenti
- Come configurare un job di manutenzione indici con SQL Server Agent
- Per farlo girare ogni giorno in automatico: Come pianificare uno script con Task Scheduler
- Tutte le guide Database
- Gli altri script Database