Stato replica tra Domain Controller

Verifica lo stato di replica tra tutti i DC del dominio, evidenziando errori o DC irraggiungibili.

Lo script interroga ogni Domain Controller del dominio e ne recupera i metadati di replica verso tutti i partner, riportando l’esito dell’ultima replica riuscita, l’ultimo tentativo e l’eventuale codice di errore. Se un DC non e raggiungibile, questo viene segnalato esplicitamente nel report.

Prerequisiti Modulo ActiveDirectory, connettivita verso i DC

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.

.\Report-StatoReplica.ps1

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

.\Report-StatoReplica.ps1 -PercorsoCSV "C:\Report\StatoReplica.csv"

Parametri

ParametroTipoObbligatorioValore predefinitoA cosa serve
-PercorsoCSVtestonoC:\Report\StatoReplica.csvfile CSV in cui viene salvato il risultato

Cosa restituisce

  • Un file CSV in C:\Report\StatoReplica.csv (si cambia con -PercorsoCSV) con il punto e virgola come separatore, così Excel in italiano lo apre già diviso in colonne. Colonne: DomainController, Partner, UltimaReplica, UltimoTentativo, UltimoErrore, Stato.
  • A video, un riepilogo a colori: rosso per errori e problemi, verde quando l’esito è positivo.

Requisiti

  • Modulo ActiveDirectory (strumenti RSAT): su Windows Server Install-WindowsFeature RSAT-AD-PowerShell, su Windows 10/11 dalle Funzionalità facoltative (RSAT: Active Directory Domain Services).
  • 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 .\Report-StatoReplica.ps1.

I comandi usati dallo script

  • Get-ADDomainController: elenca i Domain Controller e le loro caratteristiche (sito, sistema operativo, Global Catalog).
  • Get-ADReplicationPartnerMetadata: mostra lo stato della replica con ogni partner: ultimo tentativo, ultimo successo, errori consecutivi.
  • Export-Csv: salva gli oggetti in un file CSV, una colonna per ogni proprietà.

Il codice completo

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

<#
.SYNOPSIS
    Verifica lo stato di replica tra tutti i Domain Controller del dominio.
#>
param(
    [string]$PercorsoCSV = "C:\Report\StatoReplica.csv"
)

Import-Module ActiveDirectory

$dc = Get-ADDomainController -Filter *

$risultati = foreach ($server in $dc) {
    try {
        $repliche = Get-ADReplicationPartnerMetadata -Target $server.HostName -ErrorAction Stop

        foreach ($rep in $repliche) {
            [PSCustomObject]@{
                DomainController = $server.HostName
                Partner          = $rep.Partner
                UltimaReplica    = $rep.LastReplicationSuccess
                UltimoTentativo  = $rep.LastReplicationAttempt
                UltimoErrore     = $rep.LastReplicationResult
                Stato            = if ($rep.LastReplicationResult -eq 0) {"OK"} else {"ERRORE"}
            }
        }
    }
    catch {
        [PSCustomObject]@{
            DomainController = $server.HostName
            Partner           = "N/D"
            UltimaReplica     = "N/D"
            UltimoTentativo   = "N/D"
            UltimoErrore      = "Impossibile contattare il DC: $_"
            Stato             = "NON RAGGIUNGIBILE"
        }
    }
}

$risultati | Export-Csv -Path $PercorsoCSV -NoTypeInformation -Encoding UTF8 -Delimiter ";"
$errori = ($risultati | Where-Object {$_.Stato -ne "OK"}).Count
Write-Host "Report generato. Repliche con problemi: $errori" -ForegroundColor $(if($errori -gt 0){"Red"}else{"Green"})

Approfondimenti

Privacy Policy Cookie Policy