Individua le caselle di posta che superano una soglia di dimensione configurabile.
Lo script si collega a Exchange Online e recupera le statistiche di tutte le mailbox, riportando quelle la cui dimensione totale supera la soglia in GB specificata.
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-MailboxOversize.ps1
La stessa esecuzione con tutti i parametri scritti per esteso (qui con i valori predefiniti, da adattare al tuo ambiente):
.\Report-MailboxOversize.ps1 -SogliaGB 40 -PercorsoCSV "C:\Report\MailboxOversize.csv"
Parametri
| Parametro | Tipo | Obbligatorio | Valore predefinito | A cosa serve |
|---|---|---|---|---|
-SogliaGB | numero | no | 40 | — |
-PercorsoCSV | testo | no | C:\Report\MailboxOversize.csv | file CSV in cui viene salvato il risultato |
Cosa restituisce
- Un file CSV in
C:\Report\MailboxOversize.csv(si cambia con-PercorsoCSV) con il punto e virgola come separatore, così Excel in italiano lo apre già diviso in colonne. Colonne:Utente,DimensioneGB,NumeroElementi. - A video, un riepilogo a colori: giallo per avvisi e valori da controllare.
Requisiti
- Modulo ExchangeOnlineManagement:
Install-Module ExchangeOnlineManagement -Scope CurrentUser. - 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-MailboxOversize.ps1.
I comandi usati dallo script
Connect-ExchangeOnline: apre la sessione con Exchange Online (modulo ExchangeOnlineManagement).Get-Mailbox: legge le caselle di posta e le loro impostazioni.Get-MailboxStatistics: restituisce dimensione e numero di elementi di una casella.Export-Csv: salva gli oggetti in un file CSV, una colonna per ogni proprietà.Disconnect-ExchangeOnline: chiude la sessione con Exchange Online.
Il codice completo
È lo stesso contenuto del file scaricabile (30 righe): leggilo prima di eseguirlo, come si dovrebbe fare con qualsiasi script preso da Internet.
<#
.SYNOPSIS
Individua le mailbox che superano una soglia di dimensione configurabile.
#>
param(
[double]$SogliaGB = 40,
[string]$PercorsoCSV = "C:\Report\MailboxOversize.csv"
)
Import-Module ExchangeOnlineManagement
Connect-ExchangeOnline -ShowBanner:$false
$mailbox = Get-Mailbox -ResultSize Unlimited
$risultati = foreach ($mb in $mailbox) {
$stats = Get-MailboxStatistics -Identity $mb.UserPrincipalName
$sizeGB = [math]::Round(($stats.TotalItemSize.Value.ToBytes() / 1GB), 2)
if ($sizeGB -ge $SogliaGB) {
[PSCustomObject]@{
Utente = $mb.UserPrincipalName
DimensioneGB = $sizeGB
NumeroElementi = $stats.ItemCount
}
}
}
$risultati | Sort-Object DimensioneGB -Descending | Export-Csv -Path $PercorsoCSV -NoTypeInformation -Encoding UTF8 -Delimiter ";"
Write-Host "Trovate $($risultati.Count) mailbox sopra $SogliaGB GB." -ForegroundColor Yellow
Disconnect-ExchangeOnline -Confirm:$false
Approfondimenti
- Per farlo girare ogni giorno in automatico: Come pianificare uno script con Task Scheduler
- Tutte le guide Microsoft 365
- Gli altri script Microsoft 365