共用方式為


New-MailboxRestoreRequest

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 有些參數和設定可能是某一個環境所專屬。

您可以使用 New-MailboxRestoreRequest 指令程式,還原虛刪除或已中斷連線的信箱。 這個指令程式會開始將虛刪除信箱、已停用信箱或復原資料庫中任何信箱的內容,移到已連線的主要或封存信箱。

在Exchange Server和Exchange Online中,用來尋找已中斷連線信箱和還原信箱的屬性不同。 如需Exchange Online的詳細資訊,請參閱還原非作用中的信箱

如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法

Syntax

New-MailboxRestoreRequest
   -SourceDatabase <DatabaseIdParameter>
   -SourceStoreMailbox <StoreMailboxIdParameter>
   -TargetMailbox <MailboxOrMailUserIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-MRSServer <Fqdn>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-SourceRootFolder <String>]
   [-SuspendComment <String>]
   [-Suspend]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-WhatIf]
   [<CommonParameters>]
New-MailboxRestoreRequest
   -SourceEndpoint <MigrationEndpointIdParameter>
   -SourceExchangeGuid <Guid>
   -SourceTenant <SmtpDomain>
   -TargetMailbox <MailboxLocationIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-ContentFilter <String>]
   [-ContentFilterLanguage <CultureInfo>]
   [-CrossTenantRestore]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-LargeItemLimit <Unlimited>]
   [-Name <String>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-SourceRootFolder <String>]
   [-SuspendComment <String>]
   [-Suspend]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-TargetType <TargetTypeComponent>]
   [-WhatIf]
   [<CommonParameters>]
New-MailboxRestoreRequest
   -SourceDatabase <DatabaseIdParameter>
   -SourceStoreMailbox <StoreMailboxIdParameter>>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-ContentFilter <String>]
   [-ContentFilterLanguage <CultureInfo>]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-LargeItemLimit <Unlimited>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-RequestExpiryInterval <Unlimited>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-SourceRootFolder <String>]
   [-Suspend]
   [-SuspendComment <String>]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-TargetType <TargetTypeComponent>]
   [-WhatIf]
   [-WorkloadType <RequestWorkloadType>]
   [<CommonParameters>]
New-MailboxRestoreRequest
   -SourceStoreMailbox <StoreMailboxIdParameter>
   -TargetMailbox <MailboxLocationIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-ContentFilter <String>]
   [-ContentFilterLanguage <CultureInfo>]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-LargeItemLimit <Unlimited>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-RequestExpiryInterval <Unlimited>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-SourceRootFolder <String>]
   [-Suspend]
   [-SuspendComment <String>]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-TargetType <TargetTypeComponent>]
   [-WhatIf]
   [-WorkloadType <RequestWorkloadType>]
   [<CommonParameters>]
New-MailboxRestoreRequest
   -SourceStoreMailbox <StoreMailboxIdParameter>
   -TargetMailbox <MailboxOrMailUserIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-LargeItemLimit <Unlimited>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-SourceRootFolder <String>]
   [-Suspend]
   [-SuspendComment <String>]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-WhatIf]
   [-WorkloadType <RequestWorkloadType>]
   [<CommonParameters>]
New-MailboxRestoreRequest
   -RemoteDatabaseGuid <Guid>
   -RemoteHostName <Fqdn>
   -RemoteRestoreType <RemoteRestoreType>
   -RemoteCredential <PSCredential>
   -SourceMailbox <MailboxLocationIdParameter>
   -TargetMailbox <MailboxLocationIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLegacyDNMismatch]
   [-AssociatedMessagesCopyOption <FAICopyOption>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-ConflictResolutionOption <ConflictResolutionOption>]
   [-ContentFilter <String>]
   [-ContentFilterLanguage <CultureInfo>]
   [-DomainController <Fqdn>]
   [-ExcludeDumpster]
   [-ExcludeFolders <String[]>]
   [-IncludeFolders <String[]>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-LargeItemLimit <Unlimited>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-RequestExpiryInterval <Unlimited>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-SourceIsArchive]
   [-SourceRootFolder <String>]
   [-Suspend]
   [-SuspendComment <String>]
   [-TargetIsArchive]
   [-TargetRootFolder <String>]
   [-TargetType <TargetTypeComponent>]
   [-WhatIf]
   [-WorkloadType <RequestWorkloadType>]
   [<CommonParameters>]

