Individua i gruppi senza alcun membro, candidati a revisione o pulizia.
Lo script recupera tutti i gruppi del dominio e, per ciascuno, verifica se ha almeno un membro. I gruppi risultati senza alcun membro vengono riportati insieme a descrizione e data di creazione.
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-GruppiVuoti.ps1
La stessa esecuzione con tutti i parametri scritti per esteso (qui con i valori predefiniti, da adattare al tuo ambiente):
.\Report-GruppiVuoti.ps1 -PercorsoCSV "C:\Report\GruppiVuoti.csv"
Parametri
| Parametro | Tipo | Obbligatorio | Valore predefinito | A cosa serve |
|---|---|---|---|---|
-PercorsoCSV | testo | no | C:\Report\GruppiVuoti.csv | file CSV in cui viene salvato il risultato |
Cosa restituisce
- Un file CSV in
C:\Report\GruppiVuoti.csv(si cambia con-PercorsoCSV) con il punto e virgola come separatore, così Excel in italiano lo apre già diviso in colonne. Colonne:NomeGruppo,Descrizione,Creato,Percorso. - A video, un riepilogo a colori: giallo per avvisi e valori da controllare.
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-GruppiVuoti.ps1.
I comandi usati dallo script
Get-ADGroup: legge i gruppi di Active Directory.Get-ADGroupMember: elenca i membri di un gruppo (con -Recursive anche quelli dei gruppi annidati).Export-Csv: salva gli oggetti in un file CSV, una colonna per ogni proprietà.
Il codice completo
È lo stesso contenuto del file scaricabile (26 righe): leggilo prima di eseguirlo, come si dovrebbe fare con qualsiasi script preso da Internet.
<#
.SYNOPSIS
Report dei gruppi Active Directory senza alcun membro.
#>
param(
[string]$PercorsoCSV = "C:\Report\GruppiVuoti.csv"
)
Import-Module ActiveDirectory
$gruppi = Get-ADGroup -Filter * -Properties Description, whenCreated
$risultati = foreach ($g in $gruppi) {
$membri = Get-ADGroupMember -Identity $g.DistinguishedName -ErrorAction SilentlyContinue
if (-not $membri -or $membri.Count -eq 0) {
[PSCustomObject]@{
NomeGruppo = $g.Name
Descrizione = $g.Description
Creato = $g.whenCreated.ToString("dd/MM/yyyy")
Percorso = $g.DistinguishedName
}
}
}
$risultati | Export-Csv -Path $PercorsoCSV -NoTypeInformation -Encoding UTF8 -Delimiter ";"
Write-Host "Trovati $($risultati.Count) gruppi senza membri." -ForegroundColor Yellow
Approfondimenti
- Per farlo girare ogni giorno in automatico: Come pianificare uno script con Task Scheduler
- Tutte le guide Active Directory
- Gli altri script Active Directory