New-MailboxImportRequest
內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。
使用 New-MailboxImportRequest 指令程式,開始進行將 .pst 檔案匯入至信箱或封存的程序。
注意:Exchange Online不再支援此 Cmdlet。 若要在 Exchange Online 中匯入 .pst 檔案,請參閱使用網路上傳匯入 PST 檔案。
此 Cmdlet 只能在信箱匯入匯出角色中使用,而且根據預設,角色不會指派給任何角色群組。 若您要使用此 cmdlet,必須將「信箱匯入匯出」角色新增至角色群組 (例如,Organization Management 角色群組)。 如需詳細資訊,請 參閱將角色新增至角色群組。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
Syntax
New-MailboxImportRequest
[-Mailbox] <MailboxOrMailUserIdParameter>
-FilePath <LongPath>
[-AcceptLargeDataLoss]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-ContentCodePage <Int32>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-InternalFlags <InternalMrsFlag[]>]
[-IsArchive]
[-LargeItemLimit <Unlimited>]
[-MRSServer <Fqdn>]
[-Name <String>]
[-Priority <RequestPriority>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceRootFolder <String>]
[-Suspend]
[-SuspendComment <String>]
[-TargetRootFolder <String>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>]
New-MailboxImportRequest
[-Mailbox] <MailboxLocationIdParameter>
-FilePath <LongPath>
[-AcceptLargeDataLoss]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-ContentCodePage <Int32>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-InternalFlags <InternalMrsFlag[]>]
[-IsArchive]
[-LargeItemLimit <Unlimited>]
[-MigrationMailbox <MailboxIdParameter>]
[-Name <String>]
[-Priority <RequestPriority>]
[-RequestExpiryInterval <Unlimited>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceEndpoint <MigrationEndpointIdParameter>]
[-SourceRootFolder <String>]
[-Suspend]
[-SuspendComment <String>]
[-TargetRootFolder <String>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>]
New-MailboxImportRequest
[-Mailbox] <MailboxLocationIdParameter>
-AzureBlobStorageAccountUri <Uri>
-AzureSharedAccessSignatureToken <String>
[-AcceptLargeDataLoss]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-AzureStatusPublishEndpointInfo <String>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-ContentCodePage <Int32>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-IsArchive]
[-LargeItemLimit <Unlimited>]
[-MRSContentFilterSasUri <Uri>]
[-MigrationBatch <MigrationBatchIdParameter>]
[-MigrationMailbox <MailboxIdParameter>]
[-MigrationUser <MigrationUserIdParameter>]
[-Name <String>]
[-RequestExpiryInterval <Unlimited>]
[-SkipInitialConnectionValidation]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceEndpoint <MigrationEndpointIdParameter>]
[-SourceRootFolder <String>]
[-SuspendComment <String>]
[-Suspend]
[-TargetRootFolder <String>]
[-WhatIf]
[<CommonParameters>]
Description
您可以為每個信箱建立一個以上的信箱匯入要求,而每個信箱匯入要求都必須具有唯一名稱。 Microsoft Exchange 會自動為信箱匯入要求產生最多 10 個唯一名稱。 不過,若要為信箱建立超過 10 個匯入要求,您必須在建立匯入要求時指定唯一的名稱,或是使用 Remove-MailboxExportRequest Cmdlet 移除現有的匯入要求,再使用預設要求啟動新的匯入要求 <Alias>\MailboxImportX
(其中 X = 0-9) 。
依預設,匯入會檢查重複的項目,如果目標信箱或目標封存中已有相同項目,則不會將資料從 .pst 檔案複製到信箱或封存。
在內部部署 Exchange 中,您必須將下列許可權授與要匯出或匯入 PST 檔案的網路共用 Exchange 信任子系統群組:
- 若要從共用中匯入 PST 檔案:讀取權限
- 若要將匯出的 PST 檔案儲存至共用:讀取/寫入權限。
如果您不授與此權限,您將會收到錯誤訊息,說明 Exchange 無法建立與網路共用的 PST 檔案連線。
範例
範例 1
New-MailboxImportRequest -Mailbox Ayla -FilePath \\SERVER01\PSTFiles\Recovered.pst -TargetRootFolder "RecoveredFiles" -IncludeFolders "#Inbox#"
此範例將 SERVER01 上已復原的 .pst 檔案,匯入到使用者 Ayla 的主要信箱中。 只匯入 .pst 檔案的 [收件匣] 中的資料。 資料會匯入至 Ayla 的目標信箱的 RecoveredFiles 資料夾中。
範例 2
New-MailboxImportRequest Kweku -FilePath \\server\share\User1.pst -IsArchive -TargetRootFolder /
本範例將 .pst 檔案匯入至 Kweku 的封存資料夾。 由於未指定 TargetRootFolder,因此內容會合併到現有資料夾之下,如果目標資料夾結構中沒有資料夾,則會建立新資料夾。
範例 3
Dir \\SERVER01\PSTshareRO\Recovered\*.pst | %{ New-MailboxImportRequest -Name RecoveredPST -BatchName Recovered -Mailbox $_.BaseName -FilePath $_.FullName -TargetRootFolder SubFolderInPrimary}
本範例匯入共用資料夾上的所有 .pst 檔案。 每個 .pst 檔案的名稱都是根據對應的使用者別名而命名的。 命令會為所有 .pst 檔案建立匯入要求,並將資料匯入至相符的信箱。
參數
-AcceptLargeDataLoss
AcceptLargeDataLoss 參數會指定要求應該繼續,即使來源信箱中的大量郵件無法複製到目標信箱也一樣。 您不需要使用此參數指定值。
在 Exchange 2013 或更新版本中,如果您將 LargeItemLimit 參數設定為 51 或更高的值,則需要使用此參數。 否則,命令會失敗。
在 Exchange 2010 中,如果您將 BadItemLimit 參數設為 51 或更高的值,則必須使用此參數。 否則,命令會失敗。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-AssociatedMessagesCopyOption
AssociatedMessagesCopyOption 參數指定是否在處理要求時複製相關聯的訊息。 相關聯訊息是特殊訊息,包含規則、檢視與表單等相關資訊的隱藏資料。 根據預設,會複製相關聯的訊息。 這個參數不能與 IncludedRecipients 參數或任何 Conditional 參數搭配使用。
- DoNotCopy:不會複製相關聯的訊息。
- MapByMessageClass:此選項會藉由查閱來源訊息的 MessageClass 屬性來尋找對應的相關聯訊息。 如果來源和目的檔案夾中都有此類別的相關聯訊息,它會覆寫目標中的相關聯訊息。 如果目標中沒有相關聯的訊息,它會在目標中建立複本。
- 複製:此選項會將相關聯的訊息從來源複製到目標。 如果來源和目標位置都存在相同的訊息類型,這些相關聯的訊息就會重複。 此為預設選項。
Copy:此選項會從來源將相關訊息複製到目標。如果來源和目標位置都有相同的訊息類型,這些相關聯訊息就會重複。此為預設選項。
Type: | FAICopyOption |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-AzureBlobStorageAccountUri
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-AzureSharedAccessSignatureToken
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-AzureStatusPublishEndpointInfo
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-BadItemLimit
BadItemLimit 參數會指定要求失敗之前所允許的錯誤項目數上限。 「錯誤項目」是來源信箱中無法複製到目標信箱的損毀項目。 錯誤項目限制中也包括「遺漏的項目」。 「遺漏的項目」是來源信箱中當要求準備完成時,在目標信箱中找不到的項目。
這個參數的有效輸入是整數或是值 unlimited。 預設值為 0,這表示如果偵測到任何錯誤項目,要求將會失敗。 如果不介意留下幾個錯誤項目,您可以將此參數設為一個合理值 (建議 10 或更低),讓要求可以繼續進行。 如果偵測到太多錯誤項目,請考慮使用 New-MailboxRepairRequest Cmdlet,嘗試修正來源信箱中的損毀項目,然後重試要求。
在 Exchange 2010 中,如果將此值設為 51 或更高的值,則也需要使用 AcceptLargeDataLoss 參數。 否則,命令會失敗。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-BatchName
BatchName 參數會指定匯入一批信箱時的描述性名稱。 您可以在使用 Get-MailboxImportRequest 指令程式時,使用 BatchName 參數中的名稱做為搜尋字串。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-CompletedRequestAgeLimit
完成要求後,CompletedRequestAgeLimit 參數會在自動移除前指定要求保留的時間。 CompletedRequestAgeLimit 參數的預設值是 30 天。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Confirm
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 例如,具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停,可強制您在繼續之前確認命令。 對於這些 Cmdlet,您可以使用以下確切語法來略過確認提示:
-Confirm:$false
。 - 其他大部分的 Cmdlet (例如,New-* 和 Set-* Cmdlet) 沒有內建暫停。 在使用這些 Cmdlet 時,指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ConflictResolutionOption
ConflictResolutionOption 參數會指定如果目標中有多個相符的訊息,該怎麼做。 有效值為:
- ForceCopy (Exchange 2016 或更新版本)
- KeepAll
- KeepLatestItem
- KeepSourceItem (這是預設值)
- KeepTargetItem (Exchange 2016 或更新版本)
- UpdateFromSource (Exchange 2016 或更新版本)
Type: | ConflictResolutionOption |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ContentCodePage
ContentCodePage 參數可指定要用於 ANSI pst 檔案的特定字碼頁。 ANSI pst 檔案用於 Outlook 97 至 Outlook 2002。 您可以在代碼 頁識別碼 主題中找到有效的值。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
此參數僅適用於內部部署 Exchange。
DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如,dc01.contoso.com。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ExcludeDumpster
ExcludeDumpster 參數會指定是否要排除 [可復原的專案] 資料夾。 您不需要使用此參數指定值。
如果您未使用此參數,則會使用下列子資料夾複製 [可復原的專案] 資料夾:
- 刪除
- 版本
- 清除
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ExcludeFolders
ExcludeFolders 參數會指定要在匯入期間排除的資料夾清單。
如果 exADNoMk 同盟服務 (AD FS) 部署為允許單一登入外部信箱,且 AD FS 已設定為針對登入 Token 要求使用 ExchangeGUID 以外的屬性,則您必須設定 ImmutableId 參數。 exExchangeNoVersion 與 AD FS 都必須為同一位使用者要求同一個 Token,以確保跨單位 exExchangeNoVersion 部署案例的正常運作。
<FolderName>/*
:使用此語法表示 SourceRootFolder 參數中指定之資料夾下的個人資料夾,例如 「MyProjects」 或 「MyProjects/FY2010」。
#<FolderName>#/*
:使用此語法表示已知的資料夾,而不論資料夾的名稱是其他語言。 例如,#Inbox# 代表 [收件匣] 資料夾,即使收件匣是以土耳其文當地語系化,也就是 Gelen Kutusu。 已知的資料夾包含下列類型:
- 收件匣
- SentItems
- DeletedItems
- 行事曆
- 聯絡人
- 草稿
- 日誌
- 工作
- 注意事項
- 垃圾郵件
- CommunicatorHistory
- 語音信箱
- 傳真
- Conflicts
- SyncIssues
- LocalFailures
- ServerFailures
如果使用者建立與已知資料夾同名的個人資料夾及其周圍的 # 符號,您可以使用反斜線 (\) 作為逸出字元來指定該資料夾。 例如,如果使用者建立名為 #Notes# 的資料夾,而您想要指定該資料夾,而不是已知的 Notes 資料夾,請使用下列語法: \#Notes\#
。
如果使用者建立的個人資料夾與已知資料夾的名稱相同,並以 # 符號環繞,您可以使用反斜線 (\) 作為逸出字元來指定該資料夾。例如,若使用者建立了名稱為 #Notes# 的資料夾,而您要指定該資料夾,但不是已知的 Notes 資料夾,請使用下列語法:\#Notes\#.
如果未在匯入 [可復原的項目] 資料夾時指定 TargetRootFolder 參數,則可復原項目的內容會置於目標信箱或封存的 [可復原的項目] 資料夾中。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-FilePath
此參數僅適用於內部部署 Exchange。
FilePath 參數會指定要匯入資料的 .pst 檔案的網路共用路徑,例如,\\SERVER01\PST Files\ToImport.pst。
您必須將下列權限授與「Exchange 受信任子系統」群組,以存取您要匯出或匯入 PST 檔案的網路共用:
- 若要從共用中匯入 PST 檔案:讀取權限
- 若要將匯出的 PST 檔案儲存至共用:讀取/寫入權限。
如果您不授與此權限,您將會收到錯誤訊息,說明 Exchange 無法建立與網路共用的 PST 檔案連線。
Type: | LongPath |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IncludeFolders
IncludeFolders 參數會指定要在匯入期間包含的資料夾清單。
如果 exADNoMk 同盟服務 (AD FS) 部署為允許單一登入外部信箱,且 AD FS 已設定為針對登入 Token 要求使用 ExchangeGUID 以外的屬性,則您必須設定 ImmutableId 參數。 exExchangeNoVersion 與 AD FS 都必須為同一位使用者要求同一個 Token,以確保跨單位 exExchangeNoVersion 部署案例的正常運作。
<FolderName>/*
:使用此語法表示 SourceRootFolder 參數中指定之資料夾下的個人資料夾,例如 「MyProjects」 或 「MyProjects/FY2010」。
#<FolderName>#/*
:使用此語法表示已知的資料夾,而不論資料夾的名稱是其他語言。 例如,#Inbox# 代表 [收件匣] 資料夾,即使收件匣是以土耳其文當地語系化,也就是 Gelen Kutusu。 已知的資料夾包含下列類型:
- 收件匣
- SentItems
- DeletedItems
- 行事曆
- 聯絡人
- 草稿
- 日誌
- 工作
- 注意事項
- 垃圾郵件
- CommunicationHistory
- 語音信箱
- 傳真
- Conflicts
- SyncIssues
- LocalFailures
- ServerFailures
如果使用者建立與已知資料夾同名的個人資料夾及其周圍的 # 符號,您可以使用反斜線 (\) 作為逸出字元來指定該資料夾。 例如,如果使用者建立名為 #Notes# 的資料夾,而您想要指定該資料夾,而不是已知的 Notes 資料夾,請使用下列語法: \#Notes\#
。
如果使用者建立的個人資料夾與已知資料夾的名稱相同,並以 # 符號環繞,您可以使用反斜線 (\) 作為逸出字元來指定該資料夾。例如,若使用者建立了名稱為 #Notes# 的資料夾,而您要指定該資料夾,但不是已知的 Notes 資料夾,請使用下列語法:\#Notes\#.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-InternalFlags
此參數僅適用於內部部署 Exchange。
InternalFlags 參數會指定要求中的選用步驟。 此參數主要用於偵錯目的。
Type: | InternalMrsFlag[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IsArchive
IsArchive 參數會指定您正在將 .pst 檔案匯入至使用者的封存中。 您不需要使用此參數指定值。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-LargeItemLimit
LargeItemLimit 參數會指定要求失敗之前所允許的大型項目數上限。 「大型項目」是來源信箱中超出目標信箱中所允許之郵件大小上限的郵件。 如果目標信箱沒有特別設定的郵件大小上限值,則會使用全組織值。
如需郵件大小上限值的詳細資訊,請參閱下列主題:
- Exchange 2016:Exchange Server中的訊息大小限制
- Exchange Online:Exchange Online 的限制
這個參數的有效輸入是整數或是值 unlimited。 預設值為 0,這表示如果偵測到任何大型項目,要求將會失敗。 如果不介意留下幾個大型項目,您可以將此參數設為一個合理值 (建議 10 或更低),讓要求可以繼續進行。
如果將此值設為 51 或更高,則也需要使用 AcceptLargeDataLoss 參數。 否則,命令會失敗。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Mailbox
Mailbox 參數會指定要匯入內容的目的地信箱。
在 Exchange 2016 CU7 或更新版本中,此參數的類型為 MailboxLocationIdParameter,因此您可以用來識別信箱的最簡單值是別名值。
在 Exchange 2016 CU6 或更早版本中,此參數是 MailboxOrMailUserIdParameter 類型,因此您可以使用可唯一識別信箱的任何值。 例如:
- 名稱
- 別名
- 辨別名稱 (DN)
- 辨別名稱 (DN)
- Domain\Username
- 電子郵件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 使用者識別碼或使用者主要名稱 (UPN)
Type: | MailboxOrMailUserIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013 |
-MigrationBatch
此參數只能在雲端式服務中使用。
此參數保留供內部Microsoft使用
Type: | MigrationBatchIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-MigrationMailbox
將保留此參數供 Microsoft 內部使用。
Type: | MailboxIdParameter, AzureImportRequest |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-MigrationUser
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
Type: | MigrationUserIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-MRSContentFilterSasUri
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-MRSServer
此參數僅適用于 2010 Exchange Server。
MRSServer 參數會指定用戶端存取伺服器的 FQDN,Microsoft Exchange 信箱複寫服務 (MRS) 的執行個體在此用戶端存取伺服器上執行。 此參數僅用於偵錯目的。 只有在支援人員的指示下才可以使用此參數。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-Name
Name 參數會指定特定要求的名稱,以用於追蹤和顯示。 因為每個信箱可以有多個匯入要求,所以 Exchange 會在名稱前面加上信箱的別名。 例如,若您為別名為 Kweku 的使用者信箱建立匯入要求,並將此參數值指定為 PC1toArchive,則此匯入要求的識別為 Kweku\PC1toArchive。
如果您未使用此參數指定名稱,Exchange 會為每個信箱產生最多 10 個要求名稱,也就是 MailboxImportX (其中 X = 0-9) 。 要求的身分識別會顯示並可搜尋為 <alias>\MailboxImportX
。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Priority
此參數僅適用於內部部署 Exchange。
Priority 參數會指定在要求佇列中應處理的要求順序。 根據伺服器健康情況、狀態、優先順序和上次更新時間,依序處理要求。
Type: | RequestPriority |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-RequestExpiryInterval
RequestExpiryInterval 參數會指定完成或失敗之要求的保留天數。 當您使用這個參數時,系統會在指定的間隔到期後自動移除完成或失敗的要求。 如果您不使用這個參數:
- 系統會根據 CompletedRequestAgeLimit 參數值,自動移除完成的要求。
- 如果要求失敗,您必須使用對應的 Remove-*Request Cmdlet 手動移除它。
若要指定值,請輸入時間範圍值:dd.hh:mm:ss,其中 dd = 天數、hh = 時數、mm = 分鐘數,而 ss = 秒數。
當您使用值 Unlimited 時,系統不會自動移除完成的要求。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SkipInitialConnectionValidation
此參數只能在雲端式服務中使用。
將保留此參數供 Microsoft 內部使用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-SkipMerging
SkipMerging 參數會指定匯入中應略過的步驟。 此參數主要用於偵錯目的。
Type: | SkippableMergeComponent[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SourceEndpoint
將保留此參數供 Microsoft 內部使用。
Type: | MigrationEndpointIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SourceRootFolder
SourceRootFolder 參數會指定要從中匯入資料之 .pst 檔案的根資料夾。 若指定此參數,則不會匯入 SourceRootFolder 參數值以外的資料夾階層,而 SourceRootFolder 參數會對應到 TargetRootFolder 參數。 如果未指定此參數,此命令會匯入所有資料夾。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Suspend
Suspend 參數會指定是否擱置要求。 您不需要使用此參數指定值。
如果您使用此參數,要求會加入佇列,但要求不會變成 InProgress 狀態,直到您使用相關的 resume 指令程式來繼續要求為止。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SuspendComment
SuspendComment 參數會指定要求擱置原因的描述。 如果指定 Suspend 參數,就只能使用此參數。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TargetRootFolder
TargetRootFolder 參數會指定要用來放置所匯入之內容的最上層信箱資料夾。 若您不指定此參數,則命令會將資料夾匯入到目標信箱或封存中,資料夾結構的最上方。 如果資料夾已經存在,內容會合併到現有資料夾之下,如果目標資料夾結構中沒有資料夾,則會建立新資料夾。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-WhatIf
WhatIf 參數會模擬命令的動作。 使用此參數時,您不需要實際套用變更即可檢視可能會發生的變更。 您不需要使用此參數指定值。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-WorkloadType
此參數僅適用於內部部署 Exchange。
將保留此參數供 Microsoft 內部使用。
Type: | RequestWorkloadType |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
輸入
Input types
若要查看此指令程式可接受的輸入類型,請參閱指令程式輸入和輸出類型。 如果指令程式的 [輸入類型] 欄位是空的,表示指令程式不接受輸入資料。
輸出
Output types
若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。