Stato degli Always On Availability Group

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.

Prerequisiti Modulo SqlServer, Always On configurato

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

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

Privacy Policy Cookie Policy