Esporta tutte le OU del dominio con conteggio utenti e computer contenuti direttamente.
Lo script recupera tutte le Unita Organizzative del dominio e, per ciascuna, conta gli utenti e i computer contenuti direttamente al suo interno, producendo una mappa completa della struttura organizzativa della directory.
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.
.\Export-StrutturaOU.ps1
La stessa esecuzione con tutti i parametri scritti per esteso (qui con i valori predefiniti, da adattare al tuo ambiente):
.\Export-StrutturaOU.ps1 -PercorsoCSV "C:\Report\StrutturaOU.csv"
Parametri
| Parametro | Tipo | Obbligatorio | Valore predefinito | A cosa serve |
|---|---|---|---|---|
-PercorsoCSV | testo | no | C:\Report\StrutturaOU.csv | file CSV in cui viene salvato il risultato |
Cosa restituisce
- Un file CSV in
C:\Report\StrutturaOU.csv(si cambia con-PercorsoCSV) con il punto e virgola come separatore, così Excel in italiano lo apre già diviso in colonne. Colonne:Nome,PercorsoCompleto,Descrizione,UtentiDiretti,ComputerDiretti. - A video, un riepilogo a colori: 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 .\Export-StrutturaOU.ps1.
I comandi usati dallo script
Get-ADOrganizationalUnit: legge le unità organizzative (OU) del dominio.Get-ADUser: legge gli account utente di Active Directory; con -Properties si chiedono gli attributi aggiuntivi.Get-ADComputer: legge gli account computer del dominio, con attributi come LastLogonDate e OperatingSystem.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
Esporta la struttura completa delle Unità Organizzative del dominio, con conteggio oggetti per OU.
#>
param(
[string]$PercorsoCSV = "C:\Report\StrutturaOU.csv"
)
Import-Module ActiveDirectory
$ou = Get-ADOrganizationalUnit -Filter * -Properties Description
$risultati = foreach ($unit in $ou) {
$utentiCount = (Get-ADUser -Filter * -SearchBase $unit.DistinguishedName -SearchScope OneLevel -ErrorAction SilentlyContinue).Count
$computerCount = (Get-ADComputer -Filter * -SearchBase $unit.DistinguishedName -SearchScope OneLevel -ErrorAction SilentlyContinue).Count
[PSCustomObject]@{
Nome = $unit.Name
PercorsoCompleto = $unit.DistinguishedName
Descrizione = $unit.Description
UtentiDiretti = $utentiCount
ComputerDiretti = $computerCount
}
}
$risultati | Sort-Object PercorsoCompleto | Export-Csv -Path $PercorsoCSV -NoTypeInformation -Encoding UTF8 -Delimiter ";"
Write-Host "Esportate $($risultati.Count) Unità Organizzative in: $PercorsoCSV" -ForegroundColor Green
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