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:

  • Alias

  • Indirizzo SMTP (Simple Mail Transfer Protocol)

  • Nome visualizzato

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"