Description

當信箱從一個資料庫移至另一個資料庫時,Exchange 不會在移動完成時立即從源資料庫完全刪除信箱。 而是會將來源信箱資料庫中的信箱切換到「虛刪除」狀態,這樣便可使用新的 MailboxRestoreRequest 指令程式集,在信箱還原作業期間存取信箱資料。 在已刪除信箱保留期間到期或使用 Remove-StoreMailbox 指令程式來清除信箱之前,虛刪除的信箱會保留在來源資料庫中。

若要檢視虛刪除信箱,請對資料庫執行 Get-MailboxStatistics 指令程式,並查看其 DisconnectReason 中的值為 SoftDeleted 的結果。 如需詳細資訊,請參閱本主題稍後的<範例 1>。

在 Disable-Mailbox 或 Remove-Mailbox 命令完成一小段時間之後,系統便會將信箱標記為「停用」。

在 Microsoft Exchange 資訊存放區服務判斷 Active Directory 已使用已停用的信箱資訊更新之前,信箱不會標示為 [已停用]。 您可以對該資料庫執行 Update-StoreMailboxState Cmdlet,來加速處理程序。

Exchange 會根據針對該信箱資料庫設定的已刪除信箱保留設定,保留信箱資料庫中已停用的信箱。 在經過指定的期間後,便會永久刪除信箱。

若要檢視已停用信箱,請對資料庫執行 Get-MailboxStatistics 指令程式,並查看其 DisconnectReason 中的值為 Disabled 的結果。 如需詳細資訊,請參閱本主題稍後的範例 2 和 3。

您必須已獲指派權限,才能執行此指令程式。 雖然本主題已列出這個指令程式的所有參數,不過,如果某些參數並未包含在指派給您的權限中,您可能就無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 Find the permissions required to run any Exchange cmdlet

注意:若要將主要信箱的內容還原至封存信箱,請使用 TargetRootFolder 參數來指定要將內容移轉至其中的封存信箱資料夾。 此內容會在還原之後顯示。 如果您未使用此參數,則不會顯示還原的內容,因為它會對應至封存信箱中使用者看不到的位置。

範例

範例 1

Get-MailboxStatistics -Database MBD01 | Where {$_.DisconnectReason -eq "SoftDeleted" -or $_.DisconnectReason -eq "Disabled"} | Format-List LegacyExchangeDN,DisplayName,MailboxGUID, DisconnectReason

New-MailboxRestoreRequest -SourceDatabase "MBD01" -SourceStoreMailbox 1d20855f-fd54-4681-98e6-e249f7326ddd -TargetMailbox Ayla

在內部部署 Exchange 中,此範例會使用 Get-MailboxStatistics Cmdlet 來傳回 DisplayName、LegacyExchangeDN 和 MailboxGUID, (針對信箱資料庫中所有名稱為 MBD01 且中斷連線原因為 SoftDeleted 或 Disabled 的信箱,) 有效的來源信箱識別值。

使用此資訊,MailboxGUID 值為 1d20855f-fd54-4681-98e6-e249f7326ddd 的來源信箱會還原至具有別名值 Ayla 的目標信箱。

範例 2

New-MailboxRestoreRequest -SourceDatabase "MBD01" -SourceStoreMailbox "Tony Smith" -TargetMailbox Tony@contoso.com -TargetIsArchive

在內部部署 Exchange 中,此範例會將信箱資料庫 MBD01 上具有 Smith Smith DisplayName 的來源信箱內容還原至 的 Tony@contoso.com 封存信箱。

參數

-AcceptLargeDataLoss

AcceptLargeDataLoss 參數會指定要求應該繼續,即使來源信箱中的大量郵件無法複製到目標信箱也一樣。 您不需要使用此參數指定值。

在 Exchange 2013 或更新版本或 Exchange Online 中,如果您將 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

-AllowLegacyDNMismatch

AllowLegacyDNMismatch 參數會指定如果來源實體信箱和目標信箱的 LegacyExchangeDN 不相符,作業應該繼續。 您不需要使用此參數指定值。

