Esporta lo spazio utilizzato su OneDrive da ciascun utente, tramite i report di utilizzo di Microsoft 365.
Lo script utilizza l’endpoint di reportistica di Microsoft Graph dedicato a OneDrive per recuperare, per ciascun account, lo spazio utilizzato e lo spazio totale assegnato, permettendo di individuare rapidamente chi si sta avvicinando al limite.
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-UtilizzoOneDrive.ps1
La stessa esecuzione con tutti i parametri scritti per esteso (qui con i valori predefiniti, da adattare al tuo ambiente):
.\Report-UtilizzoOneDrive.ps1 -PercorsoCSV "C:\Report\UtilizzoOneDrive.csv"
Parametri
| Parametro | Tipo | Obbligatorio | Valore predefinito | A cosa serve |
|---|---|---|---|---|
-PercorsoCSV | testo | no | C:\Report\UtilizzoOneDrive.csv | file CSV in cui viene salvato il risultato |
Cosa restituisce
- Un file CSV in
C:\Report\UtilizzoOneDrive.csv(si cambia con-PercorsoCSV) con il punto e virgola come separatore, così Excel in italiano lo apre già diviso in colonne. Colonne:Owner Principal Name,SpazioUsatoGB,SpazioAllocatoGB. - A video, un riepilogo a colori: verde quando l’esito è positivo.
Requisiti
- Microsoft Graph PowerShell SDK:
Install-Module Microsoft.Graph -Scope CurrentUser(oppure solo i sottomoduli usati dallo script). - Permessi Microsoft Graph richiesti all’accesso:
Reports.Read.All. La prima volta Microsoft Entra ID chiede il consenso, che per questi permessi di solito deve concedere un amministratore. - 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-UtilizzoOneDrive.ps1.
I comandi usati dallo script
Connect-MgGraph: apre la sessione con Microsoft Graph chiedendo i permessi (scope) indicati.Get-MgReportOneDriveUsageAccountDetail: scarica il report di utilizzo di OneDrive per account (spazio usato e allocato).Import-Csv: legge un file CSV e trasforma ogni riga in un oggetto, con le intestazioni come nomi delle proprietà.Export-Csv: salva gli oggetti in un file CSV, una colonna per ogni proprietà.
Il codice completo
È lo stesso contenuto del file scaricabile (23 righe): leggilo prima di eseguirlo, come si dovrebbe fare con qualsiasi script preso da Internet.
<#
.SYNOPSIS
Esporta lo spazio utilizzato su OneDrive da ciascun utente tramite i report Microsoft Graph.
#>
param(
[string]$PercorsoCSV = "C:\Report\UtilizzoOneDrive.csv"
)
Import-Module Microsoft.Graph.Reports
Connect-MgGraph -Scopes "Reports.Read.All" -NoWelcome
$reportPath = "C:\Report\_temp_onedrive_usage.csv"
Get-MgReportOneDriveUsageAccountDetail -Period D30 -OutFile $reportPath
$dati = Import-Csv -Path $reportPath
$risultati = $dati | Select-Object "Owner Principal Name",
@{N="SpazioUsatoGB";E={[math]::Round([double]$_."Storage Used (Byte)" / 1GB, 2)}},
@{N="SpazioAllocatoGB";E={[math]::Round([double]$_."Storage Allocated (Byte)" / 1GB, 2)}}
$risultati | Export-Csv -Path $PercorsoCSV -NoTypeInformation -Encoding UTF8 -Delimiter ";"
Write-Host "Esportato l'utilizzo OneDrive per $($risultati.Count) utenti." -ForegroundColor Green
Remove-Item $reportPath -ErrorAction SilentlyContinue
Approfondimenti
- Come configurare OneDrive for Business per la sincronizzazione aziendale
- Per farlo girare ogni giorno in automatico: Come pianificare uno script con Task Scheduler
- Tutte le guide Microsoft 365
- Gli altri script Microsoft 365