File CSV per batch di migrazione IMAP in Exchange Online

  • Articolo

Il file con valori delimitati da virgole (CSV) che si usa per eseguire la migrazione del contenuto delle cassette postali degli utenti in una migrazione IMAP contiene una riga per ogni utente. Ogni riga include informazioni sulla cassetta postale di Office 365 e sulla cassetta postale IMAP e Office 365 usa queste informazioni per elaborare la migrazione.

Attributi necessari

Di seguito sono riportati gli attributi necessari per ogni utente:

  • EmailAddress specifica l'ID utente per la cassetta postale di Office 365 dell'utente.

  • UserName specifica il nome di accesso utente per la cassetta postale dell'utente nel server IMAP. È possibile usare il formato nome utente o dominio\nome utente. Ad esempio, hollyh o contoso\hollyh.

  • Password è la password per l'account utente nel sistema di messaggistica IMAP.

La migrazione avrà esito negativo se uno di questi attributi non viene incluso nella riga di intestazione del file CSV. Assicurarsi inoltre di digitare gli attributi esattamente come vengono visualizzati. Gli attributi non possono contenere spazi. Devono essere una sola parola. Email Address, ad esempio, non è valido. È necessario utilizzare EmailAddress.

Formato del file CSV

Ecco un esempio di formato per il file CSV. In questo esempio vengono usate le credenziali utente per eseguire la migrazione di tre cassette postali:

EmailAddress,UserName,Password
terrya@contoso.edu,contoso\terry.adams,1091990
annb@contoso.edu,contoso\ann.beebe,2111991
paulc@contoso.edu,contoso\paul.cannon,3281986

Nella prima riga, o riga di intestazione, del file CSV sono elencati i nomi degli attributi, o campi, specificati nelle righe successive. Il nome di ciascun attributo è separato da una virgola.

Ogni riga che segue l'intestazione rappresenta un utente e fornisce le informazioni che verranno utilizzate per la migrazione della cassetta postale di tale utente. I valori degli attributi di ciascuna riga devono trovarsi nello stesso ordine in cui sono elencati i nomi degli attributi nella riga di intestazione. Il valore di ciascun attributo è separato da una virgola.

Usare un editor di testo o un'applicazione come Microsoft Excel per creare il file CSV. Salvare il file con estensione csv o txt.

Consiglio

Se il file CSV contiene caratteri speciali o non ASCII, salvarlo con la codifica UTF-8 o Unicode. A seconda dell'applicazione, il salvataggio del file CSV con codifica UTF-8 o Unicode può risultare più semplice quando le impostazioni locali di sistema del computer corrispondono alla lingua usata nel file CSV.

Dividere una migrazione di grandi dimensioni in diversi batch

Il file CSV può contenere fino a 50.000 righe, una per ogni utente, e può raggiungere dimensioni di 10 MB. È tuttavia consigliabile eseguire la migrazione degli utenti in diversi batch più piccoli.

Se si pianifica la migrazione di numerosi utenti, stabilire quali utenti includere in ogni batch. Se, ad esempio, è necessario eseguire la migrazione di 10.000 account, è possibile eseguire quattro batch con 2.500 utenti ognuno. È anche possibile dividere i batch in ordine alfabetico, in base al tipo di utente, ad esempio docenti, studenti ed ex-alunni, in base alla classe, ad esempio primo anno, secondo anno e terzo anno, o in altri modi che soddisfino le esigenze dell'organizzazione.

Consiglio

Una strategia consiste nel creare cassette postali Office 365 ed eseguire la migrazione della posta elettronica per lo stesso gruppo di utenti. Ad esempio, se si importano 100 nuovi utenti nell'organizzazione microsoft 365 o Office 365, creare un batch di migrazione per gli stessi 100 utenti. Si tratta di un modo efficace per organizzare e gestire la migrazione da un sistema di messaggistica locale a Office 365.

Specificare credenziali dell'utente finale o dell'amministratore

Nel file CSV è necessario specificare il nome utente e la password per l'account locale dell'utente. In questo modo il processo di migrazione può accedere all'account. È possibile eseguire questa operazione in due modi:

  • Usare le credenziali utente: è necessario ottenere le password degli utenti o modificare le password in un valore noto in modo da poterle includere nel file CSV.

    Consiglio

    Se si utilizza questa opzione, impedire agli utenti di modificare la password dell'account locale. Se gli utenti modificano le password dopo la migrazione iniziale, le successive sincronizzazioni tra le cassette postali nel server IMAP e Office 365 cassette postali avranno esito negativo.

  • Usare le credenziali di amministratore o utente con privilegi avanzati: è necessario usare un account nel sistema di messaggistica IMAP con i diritti necessari per accedere a tutte le cassette postali degli utenti. Nel file CSV utilizzare le credenziali di questo account per ogni riga. Per stabilire se il server IMAP supporta questo approccio e per informazioni su come abilitarlo, vedere la documentazione relativa al server IMAP.

    Nota

    È consigliabile utilizzare credenziali di amministratore in quanto questa modalità non influisce sugli utenti né implica alcun problema per gli stessi. Non sarà ad esempio un problema se gli utenti modificano le password dopo la migrazione iniziale.

