Utilizzo storage OneDrive per utente

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.

Prerequisiti Modulo Microsoft.Graph, permessi Reports.Read.All

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

ParametroTipoObbligatorioValore predefinitoA cosa serve
-PercorsoCSVtestonoC:\Report\UtilizzoOneDrive.csvfile 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

Privacy Policy Cookie Policy