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.
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
| Parametro | Tipo | Obbligatorio | Valore predefinito | A cosa serve |
|---|---|---|---|---|
-PercorsoCSV | testo | no | C:\Report\StatoReplica.csv | file 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
- Come verificare lo stato della replica con repadmin
- Come forzare la replica tra due Domain Controller specifici
- Per farlo girare ogni giorno in automatico: Come pianificare uno script con Task Scheduler
- Tutte le guide Active Directory
- Gli altri script Active Directory