Get-MigrationBatch

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

使用 Get-MigrationBatch Cmdlet,擷取目前移轉批次的狀態資訊。

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

Syntax

Get-MigrationBatch
   [-Endpoint <MigrationEndpointIdParameter>]
   [-Diagnostic]
   [-DiagnosticArgument <String>]
   [-DiagnosticInfo <String>]
   [-DomainController <Fqdn>]
   [-IncludeReport]
   [-Partition <MailboxIdParameter>]
   [-Status <Microsoft.Exchange.Data.Storage.Management.MigrationBatchStatus>]
   [<CommonParameters>]
Get-MigrationBatch
   [[-Identity] <MigrationBatchIdParameter>]
   [-Diagnostic]
   [-DiagnosticArgument <String>]
   [-DiagnosticInfo <String>]
   [-DomainController <Fqdn>]
   [-IncludeReport]
   [-Partition <MailboxIdParameter>]
   [-Status <Microsoft.Exchange.Data.Storage.Management.MigrationBatchStatus>]
   [<CommonParameters>]

Description

Get-MigrationBatch 指令程式可顯示目前遷移批次的相關狀態資訊。 此資訊包含以下內容︰

  • 遷移批次的狀態
  • 正在遷移的信箱總數
  • 成功完成移轉的數目
  • 遷移錯誤
  • 開始和完成移轉的日期和時間。

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

注意:在雲端式服務中,如果您未在 New-MigrationBatch 命令中使用 TimeZone 參數,則移轉批次的預設時區為 UTC。 CompleteAfter 和 CompleteAfterUTC 屬性將包含與 StartAfter 和 StartAfterUTC 屬性) 相同的值 (。 當您在 Exchange 系統管理中心 (EAC) 中建立移轉批次時,所使用的時區會以您的區域設定為基礎。

範例

範例 1

Get-MigrationBatch -Identity LocalMove2

本範例顯示移轉批次 LocalMove2 的狀態資訊。

範例 2

Get-MigrationBatch -Endpoint exsrv1.contoso.com

本範例顯示與移轉端點 exsrv1.contoso.com 關聯的所有移轉批次相關資訊。

參數

-Diagnostic

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

Diagnostic 參數指定是否要在結果中傳回極詳細的資訊。 您不需要使用此參數指定值。

一般而言,您只能在 Microsoft 客戶服務和支援中心要求排解疑難問題時使用此參數。

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

-DiagnosticArgument

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

DiagnosticArgument 參數可使用 Diagnostic 參數修改所傳回的結果。 一般而言,您只能在 Microsoft 客戶服務和支援中心要求排解疑難問題時使用 Diagnostic 參數和 DiagnosticArgument 參數。

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

-DiagnosticInfo

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

一般而言,您只會在客戶服務和支援Microsoft要求時使用 DiagnosticInfo 參數來針對問題進行疑難排解。 有效值為:

  • attachmentid=String
  • batch=String
  • 確認
  • duration=String
  • 端點
  • endtime=DateTime
  • maxsize=Int32
  • organization=String
  • partition=String
  • reportid=String
  • 報告
  • showtimeline
  • showtimeslots=String
  • starttime=DateTime
  • status=String
  • 存儲
  • type=String
  • user=String
  • 詳細
Type:String
Position:Named
Default value:None
Required:False
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 2013, Exchange Server 2016, Exchange Server 2019

-Endpoint

Endpoint 參數會傳回與指定移轉端點相關的移轉批次清單。

如果使用此參數,則不可包括 Identity 參數。

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

-Identity

Identity 參數識別目前遷移批次的名稱。 此參數的值是由 New-MigrationBatch Cmdlet 的 Name 參數所指定。

如果使用此參數,則不可包括 Endpoint 參數。

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

-IncludeReport

IncludeReport 參數會傳回指定之移轉批次的其他相關資訊。 您不需要使用此參數指定值。

此資訊會顯示在Report欄位。

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

-Partition

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

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

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

-Status

Status 參數會傳回有指定狀態的移轉批次清單。 請使用下列其中一個值:

  • 已完成
  • CompletedWithErrors
  • 完成
  • 損壞
  • 已建立
  • 失敗
  • IncrementalSyncing
  • 刪除
  • 啟動中
  • 已停止
  • 正在同步處理
  • 停止
  • 已同步處理
  • SyncedwithErrors
Type:Microsoft.Exchange.Data.Storage.Management.MigrationBatchStatus
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

輸入

Input types

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

輸出

Output types

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