Import-Mailbox
Si applica a: Exchange Server 2010
Ultima modifica dell'argomento: 2009-07-12
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>] [-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 |
---|---|---|---|
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 importati. ![]()
Ciò è diverso dall'utilizzo di entrambi i parametri ContentKeywords e SubjectKeywords. Se si utilizza sia il parametro ContentKeywords che il parametro SubjectKeywords, il comando importa solo i messaggi contenenti sia la parola chiave specificata per il parametro ContentKeywords nell'allegato o nel corpo del messaggio che la parola chiave specificata per il parametro SubjectKeywords nell'oggetto.
|
AllowDuplicates |
Facoltativo |
System.Management.Automation.SwitchParameter |
L'opzione AllowDuplicates consente di specificare se copiare gli elementi di posta elettronica senza controllare che siano dei duplicati degli elementi esistenti. Si consiglia di utilizzare il parametro AllowDuplicates con il 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 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 |
L'opzione Confirm può essere utilizzata per sopprimere il prompt di conferma visualizzato per impostazione predefinita quando viene eseguito questo cmdlet. Per sopprimere il prompt di conferma, utilizzare la sintassi |
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 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 03/01/2010 per specificare il 1° marzo 2010. |
ExcludeFolders |
Facoltativo |
Microsoft.Exchange.Data.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, tale parametro non è obbligatorio. |
IncludeAssociatedMessages |
Facoltativo |
System.Management.Automation.SwitchParameter |
Il parametro IncludeAssociatedMessages consente di specificare che i messaggi associati sono inclusi nel'importazione. questi messaggi contengono dati nascosti con informazioni su regole, visualizzazioni e moduli. Per impostazione predefinita, i messaggi associati non vengono inclusi nell'importazione. |
IncludeFolders |
Facoltativo |
Microsoft.Exchange.Data.MapiFolderPath[] |
Il parametro IncludeFolders consente di specificare l'elenco delle cartelle da includere durante l'importazione. Quando si utilizza questo parametro, solo le cartelle nell'elenco dei parametri vengono incluse nell'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. |
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 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 03/01/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 nel file .pst. |
ValidateOnly |
Facoltativo |
System.Management.Automation.SwitchParameter |
L'opzione ValidateOnly consente di indicare al cmdlet di valutare le condizioni e i requisiti necessari per eseguire l'operazione e quindi di segnalare se l'operazione avrà esito positivo o negativo. Quando viene utilizzata l'opzione ValidateOnly non vengono apportate modifiche. ![]()
Se si esegue il comando Import-Mailbox con questa opzione, il comando non applicherà alcun filtro ai messaggi. Il comando si limita 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
Per importare i dati da un file .pst, è necessario eseguire il cmdlet Import-Mailbox da un computer che esegue Microsoft Exchange Server 2010 in cui è installata una versione a 64 bit di Microsoft Outlook 2010. Si consiglia di eseguire il comando su un server di Exchange dedicato privo di cassette postali.
È possibile importare i dati da un file .pst solo in una cassetta postale che si trova in un server di Exchange 2010 in cui è installato il ruolo del server Cassette postali utilizzando il cmdlet Import-Mailbox. Per importare i dati da un file .pst a una cassetta postale su un server di Exchange Server 2007, utilizzare la versione Exchange 2007 del cmdlet Import-Mailbox. Per importare i dati da un file .pst in una cassetta postale che si trova su un server di Exchange Server 2003, è necessario utilizzare la procedura guidata per l'unione delle cassette postali di Microsoft Exchange Server (ExMerge.exe).
Non è possibile importare i dati utilizzando il cmdlet Import-Mailbox da un file .pst in una cassetta postale che si trova in un database di ripristino.
Non è possibile importare i dati utilizzando il cmdlet Import-Mailbox in un database delle cartelle pubbliche.
È 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 "Importa\Esporta cassetta postale" nell'argomento Autorizzazioni per la cassetta postale.
Tipi di input
Tipi restituiti
Errori
Errore | Descrizione |
---|---|
|
Esempi
ESEMPIO 1:
In questo esempio vengono importati i dati dal file C:\PSTFiles\john.pst alla cassetta postale esistente e connessa di john@contoso.com.
Import-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst
ESEMPIO 2:
In questo esempio vengono importati i dati da tutti i file .pst posizionati su C:\PSTFiles nelle 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 2010.
Dir C:\PSTFiles | Import-Mailbox -StartDate 01/01/2010
ESEMPIO 3:
In questo esempio vengono importati i dati dai file .pst nelle 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 su C:\PSTFiles non sono presenti file .pst per un utente nell'unità organizzativa Marketing, verrà visualizzato un messaggio di errore.
Get-Mailbox -OrganizationalUnit Marketing | Import-Mailbox -PSTFolderPath C:\PSTFiles