Share via


Export-Mailbox (RTM)

 

Si applica a: Exchange Server 2007

Ultima modifica dell'argomento: 2007-06-05

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> -TargetFolder <String> -TargetMailbox <MailboxIdParameter> [-AllContentKeywords <String[]>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-ContentKeywords <String[]>] [-DeleteContent <SwitchParameter>] [-EndDate <DateTime>] [-ExcludeFolders <MapiFolderPath[]>] [-GlobalCatalog <Fqdn>] [-IncludeFolders <MapiFolderPath[]>] [-Locale <CultureInfo>] [-MaxThreads <Int32>] [-ReportFile <LocalLongFullPath>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <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.

Per ulteriori informazioni sulle autorizzazioni, sulla delega dei ruoli e sui diritti necessari per l'amministrazione di Exchange Server 2007, vedere Considerazioni sulle autorizzazioni.

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.

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. 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.

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.

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.

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.

ContentKeywords

Facoltativo

System.String[]

Il parametro ContentKeywords specifica 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.

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.

IncludeFolders

Facoltativo

Microsoft.Exchange.Data.Mapi.MapiFolderPath[]

Il parametro IncludeFolders specifica l'elenco delle cartelle da includere durante l'esportazione.

Locale

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.

ReportFile

Facoltativo

Microsoft.Exchange.Data.LocalLongFullPath

Il parametro ReportFile specifica il percorso e il nome file del registro dei rapporti XML.

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 consente al comando di simulare le azioni da intraprendere sull'oggetto. Utilizzando il parametro ValidateOnly, l'amministratore può visualizzare quali sono le modifiche che verrebbero apportate senza applicarle.

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.

Tipi di input

Tipi restituiti

Errori

Errore 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.

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"