Stato dei job di SQL Server Agent

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.

Prerequisiti Modulo SqlServer, SQL Server Agent attivo

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

ParametroTipoObbligatorioValore predefinitoA cosa serve
-ServerSQLtestonolocalhostcomputer o istanza su cui lavora Invoke-Sqlcmd
-PercorsoCSVtestonoC:\Report\JobSQLAgent.csvfile 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

Privacy Policy Cookie Policy