Creazione utenti in blocco da CSV

Crea piu utenti contemporaneamente da un file CSV, con controllo duplicati e simulazione.

Lo script legge un file CSV con i dati di piu utenti da creare e, per ciascuna riga, verifica che l’username non esista gia, quindi crea il nuovo account con i parametri specificati, impostando l’obbligo di cambio password al primo accesso.

Prerequisiti Modulo ActiveDirectory, permessi di creazione oggetti

Come si usa

Scarica il file, apri PowerShell nella cartella in cui l’hai salvato e avvialo indicando i parametri obbligatori:

.\Crea-UtentiDaCSV.ps1 -PercorsoCSV "<PercorsoCSV>"

Sostituisci i valori tra < > con i tuoi.

Attenzione: lo switch -Simula è attivo per impostazione predefinita, quindi la prima esecuzione non modifica nulla e mostra soltanto cosa farebbe. Quando il risultato ti convince, rilancia lo script aggiungendo -Simula:$false per applicare davvero le modifiche.

Il file CSV indicato con -PercorsoCSV deve avere una riga di intestazione con almeno queste colonne, separate dal punto e virgola: Nome, Cognome, Username, OU, Password, Reparto.

Parametri

ParametroTipoObbligatorioValore predefinitoA cosa serve
-PercorsoCSVtestosì—file CSV da leggere
-Simulaswitchno$true—

Cosa restituisce

  • A video, un riepilogo a colori: giallo per avvisi e valori da controllare, azzurro per titoli e informazioni, verde quando l’esito è positivo, rosso per errori e problemi.

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).
  • Se Windows blocca l’esecuzione perché il file arriva da Internet, sbloccalo una volta con Unblock-File .\Crea-UtentiDaCSV.ps1.

I comandi usati dallo script

  • Import-Csv: legge un file CSV e trasforma ogni riga in un oggetto, con le intestazioni come nomi delle proprietà.
  • Get-ADUser: legge gli account utente di Active Directory; con -Properties si chiedono gli attributi aggiuntivi.
  • New-ADUser: crea un nuovo account utente.
  • Get-ADDomain: restituisce le informazioni del dominio, tra cui i titolari dei ruoli FSMO di dominio.

Il codice completo

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

<#
.SYNOPSIS
    Crea utenti Active Directory in blocco a partire da un file CSV.
.NOTES
    Il CSV deve avere le colonne: Nome;Cognome;Username;OU;Password;Reparto
#>
param(
    [Parameter(Mandatory=$true)]
    [string]$PercorsoCSV,
    [switch]$Simula = $true
)

Import-Module ActiveDirectory

$utenti = Import-Csv -Path $PercorsoCSV -Delimiter ";"

foreach ($u in $utenti) {
    $nomeCompleto = "$($u.Nome) $($u.Cognome)"

    if (Get-ADUser -Filter "SamAccountName -eq '$($u.Username)'" -ErrorAction SilentlyContinue) {
        Write-Host "SALTATO: '$($u.Username)' esiste già." -ForegroundColor Yellow
        continue
    }

    if ($Simula) {
        Write-Host "SIMULAZIONE: verrebbe creato '$nomeCompleto' ($($u.Username)) in $($u.OU)" -ForegroundColor Cyan
        continue
    }

    try {
        New-ADUser -Name $nomeCompleto -GivenName $u.Nome -Surname $u.Cognome `
            -SamAccountName $u.Username `
            -UserPrincipalName "$($u.Username)@$((Get-ADDomain).DNSRoot)" `
            -Path $u.OU `
            -AccountPassword (ConvertTo-SecureString $u.Password -AsPlainText -Force) `
            -Department $u.Reparto -Enabled $true -ChangePasswordAtLogon $true

        Write-Host "CREATO: $nomeCompleto ($($u.Username))" -ForegroundColor Green
    }
    catch {
        Write-Host "ERRORE creando '$($u.Username)': $_" -ForegroundColor Red
    }
}

Approfondimenti

Privacy Policy Cookie Policy