依預設,這個指令程式會檢查以確定來源實體信箱上的 LegacyExchangeDN 是否會以 LegacyExchangeDN 的形式出現在目標使用者上,或者 X500 Proxy 位址是否會對應到 LegacyExchangeDN。 這項檢查可防止您不慎將來源信箱還原到不正確的目標信箱。

注意:此參數在雲端式服務中已遭取代。 若要針對具有不相符之 LegacyExchangeDN 的信箱完成信箱還原要求,您必須取得來源信箱的 LegacyExchangeDN 值,並將其新增至目標信箱作為 X500 Proxy 位址。 如需詳細指示,請 參閱還原非使用中信箱

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 參數指定是否在處理要求時複製相關聯的訊息。 相關聯訊息是特殊訊息,包含規則、檢視與表單等相關資訊的隱藏資料。 有效值為:

  • 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

-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-MailboxRestoreRequest 指令程式時,使用 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 參數會指定多久將已完成還原要求的狀態設定為 Completed。 如果此參數設定為 0 值,就會立刻清除狀態,而不是變更為 Completed。

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
  • KeepAll
  • KeepLatestItem
  • KeepLatestItem
  • KeepTargetItem
  • UpdateFromSource
Type:ConflictResolutionOption
Position:Named
Default value:KeepSourceItem
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

-ContentFilter

此參數只能在雲端式服務中使用。

ContentFilter 參數會使用 OPATH 篩選語法,依指定的屬性和值來篩選結果。 只會還原符合 ContentFilter 參數的內容。 搜尋準則使用語法 "Property -ComparisonOperator 'Value'"

  • 以雙引號 「」 括住整個 OPATH 篩選準則。 如果篩選條件包含系統值 (例如 $true$false$null),請改為使用單引號 ' '。 雖然此參數是字串 (不是系統區塊),您也可以使用大括弧 { },但只有在篩選條件不包含變數時。
  • Property 是可篩選的屬性。 如需可篩選的屬性,請 參閱 ContentFilter 參數的可篩選屬性
  • ComparisonOperator 是 OPATH 比較運算子 (例如 -eq equals 和 -like 字串比較) 。 如需比較運算子的詳細資訊,請參閱 about_Comparison_Operators
  • Value 是要搜尋的屬性值。 以單引號括住文字值和變數 ('Value''$Variable')。 如果變數值包含單引號,您必須識別 (逸出) 單引號,以正確展開變數。 例如,使用 '$($User -Replace "'","''")',而不是 '$User'。 請勿以引號括住整數或系統值 (例如,請改用 500$true$false$null) 。

您可以使用邏輯運算子 -and-or 將多個搜尋準則鏈結在一起。 例如,"Criteria1 -and Criteria2""(Criteria1 -and Criteria2) -or Criteria3"

如需 Exchange 中 OPATH 篩選的詳細資訊,請參閱 其他 OPATH 語法資訊

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ContentFilterLanguage

此參數只能在雲端式服務中使用。

ContentFilterLanguage 參數會指定 ContentFilter 參數中為進行參數搜尋所使用的語言。

此參數的有效輸入是來自 Microsoft .NET Framework CultureInfo 類別的支援文化特性程式碼值。 例如,丹麥文為 da-DK 或日文為 ja-JP。 如需詳細資訊,請參閱 CultureInfo 類別

Type:CultureInfo
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-CrossTenantRestore

此參數只能在雲端式服務中使用。

將保留此參數供 Microsoft 內部使用。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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, Exchange Online

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

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

-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

-LargeItemLimit

LargeItemLimit 參數會指定要求失敗之前所允許的大型項目數上限。 「大型項目」是來源信箱中超出目標信箱中所允許之郵件大小上限的郵件。 如果目標信箱沒有特別設定的郵件大小上限值,則會使用全組織值。

如需郵件大小上限值的詳細資訊,請參閱下列主題:

這個參數的有效輸入是整數或是值 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

-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 的使用者信箱建立匯出要求,並將此參數的值指定為 RestoreFailedMoves,則此匯出要求的識別碼為 Kweku\RestoreFailedMoves。

