Migrare le email da Aruba a Microsoft 365 con PowerShell: tutorial

Migrare le caselle email da Aruba a Microsoft 365 si fa con una migrazione IMAP: Exchange Online si collega al server IMAP di Aruba e copia i messaggi nelle nuove caselle. Puoi farlo dal portale, ma con PowerShell è più veloce, ripetibile e adatto ai batch grandi. Questo tutorial ti guida passo-passo — e trovi lo script pronto da scaricare.

🛠️ Scarica lo script: Script PowerShell migrazione Aruba → Microsoft 365 — parametrico, commentato, gratuito. Questo articolo spiega come usarlo.

Cosa fa (e cosa NON fa) la migrazione IMAP

La migrazione IMAP copia solo la posta (cartelle e messaggi). Non migra contatti, calendari, attività e regole: vanno gestiti a parte (esportazione .pst da Outlook e import, oppure ricreazione). Tienine conto nella pianificazione.

Prerequisiti

1. Modulo PowerShell ExchangeOnlineManagement:

   Install-Module ExchangeOnlineManagement -Scope CurrentUser

2. Caselle di destinazione già create e licenziate su Microsoft 365 (l’utente con licenza Exchange Online deve esistere prima di migrare).
3. Dominio verificato nel tenant Microsoft 365.
4. Credenziali delle caselle Aruba di origine.
5. Account amministratore Exchange/Global con MFA (lo script usa l’autenticazione moderna: niente password nello script).

Passo 1 — Prepara il file CSV

Microsoft richiede un CSV con esattamente queste tre colonne:

EmailAddress,UserName,Password
mario.rossi@azienda.it,mario.rossi@azienda.it,PasswordAruba1
laura.bianchi@azienda.it,laura.bianchi@azienda.it,PasswordAruba2

• EmailAddress: la casella di destinazione su Microsoft 365 (deve già esistere).
• UserName: il login della casella di origine su Aruba (di norma l’indirizzo completo).
• Password: la password della casella Aruba.

Passo 2 — Verifica il server IMAP di Aruba

Lo script usa come default imaps.aruba.it su porta 993 (SSL). Verifica nel pannello Aruba del tuo dominio il server IMAP corretto: alcune configurazioni usano host dedicati. Puoi passarlo come parametro.

Passo 3 — Esegui lo script

Apri PowerShell nella cartella dello script e lancia (esempio):

.\migrazione-aruba-microsoft-365-synsphere.ps1 `
    -CsvPath .\caselle-aruba.csv `
    -TargetDeliveryDomain "azienda.mail.onmicrosoft.com" `
    -NotificationEmails "it@azienda.it" `
    -AutoStart

Lo script: verifica i prerequisiti, si connette a Exchange Online (si apre il browser per il login), crea (o riusa) l’endpoint IMAP verso Aruba e crea il batch dal CSV. Con -AutoStart parte subito; senza, resta in pausa per i test.

💡 Consiglio: la prima volta lancia con -WhatIf per simulare senza creare nulla, e parti con un batch piccolo (5-10 caselle) per validare credenziali e server IMAP.

Passo 4 — Monitora la migrazione

# Stato del batch
Get-MigrationBatch -Identity 'Migrazione-Aruba-...' | Format-List Status,*Count*

# Dettaglio per casella (per individuare quelle in errore)
Get-MigrationUser -BatchId 'Migrazione-Aruba-...' |
    Get-MigrationUserStatistics | Format-Table Identity,Status,SyncedItemCount,SkippedItemCount

Passo 5 — Cutover e completamento

Quando le caselle sono sincronizzate e hai spostato il record MX del dominio verso Microsoft 365 (in finestra concordata), completa e rimuovi il batch:

Complete-MigrationBatch -Identity 'Migrazione-Aruba-...'
Remove-MigrationBatch   -Identity 'Migrazione-Aruba-...'

Poi riconfigura i client Outlook sugli account Microsoft 365 e gestisci contatti/calendari (e le PEC, che restano un tema a parte — vedi la guida completa Aruba → Microsoft 365).

Se qualcosa va storto

Gli intoppi più comuni (autenticazione IMAP, throttling Aruba, caselle non trovate) li abbiamo raccolti in prerequisiti ed errori da evitare. Per automazioni PowerShell più ampie su Microsoft 365, vedi anche automazione M365 con PowerShell.

Caso reale: abbiamo usato proprio questo script per migrare 25 utenti da Aruba a un nuovo tenant Microsoft 365 in un’azienda di servizi IT a Brescia.

Vuoi delegare la migrazione? SynSphere la gestisce end-to-end con assistenza Microsoft 365: parla con un nostro consulente.