Import-Mailbox
適用版本: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
上次修改主題的時間: 2011-06-21
使用 Import-Mailbox 指令程式從 .pst 檔案將信箱資料匯入信箱。
語法
import-Mailbox [-Identity <MailboxIdParameter>] -PSTFolderPath <LongPath> [-AllContentKeywords <String[]>] [-AllowDuplicates <SwitchParameter>] [-AttachmentFilenames <String[]>] [-BadItemLimit <Int32>] [-Confirm [<SwitchParameter>]] [-ContentKeywords <String[]>] [-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>]]
詳細描述
若要執行 Import-Mailbox 指令程式,必須對您使用的帳戶委派下列項目:
- Exchange Server 系統管理員角色及目標伺服器的本機 Administrators 群組
- 目標信箱的完整存取
如需管理 Microsoft Exchange Server 2007 所需之權限、委派角色及權利的相關資訊,請參閱權限考量。
若要授與信箱的完整存取權,請使用 Add-MailboxPermission 指令程式並且對 AccessRights 參數指定 FullAccess。
若要從 .pst 檔案匯入資料,您必須從已安裝下列項目的 32 位元電腦執行 Import-Mailbox 指令程式:
- 32 位元版本的 Exchange 管理工具
- Microsoft Office Outlook 2003 Service Pack 2 (SP2) 或更新版本
如需 32 位元 Exchange 2007 管理工具的下載資訊,請參閱 Microsoft Exchange Server 2007 管理工具 (32 位元) - 繁體中文。
您可以使用 Import-Mailbox 指令程式,將資料匯入至資料夾或 .pst 檔案。來源和目標信箱必須位於執行下列其中一個 Exchange 版本的電腦上:
- Exchange Server 2007
- Exchange Server 2003 Service Pack 2 (SP2) 或更新版本
- Exchange 2000 Server Service Pack 3 (SP3) 或更新版本
若要將資料從 .pst 檔案匯入至其他任何 Exchange 版本的信箱,則必須使用 Microsoft Exchange Server Mailbox Merge Wizard (ExMerge.exe) (英文)。
您無法使用 Import-Mailbox 指令程式從 .pst 檔案將資料匯入復原儲存群組 (RSG) 中的信箱。
您無法使用 Import-Mailbox 指令程式將資料匯入公用資料夾資料庫。
附註: |
---|
當您使用 Import-Mailbox 指令程式時,並不需要設定 MAPI 設定檔。 |
參數
參數 | 必要 | 類型 | 描述 | ||
---|---|---|---|---|---|
PSTFolderPath |
必要 |
Microsoft.Exchange.Data.LongPath |
PSTFolderPath 參數指定要從中匯入資料之 .pst 檔案的路徑。 |
||
AllContentKeywords |
選用 |
System.String[] |
AllContentKeywords 參數指定要匯入之內容的關鍵字。如果命令找到您在郵件內文、附件內容或主旨中指定的關鍵字,它就會匯入那些郵件。
|
||
AllowDuplicates |
選用 |
System.Management.Automation.SwitchParameter |
AllowDuplicates 參數可用於複製郵件項目,但不需檢查郵件項目是否與現有項目重複,也不需移除重複的項目。建議您搭配使用 AllowDuplicates 參數和 IncludeFolders 參數。 |
||
AttachmentFilenames |
選用 |
System.String[] |
AttachmentFilenames 參數指定附件的篩選器。您可以在字串中使用萬用字元。例如,您可以使用 "*.txt" 匯入副檔名為 .txt 的項目。 |
||
BadItemLimit |
選用 |
System.Int32 |
BadItemLimit 參數指定在匯入作業失敗之前,.pst 檔案中略過的毀損項目數。 |
||
Confirm |
選用 |
System.Management.Automation.SwitchParameter |
Confirm 參數會使得命令暫停處理,並要求確認命令將進行的動作之後才會繼續處理。您不需要為 Confirm 參數指定任何值。 |
||
ContentKeywords |
選用 |
System.String[] |
ContentKeywords 參數指定要匯入之內容的關鍵字。如果命令找到您在郵件內文或附件內容中指定的關鍵字,它就會匯入那些郵件。 |
||
EndDate |
選用 |
System.DateTime |
EndDate 參數指定將匯入目標信箱的篩選內容結束日期。只會匯入 .pst 檔案中其日期為結束日期或之前日期的項目。輸入特定日期時,請使用本機電腦上設定之 [地區選項] 設定中所定義的簡短日期格式。例如,若電腦設成使用簡短日期格式 mm/dd/yyyy,請輸入 03/01/2006 以指定 2006 年 3 月 1 日。 |
||
ExcludeFolders |
選用 |
Microsoft.Exchange.Data.Mapi.MapiFolderPath[] |
ExcludeFolders 參數指定要在匯入期間排除的資料夾清單。 |
||
GlobalCatalog |
選用 |
Microsoft.Exchange.Data.Fqdn |
GlobalCatalog 參數指定要用來搜尋目標信箱的通用類別目錄。 |
||
Identity |
選用 |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
Identity 參數指定您要匯入資料的目標信箱物件。您可以使用下列其中一個值:
如果已經傳送 Get-Mailbox 命令物件,則不需要此參數。 |
||
IncludeFolders |
選用 |
Microsoft.Exchange.Data.Mapi.MapiFolderPath[] |
IncludeFolders 參數指定要在匯入期間包含的資料夾清單。 |
||
Locale |
選用 |
System.Globalization.CultureInfo |
Locale 參數指定要匯入的郵件地區設定。該命令只會匯入含指定地區設定的郵件。 |
||
MaxThreads |
選用 |
System.Int32 |
MaxThreads 參數會指定要使用的執行緒數目上限。預設值為 4。 |
||
RecipientKeywords |
選用 |
System.String[] |
RecipientKeywords 參數指定要匯入之內容的關鍵字。如果命令找到您在收件者清單中指定的關鍵字,它就會匯入那些郵件。 |
||
ReportFile |
選用 |
Microsoft.Exchange.Data.LocalLongFullPath |
ReportFile 參數指定 XML 報告記錄的路徑及檔案名稱。 |
||
SenderKeywords |
選用 |
System.String[] |
SenderKeywords 參數指定要匯入之內容的關鍵字。如果命令找到您在寄件者中指定的關鍵字,它就會匯入那些郵件。 |
||
StartDate |
選用 |
System.DateTime |
StartDate 參數指定將匯入目標信箱的篩選內容開始日期。只會匯入 .pst 檔案中其日期晚於開始日期的項目。輸入特定日期時,請使用本機電腦上設定之 [地區選項] 設定中所定義的簡短日期格式。例如,若電腦設成使用簡短日期格式 mm/dd/yyyy,請輸入 03/01/2006 以指定 2006 年 3 月 1 日。 |
||
SubjectKeywords |
選用 |
System.String[] |
SubjectKeywords 參數指定 .pst 檔案中之項目主旨的關鍵字篩選器。 |
||
ValidateOnly |
選用 |
System.Management.Automation.SwitchParameter |
ValidateOnly 參數會在不匯入資料的情況下提供用來驗證匯入的選項。ValidateOnly 參數會驗證命令的所有必要條件。
|
||
WhatIf |
選用 |
System.Management.Automation.SwitchParameter |
WhatIf 參數指示命令模擬它將對物件採取的動作。使用 WhatIf 參數,則不需要套用任何變更,就能檢視變更。您不需要為 WhatIf 參數指定任何值。 |
輸入類型
傳回類型
錯誤
錯誤 | 描述 |
---|---|
|
範例
第一個範例顯示如何從檔案 C:\PSTFiles\john.pst 將資料匯入現有、已連線的 john@contoso.com 信箱。
第二個範例顯示如何從所有位於 C:\PSTFiles 的 .pst 檔案將資料匯入現有信箱。.pst 檔案名稱必須為 <alias>.pst,其中 alias 是要匯入資料之信箱的別名。對於每個 .pst 檔案,只有 01/01/2007 以後接收的郵件會匯入信箱。
第三個範例顯示如何從 .pst 檔案將資料匯入 Marketing 組織單位中使用者的信箱。.pst 檔案名稱必須為 <alias>.pst,其中 alias 是要匯入資料之信箱的別名。只會匯入別名對應於 Marketing 組織單位中之使用者的 .pst 檔案。如果 Marketing 組織單位使用者在 C:\PSTFiles 中沒有 .pst 檔案,您會收到錯誤。
Import-Mailbox -Identity john@contoso.com -PSTFolderPath C:\PSTFiles\john.pst
Dir C:\PSTFiles | Import-Mailbox -StartDate 01/01/2007
Get-Mailbox -OrganizationalUnit Marketing | Import-Mailbox -PSTFolderPath C:\PSTFiles
若要確保您目前閱讀的是最新資訊,並尋找其他的 Exchange Server 2007 說明文件,請造訪 Exchange Server 技術資源中心.