Formato delle credenziali di amministratore per server IMAP diversi

È possibile usare il nome utente e la password di un account amministratore nei campi UserName e Password per ogni riga del file CSV. Il nome utente per le credenziali di amministratore è una combinazione del nome utente per la persona di cui viene eseguita la migrazione della posta elettronica e del nome utente per un account amministratore che dispone dell'autorizzazione per accedere a tutte le cassette postali utente. Il formato supportato per le credenziali di amministratore cambia in base al tipo di server IMAP da cui si sta eseguendo la migrazione della posta elettronica. Per ulteriori informazioni su come utilizzare le credenziali di amministratore, vedere la documentazione relativa al server IMAP.

Nota

Quando si invia una nuova richiesta di migrazione, il file CSV viene caricato nel data center Microsoft su una connessione SSL (Secure Sockets Layer). Le informazioni presenti nel file CSV vengono crittografate e archiviate nei server di Microsoft Exchange nel datacenter Microsoft.

Nelle sezioni seguenti viene spiegato come formattare le credenziali di amministratore nel file CSV che si utilizza per eseguire la migrazione della posta elettronica da tipi diversi di server IMAP.

Microsoft Exchange

Se si sta eseguendo la migrazione della posta elettronica dall'implementazione IMAP per Microsoft Exchange, utilizzare il formato Dominio/NomeUtente_Amministratore/NomeUtente_Utente per l'attributo UserName nel file CSV. Si supponga di eseguire la migrazione della posta elettronica da Exchange per Terry Adams, Ann Beebe e Paul Cannon. Si dispone di un account amministratore di posta, in cui il nome utente è mailadmin e la password è P@ssw0rd. Il file CSV risulterà simile al seguente:

EmailAddress,UserName,Password
terrya@contoso.edu,contoso-students/mailadmin/terry.adams,P@ssw0rd
annb@contoso.edu,contoso-students/mailadmin/ann.beebe,P@ssw0rd
paulc@contoso.edu,contoso-students/mailadmin/paul.cannon,P@ssw0rd

Dovecot

Per i server IMAP che supportano sasl (Simple Authentication and Security Layer), ad esempio un server IMAP Dovecot, usare il formato User_UserName*Admin_UserName, dove l'asterisco ( * ) è un carattere separatore configurabile. Si supponga di eseguire la migrazione della posta elettronica degli stessi utenti da un server IMAP Dovecot, con le credenziali di amministratore mailadmin e P@ssw0rd. Il file CSV risulterà simile al seguente:

EmailAddress,UserName,Password
terrya@contoso.edu,terry.adams*mailadmin,P@ssw0rd
annb@contoso.edu,ann.beebe*mailadmin,P@ssw0rd
paulc@contoso.edu,paul.cannon*mailadmin,P@ssw0rd

Mirapoint

Se si sta eseguendo la migrazione della posta elettronica da Mirapoint Message Server, utilizzare il formato #utente@dominio#NomeUtente_Amministratore# per le credenziali di amministratore. Per eseguire la migrazione della posta elettronica da Mirapoint con le credenziali di amministratore mailadmin e P@ssw0rd, il file CSV risulterà simile al seguente:

EmailAddress,UserName,Password
terrya@contoso.edu,#terry.adams@contoso-students.edu#mailadmin#,P@ssw0rd
annb@contoso.edu,#ann.beebe@contoso-students.edu#mailadmin#,P@ssw0rd
paulc@contoso.edu,#paul.cannon@contoso-students.edu#mailadmin#,P@ssw0rd

Utilizzare l'attributo facoltativo UserRoot

Alcuni server IMAP, ad esempio Courier IMAP, non supportano l'uso delle credenziali di amministratore per eseguire la migrazione delle cassette postali a Office 365. Per utilizzare le credenziali di amministratore per eseguire la migrazione delle cassette postali, è possibile configurare il server IMAP per utilizzare cartelle condivise virtuali. Le cartelle condivise virtuali consentono agli amministratori di utilizzare credenziali di accesso di amministratore per accedere alle cassette postali degli utenti nel server IMAP. Per ulteriori informazioni su come configurare le cartelle condivise virtuali per Courier IMAP, vedere Cartelle condivise.

Per eseguire la migrazione delle cassette postali dopo avere configurato cartelle condivise virtuali nel server IMAP, è necessario includere l'attributo UserRoot facoltativo nel file CSV. Questo attributo specifica il percorso della cassetta postale di ogni utente nella struttura di cartelle condivise virtuali nel server IMAP.

Di seguito è riportato un esempio di file CSV contenente l'attributo UserRoot:

EmailAddress,UserName,Password,UserRoot
terrya@contoso.edu,mailadmin,P@ssw0rd,/users/terry.adams
annb@contoso.edu,mailadmin,P@ssw0rd,/users/ann.beebe
paulc@contoso.edu,mailadmin,P@ssw0rd,/users/paul.cannon