如果您在建立還原要求時未指定其名稱,Exchange 會自動產生預設名稱 MailboxRestore。 Exchange 最多會產生 10 個名稱,從 MailboxRestore 開始,然後再產生 MailboxRestoreX (其中 X = 1-9) 。

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

-RemoteCredential

此參數只能在雲端式服務中使用。

將保留此參數供 Microsoft 內部使用。

Type:PSCredential
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-RemoteDatabaseGuid

此參數只能在雲端式服務中使用。

將保留此參數供 Microsoft 內部使用。

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-RemoteHostName

此參數只能在雲端式服務中使用。

將保留此參數供 Microsoft 內部使用。

Type:Fqdn
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-RemoteRestoreType

此參數只能在雲端式服務中使用。

將保留此參數供 Microsoft 內部使用。

Type:RemoteRestoreType
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-RequestExpiryInterval

此參數僅適用於內部部署 Exchange。

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

-SkipMerging

SkipMerging 參數會指定在還原信箱時,要略過多少資料夾相關的項目。 請使用下列其中一個值:

  • FolderACLs
  • FolderProperties
  • FolderRules
  • InitialConnectionValidation

只有在還原要求因為資料夾規則、資料夾存取控制清單 (ACL) 或初始連線驗證失敗時才可使用此參數。

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

-SourceDatabase

此參數僅適用於內部部署 Exchange。

SourceDatabase 參數會指定資料庫的識別碼,您可以從這個資料庫中還原虛刪除或已中斷連線的信箱。 您可以使用唯一識別資料庫的任何值。 例如:

  • 名稱
  • 辨別名稱 (DN)
  • GUID
Type:DatabaseIdParameter
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

-SourceEndpoint

此參數只能在雲端式服務中使用。

將保留此參數供 Microsoft 內部使用。

Type:MigrationEndpointIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SourceExchangeGuid

此參數只能在雲端式服務中使用。

將保留此參數供 Microsoft 內部使用。

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SourceIsArchive

SourceIsArchive 參數會指定來源信箱是封存信箱。 您不需要使用此參數指定值。

此參數只能與 SourceMailbox 參數搭配使用。

Type:SwitchParameter
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

-SourceMailbox

SourceMailbox 參數會指定您要還原的虛刪除信箱。 識別虛刪除信箱的最佳方式是依據其 GUID 值。 您可以執行下列命令來尋找 GUID 值:Get-Mailbox -SoftDeletedMailbox.

Type:SourceMailbox
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-SourceRootFolder

SourceRootFolder 參數會指定要從其中還原資料之信箱的根資料夾。 如果未指定此參數,命令會還原所有資料夾。

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

-SourceStoreMailbox

此參數只能在內部部署 Exchange 中運作。

SourceStoreMailbox 參數會指定您要從中還原內容之來源信箱的 MailboxGUID。

您可以執行 Get-MailboxStatistics Cmdlet 來尋找 MailboxGUID。

Type:StoreMailboxIdParameter
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, Exchange Online

-SourceTenant

此參數只能在雲端式服務中使用。

將保留此參數供 Microsoft 內部使用。

Type:SmtpDomain
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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

-TargetIsArchive

TargetIsArchive 參數會指定將內容還原到指定的目標信箱封存中。 您不需要使用此參數指定值。

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

-TargetMailbox

TargetMailbox 參數會指定您要還原內容的目標信箱或郵件使用者的 GUID。 目標信箱或郵件使用者必須存在,您才能順利執行這個指令。

您可以執行Get-Mailbox或Get-MailUser Cmdlet 來尋找信箱或郵件使用者的 GUID 值。

在 Exchange 2016 或更新版本和 Exchange Online 中,此參數的類型為 MailboxLocationIdParameter。

在 Exchange 2013 或更早版本中,此參數的類型為 MailboxOrMailUserIdParameter。

Type:MailboxLocationIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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

-TargetType

TargetType 參數會指定做為還原作業目標的信箱類型。 有效值為:

  • 封存
  • MailboxLocation
  • 主要 (這是預設值)
Type:TargetTypeComponent
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

-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

若要查看此指令程式可接受的傳回類型 (也就是所謂的輸出類型),請參閱指令程式輸入和輸出類型。 如果 [輸出類型] 欄位是空的,表示指令程式不會傳回資料。