Import-Mailbox
Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Ultima modifica dell'argomento: 2011-06-21
Utilizzare il cmdlet Import-Mailbox per importare dati relativi alle cassette postali da un file .pst in una cassetta postale.
Sintassi
import-Mailbox [-Identity <MailboxIdParameter>] -PSTFolderPath <LongPath> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-RecipientKeywords <String[]>] [-ReportFile <LocalLongFullPath>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Per eseguire il cmdlet Import-Mailbox, è necessario utilizzare un account che disponga della seguente delega:
Ruolo Exchange Server Administrator e appartenenza al gruppo Administrators locale del server di destinazione.
Accesso completo alla cassetta postale di destinazione
Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Microsoft Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.
Per consentire l'accesso completo a una cassetta postale, utilizzare il cmdlet Add-MailboxPermission e specificare FullAccess per il parametro AccessRights.
Per importare dati da un file .pst, è necessario eseguire il cmdlet Import-Mailbox da un computer a 32 bit con i seguenti componenti installati:
Versione a 32 bit degli strumenti di gestione di Exchange
Microsoft Office Outlook 2003 Service Pack 2 (SP2) o versioni successive
Per informazioni su come scaricare la versione a 32 bit degli strumenti di gestione di Exchange 2007, vedere Microsoft Exchange Server 2007 Management Tools (32-Bit) - Italiano.
Per importare dati in una cartella o in un file .pst è possibile utilizzare il cmdlet Import-Mailbox. Le cassette postali di origine e di destinazione devono trovarsi su un computer su cui è in esecuzione una delle seguenti versioni di Microsoft Exchange:
Exchange Server 2007
Exchange Server 2003 Service Pack 2 (SP2) (o versioni successive)
Exchange 2000 Server Service Pack 3 (SP3) (o versioni successive)
Per importare dati da un file .pst in una cassetta postale in una versione precedente di Exchange, è necessario utilizzare la procedura guidata per l'unione delle cassette postali di Microsoft Exchange Server (ExMerge.exe) (pagina in inglese).
Non è possibile importare dati utilizzando il cmdlet Import-Mailbox da un file .pst in una cassetta postale che si trova in un gruppo di archiviazione di ripristino (RSG, Recovery Storage Group).
Non è possibile importare dati utilizzando il cmdlet Import-Mailbox in un database delle cartelle pubbliche.
Nota
Non è necessario configurare un profilo MAPI se si utilizza il cmdlet Import-Mailbox.
Parametri
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
PSTFolderPath |
Obbligatorio |
Microsoft.Exchange.Data.LongPath |
Il parametro PSTFolderPath consente di specificare il percorso del file .pst dal quale verranno importati i dati. |
AllContentKeywords |
Facoltativo |
System.String[] |
Il parametro AllContentKeywords consente di specificare le parole chiave del contenuto da includere nell'importazione. Se una parola chiave specificata nel corpo del messaggio, negli allegati o nell'oggetto, viene trovata dal comando, tali messaggi verranno esportati. Nota Ciò è diverso dall'utilizzo di entrambi i parametri ContentKeywords e SubjectKeywords. Se si utilizzano entrambi i parametri ContentKeywords e SubjectKeywords, verranno importati dal comando solo i messaggi contenenti sia la parola chiave specificata per il parametro ContentKeywords nel corpo del messaggio o negli allegati che quella indicata per il parametro SubjectKeywords nell'oggetto. |
AllowDuplicates |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro AllowDuplicates viene utilizzato per copiare gli elementi di posta senza controllare se sono duplicati di elementi esistenti e senza rimuovere gli elementi duplicati. Si consiglia di utilizzare il parametro AllowDuplicates insieme al parametro IncludeFolders. |
AttachmentFilenames |
Facoltativo |
System.String[] |
Il parametro AttachmentFilenames consente di specificare il filtro per gli allegati. Nella stringa è possibile utilizzare caratteri jolly. Ad esempio, è possibile utilizzare "*.txt" per importare gli elementi con l'estensione txt. |
BadItemLimit |
Facoltativo |
System.Int32 |
Il parametro BadItemLimit consente di specificare il numero di elementi danneggiati in un file .pst che devono essere ignorati prima della mancata riuscita dell'operazione di importazione. |
Confirm |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro Confirm consente di determinare la sospensione dell'elaborazione e di richiedere che l'utente confermi l'operazione che verrà eseguita dal comando prima che l'elaborazione continui. Con il parametro Confirm non è necessario specificare un valore. |
ContentKeywords |
Facoltativo |
System.String[] |
Il parametro ContentKeywords consente di specificare le parole chiave del contenuto da includere nell'importazione. Se una parola chiave specificata nel corpo del messaggio o negli allegati viene trovata dal comando, tali messaggi verranno importati. |
EndDate |
Facoltativo |
System.DateTime |
Il parametro EndDate consente di specificare la data di fine per il filtro del contenuto che verrà importato nella cassetta postale di destinazione. Verranno importati solo gli elementi del file .pst la cui data risulta uguale o precedente alla data di fine. Quando si immette una data specifica, utilizzare il formato data breve definito nelle impostazioni delle opzioni internazionali configurate nel computer locale. Ad esempio, se il computer è configurato per l'utilizzo del formato data breve gg/mm/aaaa, immettere 01/03/2006 per specificare il 1° marzo 2006. |
ExcludeFolders |
Facoltativo |
Microsoft.Exchange.Data.Mapi.MapiFolderPath[] |
Il parametro ExcludeFolders consente di specificare l'elenco delle cartelle da escludere durante l'importazione. |
GlobalCatalog |
Facoltativo |
Microsoft.Exchange.Data.Fqdn |
Il parametro GlobalCatalog consente di specificare il catalogo globale da utilizzare per la ricerca della cassetta postale di destinazione. |
Identity |
Facoltativo |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
Il parametro Identity consente di specificare l'oggetto cassetta postale di destinazione in cui si desidera importare i dati. È possibile utilizzare uno dei seguenti valori:
Se si esegue il piping dell'oggetto comando Get-Mailbox, questo parametro non è obbligatorio. |
IncludeFolders |
Facoltativo |
Microsoft.Exchange.Data.Mapi.MapiFolderPath[] |
Il parametro IncludeFolders consente di specificare l'elenco delle cartelle da includere durante l'importazione. |
Locale |
Facoltativo |
System.Globalization.CultureInfo |
Il parametro Locale consente di specificare le impostazioni internazionali dei messaggi da importare. Verranno importati dal comando solo i messaggi con le impostazioni internazionali specificate. |
MaxThreads |
Facoltativo |
System.Int32 |
Il parametro MaxThreads specifica il numero massimo di thread da utilizzare. Il valore predefinito è 4. |
RecipientKeywords |
Facoltativo |
System.String[] |
Il parametro RecipientKeywords consente di specificare le parole chiave del contenuto da includere nell'importazione. Se una parola chiave specificata nell'elenco dei destinatari viene trovata dal comando, tali messaggi verranno importati. |
ReportFile |
Facoltativo |
Microsoft.Exchange.Data.LocalLongFullPath |
Il parametro ReportFile specifica il percorso e il nome file del registro dei rapporti XML. |
SenderKeywords |
Facoltativo |
System.String[] |
Il parametro SenderKeywords consente di specificare le parole chiave del contenuto da includere nell'importazione. Se una parola chiave specificata nell'elenco dei mittenti viene trovata dal comando, tali messaggi verranno importati. |
StartDate |
Facoltativo |
System.DateTime |
Il parametro StartDate consente di specificare la data di inizio per il filtro del contenuto che viene importato nella cassetta postale di destinazione. Verranno importati solo gli elementi del file .pst la cui data risulta successiva alla data di inizio. Quando si immette una data specifica, utilizzare il formato data breve definito nelle impostazioni delle opzioni internazionali configurate nel computer locale. Ad esempio, se il computer è configurato per l'utilizzo del formato data breve gg/mm/aaaa, immettere 01/03/2006 per specificare il 1° marzo 2006. |
SubjectKeywords |
Facoltativo |
System.String[] |
Il parametro SubjectKeywords consente di specificare i filtri per le parole chiave degli oggetti degli elementi nel file .pst. |
ValidateOnly |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro ValidateOnly fornisce l'opzione di convalida dell'importazione senza importare effettivamente i dati. Il parametro ValidateOnly consente di convalidare eventuali prerequisiti per il comando. Nota Se si esegue il comando Import-Mailbox specificando questo parametro, i messaggi non verranno filtrati. Il comando si limiterà a verificare l'esistenza delle cassette postali di origine e di destinazione. |
WhatIf |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro WhatIf consente al comando di simulare le azioni da intraprendere sull'oggetto. Il parametro WhatIf consente di visualizzare le modifiche che verrebbero apportate senza applicarle. Con il parametro WhatIf non è necessario specificare un valore. |
Tipi di input
Tipi restituiti
Errori
| Errore | Descrizione |
|---|---|
|
Esempio
Nel primo esempio viene mostrato come importare i dati dal file C:\PSTFiles\john.pst alla cassetta postale esistente e connessa di john@contoso.com.
Nel secondo esempio viene mostrato come importare i dati da tutti i file .pst che si trovano in C:\PSTFiles in cassette postali esistenti. È necessario denominare i file .pst <alias>.pst, dove alias è l'alias della cassetta postale in cui i dati verranno importati. Per ogni file .pst verranno importati nella cassetta postale solo i messaggi ricevuti dopo il 1° gennaio 2007.
Nel terzo esempio viene mostrato come importare dati da file .pst in cassette postali i cui utenti si trovano nell'unità organizzativa Marketing. È necessario denominare i file .pst <alias>.pst, dove alias è l'alias della cassetta postale in cui i dati verranno importati. Verranno importati solo i file .pst il cui alias corrisponde a un utente nell'unità organizzativa Marketing. Se in C:\PSTFiles non sono presenti file .pst per un utente nell'unità organizzativa Marketing, verrà visualizzato un messaggio di errore.
Import-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst
Dir C:\PSTFiles | Import-Mailbox -StartDate 01/01/2007
Get-Mailbox -OrganizationalUnit Marketing | Import-Mailbox -PSTFolderPath C:\PSTFiles