Export-Mailbox
Si applica a: Exchange Server 2010
Ultima modifica dell'argomento: 2009-07-07
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[]>] [-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[]>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
export-Mailbox -Identity <MailboxIdParameter> -TargetFolder <String> -TargetMailbox <MailboxIdParameter> [-AllContentKeywords <String[]>] [-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[]>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
export-Mailbox -Identity <MailboxIdParameter> -PSTFolderPath <LongPath> [-AllContentKeywords <String[]>] [-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[]>] [-SenderKeywords <String[]>] [-StartDate <DateTime>] [-SubjectKeywords <String[]>] [-ValidateOnly <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
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 della 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> - <indicatore di data/ora>. 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 sia quella specificata per il parametro SubjectKeywords nell'oggetto.
|
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. È possibile utilizzare, ad esempio, "*.txt" per esportare gli elementi con estensione .txt. |
BadItemLimit |
Facoltativo |
System.Int32 |
Il parametro BadItemLimit consente di specificare il numero di elementi danneggiati in una cassetta postale che devono essere ignorati prima della mancata riuscita dell'operazione di esportazione. |
Confirm |
Facoltativo |
System.Management.Automation.SwitchParameter |
L'opzione Confirm consente di sospendere l'elaborazione; l'utente deve confermare l'operazione che verrà eseguita dal comando prima che l'elaborazione continui. Con l'opzione Confirm non è necessario specificare un valore. |
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. |
DeleteAssociatedMessages |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro DeleteAssociatedMessages consente di specificare l'eliminazione dei messaggi associati; questi messaggi contengono dati nascosti con informazioni su regole, visualizzazioni e moduli. Se si utilizza il parametro DeleteAssociatedMessages ma non si specificano i parametri TargetMailbox e TargetFolder , o se si utilizza il parametro PSTFolderPath , il contenuto non viene esportato. |
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 viene 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 sul computer locale. Ad esempio, se il computer è configurato per l'utilizzo del formato data breve gg/mm/aaaa, immettere 01/03/2010 per specificare il 1° marzo 2010. |
ExcludeFolders |
Facoltativo |
Microsoft.Exchange.Data.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 che i messaggi associati sono incluse nell'esportazione. questi messaggi contengono dati nascosti con informazioni su regole, visualizzazioni e moduli. Per impostazione predefinita i messaggi associati non sono inclusi in un'esportazione. |
IncludeFolders |
Facoltativo |
Microsoft.Exchange.Data.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. Il valore predefinito è 4. |
RecipientKeywords |
Facoltativo |
System.String[] |
Il parametro RecipientKeywords consente di specificare gli indirizzi di posta elettronica dei destinatari o di visualizzarne i nomi. 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 viene 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. |
SenderKeywords |
Facoltativo |
System.String[] |
Il parametro SenderKeywords consente di specificare gli indirizzi di posta elettronica dei mittenti o di visualizzarne i nomi. 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 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 è successiva alla data di inizio. Quando si immette una data specifica, utilizzare il formato data breve definito nelle impostazioni delle Opzioni internazionali configurate sul computer locale. Ad esempio, se il computer è configurato per l'utilizzo del formato data breve gg/mm/aaaa, immettere 01/03/2010 per specificare il 1° marzo 2010. |
SubjectKeywords |
Facoltativo |
System.String[] |
Il parametro SubjectKeywords consente di specificare i filtri per le parole chiave degli oggetti degli elementi nella 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 eventuali prerequisiti per il comando.
Nota:
Se si esegue il comando Export-Mailbox con 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 |
L'opzione WhatIf consente di indicare al comando di simulare le azioni da intraprendere sull'oggetto. Utilizzando l'opzione WhatIf, è possibile visualizzare quali modifiche verrebbero apportate, senza doverle applicare. Con l'opzione WhatIf non è necessario specificare un valore. |
Descrizione dettagliata
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 su un server che esegue Microsoft Exchange Server 2010.
Per esportare i dati da un file .pst, è necessario eseguire il cmdlet Export-Mailbox su un server Exchange su cui è installata la versione a 64 bit di Microsoft Outlook 2010. Si consiglia di eseguire il comando su un server Exchange dedicato che non contiene cassette postali.
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à
Nota
Exchange 2010 non esporta i dati del dumpster.
Nota
Se si utilizzano parametri basati su parole chiave, il cmdlet Export-Mailbox esporterà prima tutti i messaggi, quindi cercherà nella cassetta postale di destinazione i messaggi che soddisfano i criteri delle parole chiave. I messaggi presenti nel dumpster della 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 consente di eliminare i messaggi nella cassetta postale di destinazione che non soddisfano i criteri delle parole chiave. Se si utilizza anche il parametro DeleteContent, il cmdlet Export-Mailbox consente di eliminare i messaggi che soddisfano i criteri delle parole chiave provenienti dalla cassetta postale di origine.
È necessario assegnare le autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per visualizzare quali autorizzazioni siano necessarie, vedere Voce "Importa\Esporta cassetta postale" nell'argomento Autorizzazioni per la cassetta postale.
Tipi di input
Tipi restituiti
Errori
Errore | Descrizione |
---|---|
|
Eccezioni
Eccezioni | Descrizione |
---|---|
|
Esempi
ESEMPIO 1:
Con questo esempio viene esportato il contenuto della cassetta postale dell'utente john@contoso.com nella cartella MyData della cassetta postale ExportMailbox.
Export-Mailbox -Identity john@contoso.com -TargetMailbox ExportMailbox -TargetFolder MyData
ESEMPIO 2:
Con questo esempio vengono utilizzati i filtri per specificare gli elementi della cassetta postale di origine da includere nell'esportazione. Con questo esempio vengono 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 il cui nome contiene la stringa "orgchart" e la cui data è successiva al 1° marzo 2010, 12:01:00.
Export-Mailbox -Identity contoso\john -TargetMailbox ExportMailbox -TargetFolder MyData -ContentKeywords "merger" -AttachmentFilenames "*orgchart*" -StartDate "03/01/2010 12:01:00"
ESEMPIO 3:
Con questo esempio vengono trovati ed elimina gli elementi di una cassetta postale. Con questo esempio vengono prima recuperate 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.
Get-Mailbox -Database DB1 | Export-Mailbox -TargetMailbox ExportMailbox -TargetFolder VirusData -SubjectKeywords "Virus message" -DeleteContent
ESEMPIO 4:
Con questo esempio viene eseguito il piping dal comando Get-User al comando Export-Mailbox. Con questo esempio vengono inoltre escluse due cartelle dall'esportazione. Gli elementi delle cartelle Posta indesiderata (Junk E-Mail) e Contatti (Contacts) della cassetta postale dell'utente John non vengono esportati nella cassetta postale di destinazione ExportMailbox.
Nota
È inoltre possibile eseguire il piping dei dati prodotti dai cmdlet Get-Recipient o Get-Mailbox nel cmdletExport-Mailbox.
Get-User john | Export-Mailbox -TargetMailbox ExportMailbox -TargetFolder MyData -ExcludeFolders "\Junk E-mail","\Contacts"
ESEMPIO 5:
Con questo esempio viene esportato il contenuto della cassetta postale dell'utente denominato john@contoso.com in un file .pst denominato john.pst archiviato nella directory C:\PSTFiles.
Export-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst
ESEMPIO 6:
Con questo esempio vengono esportati i dati da tutte le cassette postali degli utenti dell'unità organizzativa Marketing. I dati provenienti da ciascuna cassetta postale vengono esportati in un file .pst separato archiviato nella directory C:\PSTFiles. Il nome di ogni file .pst è <alias>.pst. I messaggi esportati sono quelli i cui destinatari includono i nominativi tony@fabrikam.com o christine@fabrikam.com.
Get-Mailbox -OrganizationalUnit Marketing | Export-Mailbox -PSTFolderPath C:\PSTFiles -RecipientKeywords "tony@fabrikam.com","christine@fabrikam.com"