Export-Mailbox
Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Ultima modifica dell'argomento: 2010-05-24
Il cmdlet Export-Mailbox consente di spostare i contenuti di una cassetta postale in una cartella delle cassette postali specificata.
Sintassi
export-Mailbox -Identity <MailboxIdParameter> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-DeleteAssociatedMessages <SwitchParameter>] [-DeleteContent <SwitchParameter>] [-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>]]
export-Mailbox -Identity <MailboxIdParameter> -TargetFolder <String> -TargetMailbox <MailboxIdParameter> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AllowMerge <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-DeleteAssociatedMessages <SwitchParameter>] [-DeleteContent <SwitchParameter>] [-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>]]
export-Mailbox -Identity <MailboxIdParameter> -PSTFolderPath <LongPath> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-DeleteAssociatedMessages <SwitchParameter>] [-DeleteContent <SwitchParameter>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeAssociatedMessages <SwitchParameter>] [-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 Export-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 alle cassette postali di origine e 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 concedere l'accesso completo a una cassetta postale, utilizzare il cmdlet Add-MailboxPermission e specificare FullAccess per il parametro AccessRights.
Non è possibile esportare i dati da una cassetta postale di una determinata foresta in una cassetta postale di una foresta diversa. Le cassette postali di origine e di destinazione devono trovarsi nella stessa foresta.
Per esportare dati in una cartella o in un file .pst è possibile utilizzare il cmdlet Export-Mailbox. Le cassette postali di origine e di destinazione devono trovarsi in una delle seguenti collocazioni:
Server Exchange 2007
Exchange Server 2003 Server Service Pack 2 (SP2) (o versioni successive)
Exchange 2000 Server Server Service Pack 3 (SP3) (o versioni successive)
Per esportare i dati da un file PST, è necessario eseguire il cmdlet Export-Mailbox da un computer a 32 bit in cui è installato quanto segue:
La versione a 32 bit degli strumenti di gestione di Exchange
Microsoft Office Outlook 2003 SP2 o versioni successive
Nota
Negli articoli della Microsoft Knowledge Base 289999 e 813593 viene descritto un problema che si verifica con l'utilizzo di Outlook 2003 quando si tenta di eliminare contemporaneamente più oggetti da una cartella. Non è possibile utilizzare il cmdlet Export-Mailbox per eliminare più di 4.000 oggetti da una cartella. Per esportare più oggetti, è necessario utilizzare Outlook 2007.
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) (informazioni in lingua inglese).
Non è possibile sportare i dati in un file PST da una cassetta postale che si trova in un gruppo di archiviazione di ripristino (RSG, recovery storage group).
Non è possibile esportare i dati da un database delle cartelle pubbliche.
Il cmdlet Export-Mailbox esporta tutte le cartelle vuote e le cartelle speciali nella posizione di destinazione. Le cartelle speciali sono:
Posta in arrivo
Posta eliminata
Bozze
Posta indesiderata
Posta in uscita
Posta inviata
Journal
Calendario
Contatti
Note
Attività
Il cmdlet Export-Mailbox, inoltre, esporta i messaggi del dumpster. Tali messaggi vengono convertiti in elementi normali nella cartella o nel file PST in cui si esportano i dati.
Se si esportano dati in un'altra cassetta postale utilizzando il parametro TargetMailbox, il cmdlet Export-Mailbox consente anche di esportare messaggi dal dumpster degli elementi eliminati. I messaggi provenienti dal dumpster vengono convertiti in messaggi normali quando vengono esportati.
Nota
Se si utilizzano parametri basati su parole chiave, il cmdlet Export-Mailbox esporterà tutti i messaggi, compresi quelli del dumpster; cercherà quindi nella cassetta postale di destinazione i messaggi che soddisfano tali parametri. I messaggi presenti nel dumpster nella cassetta postale di origine vengono convertiti in messaggi normali nella cassetta postale di destinazione; verrà inoltre effettuata una ricerca per parola chiave. Il cmdlet Export-Mailbox elimina quindi i messaggi nella cassetta postale di destinazione che non soddisfano i parametri basati sulle parole chiave. Se si utilizza anche il parametro DeleteContent, Export-Mailbox consentirà di eliminare i messaggi che soddisfano i criteri della parole chiave dalla cassetta postale di origine.
Per ulteriori informazioni sui messaggi contenuti nel dumpster, vedere Come ripristinare un elemento eliminato.
Parametri
Parametro | Obbligatorio | Tipo | Descrizione |
---|---|---|---|
Identity |
Obbligatorio |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
Il parametro Identity consente di specificare la cassetta postale da cui esportare i contenuti. È possibile utilizzare i seguenti valori:
Se si esegue il piping dell'oggetto comando Get-Mailbox, questo parametro non è obbligatorio. |
PSTFolderPath |
Obbligatorio |
Microsoft.Exchange.Data.LongPath |
Il parametro PSTFolderPath consente di specificare il percorso del file .pst in cui verranno esportati i dati. |
TargetFolder |
Obbligatorio |
System.String |
Il parametro TargetFolder consente di specificare la cartella per la cassetta postale di livello superiore che verrà creata nella cassetta postale specificata nel parametro TargetMailbox. La cartella conterrà una sottocartella denominata Dati recuperati - <alias cassetta postale di origine> - <timestamp data>. Tale sottocartella contiene i dati esportati. Se la cartella di destinazione specificata esiste già nella cassetta postale di destinazione, i dati esportati verranno aggiunti alla cartella esistente. Se non esiste, la cartella di destinazione verrà creata. |
TargetMailbox |
Obbligatorio |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
Il parametro TargetMailbox consente di specificare la cassetta postale in cui verrà creata la cartella di destinazione Per completare il comando è necessario che la cassetta postale specificata esista. |
AllContentKeywords |
Facoltativo |
System.String[] |
Il parametro AllContentKeywords specifica le parole chiave del contenuto da includere nello spostamento. Se una parola chiave specificata nel corpo del messaggio, negli allegati o nell'oggetto, viene trovata dal comando, tali messaggi verranno esportati. Il buffer per il parametro AllContentKeywords è 32 KB. Nota Ciò è diverso dall'utilizzo di entrambi i parametri ContentKeywords e SubjectKeywords. Se si utilizzano entrambi i parametri ContentKeywords e SubjectKeywords, verranno esportati 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. |
AllowMerge |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro AllowMerge consente di specificare l'unione del contenuto esportato alla cartella di destinazione in modo da evitare duplicati. Se si specifica il parametro AllowMerge, il nome della sottocartella in cui viene esportato il contenuto non includerà un indicatore di data/ora. È possibile esportare dati nella stessa cartella e sottocartella di destinazione più volte utilizzando il parametro AllowMerge. |
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 esportare gli elementi con l'estensione txt. |
BadItemLimit |
Facoltativo |
System.Int32 |
Il parametro BadItemLimit consente di specificare il numero di elementi corrotti in una cassetta postale che devono essere ignorati prima della mancata riuscita dell'operazione di esportazione. |
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 nello spostamento. Se una parola chiave specificata nel corpo del messaggio o negli allegati viene trovata dal comando, tali messaggi verranno esportati. |
DeleteAssociatedMessages |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro DeleteAssociatedMessages consente di specificare l'eliminazione dei messaggi associati; I messaggi associati contengono i dati nascosti con informazioni su regole, viste e moduli. Se si utilizza il parametro DeleteAssociatedMessages e non si specifica un'opzione per TargetMailbox e TargetFolder o PSTFolderPath, non verrà esportato alcun contenuto. |
DeleteContent |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro DeleteContent consente di specificare l'opzione per eliminare il contenuto dalla cassetta postale di origine dopo che è stata esportata in una cartella. La cartella di origine non verrà eliminata. |
EndDate |
Facoltativo |
System.DateTime |
Il parametro EndDate consente di specificare la data di fine per l'applicazione del filtro al contenuto che verrà esportato dalla cassetta postale di origine. Verranno esportati solo gli elementi della cassetta postale 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 specifica l'elenco delle cartelle da escludere durante l'esportazione. |
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. |
IncludeAssociatedMessages |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro IncludeAssociatedMessages consente di specificare l'inclusione nell'esportazione dei messaggi associati; I messaggi associati contengono i dati nascosti con informazioni su regole, viste e moduli. Per impostazione predefinita i messaggi associati non vengono inclusi in un'esportazione. |
IncludeFolders |
Facoltativo |
Microsoft.Exchange.Data.Mapi.MapiFolderPath[] |
Il parametro IncludeFolders specifica l'elenco delle cartelle da includere durante l'esportazione. |
Impostazione internazionale |
Facoltativo |
System.Globalization.CultureInfo |
Il parametro Locale specifica le impostazioni locali dei messaggi da esportare. Verranno esportati dal comando solo i messaggi con le impostazioni locali 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 gli indirizzi di posta elettronica o i nomi visualizzati dei destinatari. Se il comando trova un messaggio con un destinatario che corrisponde alla parola chiave per il destinatario specificata, esporta il messaggio. Se la parola chiave per il destinatario specificata corrisponde a un gruppo di distribuzione destinatario di un messaggio, il messaggio verrà esportato. Il comando non consente di espandere i gruppi di distribuzione per confrontare le parole chiave specificate per il destinatario con i membri di un gruppo di distribuzione destinatario di un messaggio. |
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 gli indirizzi di posta elettronica o i nomi visualizzati dei mittenti. Se il comando trova un messaggio con un mittente che corrisponde alla parola chiave per il mittente specificata, esporta il messaggio. |
StartDate |
Facoltativo |
System.DateTime |
Il parametro StartDate consente di specificare la data di inizio per il filtro del contenuto che viene esportato dalla cassetta postale di origine. Verranno esportati solo gli elementi della cassetta postale la cui data è successiva 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. |
SubjectKeywords |
Facoltativo |
System.String[] |
Il parametro SubjectKeywords consente di specificare i filtri per le parole chiave degli oggetti degli elementi della cassetta postale di origine. |
ValidateOnly |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro ValidateOnly fornisce l'opzione di convalida dell'esportazione senza esportare effettivamente i dati. Il parametro ValidateOnly consente di convalidare i prerequisiti per il comando. Nota Se si esegue il comando Export-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 di indicare al comando di simulare le azioni da eseguire 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
irreversibile | Descrizione |
---|---|
|
Eccezioni
Eccezioni | Descrizione |
---|---|
|
Esempio
Nel primo esempio viene illustrato come esportare i contenuti della cassetta postale dell'utente john@contoso.com nella cartella "MyData" della cassetta postale ExportMailbox.
Nel secondo esempio viene illustrato come utilizzare i filtri per specificare gli elementi della cassetta postale di origine da includere nell'esportazione. In questo esempio verranno esportati tutti gli elementi dalla cassetta postale dell'utente contoso\john ai quali è associata la parola chiave "merger" nel corpo del messaggio o nel contenuto di un allegato, che dispongono di un allegato denominato *orgchart* e la cui data è successiva al 01/03/2006 alle 12.01.00.
Nel terzo esempio viene illustrato come individuare ed eliminare elementi delle cassette postali. In questo esempio vengono prima restituite tutte le cassette postali nel database "DB1", quindi vengono ricercati gli elementi contenenti la stringa "Virus message" nell'oggetto. Gli elementi vengono esportati in un'altra cassetta postale e quelli originali vengono rimossi dalla cassetta postale di origine.
Nel quarto esempio viene illustrato come eseguire il piping dei dati prodotti dal comando Get-User al comando Export-Mailbox. Nell'esempio vengono escluse dall'esportazione due cassette postali. Gli elementi delle cartelle Posta indesiderata (Junk E-Mail) e Contatti (Contacts) della cassetta postale dell'utente John non vengono esportati in ExportMailbox.
Nota
È inoltre possibile eseguire il piping dei dati prodotti da Get-Recipient o da Get-Mailbox a Export-Mailbox.
Nel quinto esempio viene illustrato come esportare il contenuto della cassetta postale dell'utente denominato john@contoso.com in un file .pst denominato john.pst archiviato nella directory C:\PSTFiles.
Nel sesto esempio viene illustrato come esportare dati da tutte le cassette postali degli utenti nell'unità organizzativa Marketing. I dati provenienti da ciascuna cassetta postale verranno esportati in un file .pst separato archiviato nella directory C:\PSTFiles. Il nome di ciascun file PST sarà <alias>.pst. I messaggi che verranno esportati saranno quelli i cui destinatari includano i nominativi tony@fabrikam.com o christine@fabrikam.com.
Export-Mailbox -Identity john@contoso.com -TargetMailbox ExportMailbox -TargetFolder MyData
Export-Mailbox -Identity contoso\john -TargetMailbox ExportMailbox -TargetFolder MyData -ContentKeywords "merger" -AttachmentFilenames "*orgchart*" -StartDate "03/01/2006 12:01:00"
Get-Mailbox -Database DB1 | Export-Mailbox -TargetMailbox ExportMailbox -TargetFolder VirusData -SubjectKeywords "Virus message" -DeleteContent
Get-User john | Export-Mailbox -TargetMailbox ExportMailbox -TargetFolder MyData -ExcludeFolders "\Junk E-Mail","\Contacts"
Export-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst
Get-Mailbox -OrganizationalUnit Marketing | Export-Mailbox -PSTFolderPath C:\PSTFiles -RecipientKeywords "tony@fabrikam.com","christine@fabrikam.com"