Verifica lo stato di sincronizzazione delle repliche in un Always On Availability Group.
Lo script recupera tutti gli Availability Group configurati sull’istanza e ne verifica lo stato di sincronizzazione di ciascuna replica, segnalando quelle non in stato di salute.
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-AlwaysOnAG.ps1
La stessa esecuzione con tutti i parametri scritti per esteso (qui con i valori predefiniti, da adattare al tuo ambiente):
.\Verifica-AlwaysOnAG.ps1 -ServerSQL "localhost" -PercorsoCSV "C:\Report\AlwaysOnAG.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\AlwaysOnAG.csv | file CSV in cui viene salvato il risultato |
Cosa restituisce
- Un file CSV in
C:\Report\AlwaysOnAG.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: rosso per errori e problemi, verde quando l’esito è positivo, giallo per avvisi e valori da controllare.
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-AlwaysOnAG.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 lo stato di sincronizzazione delle repliche in un Always On Availability Group.
#>
param(
[string]$ServerSQL = "localhost",
[string]$PercorsoCSV = "C:\Report\AlwaysOnAG.csv"
)
Import-Module SqlServer -ErrorAction SilentlyContinue
$query = @"
SELECT ag.name AS NomeAG, ar.replica_server_name AS Replica,
ars.role_desc AS Ruolo, ars.synchronization_health_desc AS StatoSync
FROM sys.availability_groups ag
JOIN sys.availability_replicas ar ON ar.group_id = ag.group_id
JOIN sys.dm_hadr_availability_replica_states ars ON ars.replica_id = ar.replica_id
"@
try {
$risultati = Invoke-Sqlcmd -ServerInstance $ServerSQL -Query $query -ErrorAction Stop
$risultati | Export-Csv -Path $PercorsoCSV -NoTypeInformation -Encoding UTF8 -Delimiter ";"
$problemi = ($risultati | Where-Object {$_.StatoSync -ne "HEALTHY"}).Count
Write-Host "Controllate $($risultati.Count) repliche. Non in salute: $problemi" -ForegroundColor $(if($problemi -gt 0){"Red"}else{"Green"})
}
catch {
Write-Host "Always On non configurato su questa istanza, o errore: $_" -ForegroundColor Yellow
}
Approfondimenti
- Come configurare la modalità Always On Availability Group
- Come eseguire un failover manuale di un Availability Group
- Per farlo girare ogni giorno in automatico: Come pianificare uno script con Task Scheduler
- Tutte le guide Database
- Gli altri script Database