Get-PublicFolderMailboxMigrationRequest

  • 參考
模組:
ExchangePowerShell
適用於:
Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

使用 Get-PublicFolderMailboxMigrationRequest Cmdlet 檢視公用資料夾移轉批次中個別工作的狀態，這個移轉批次是使用 New-MigrationBatch Cmdlet 所建立。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

Get-PublicFolderMailboxMigrationRequest
   [-BatchName <String>]
   [-DomainController <Fqdn>]
   [-HighPriority <Boolean>]
   [-Name <String>]
   [-RequestQueue <DatabaseIdParameter>]
   [-ResultSize <Unlimited>]
   [-Status <RequestStatus>]
   [-Suspend <Boolean>]
   [<CommonParameters>]
Get-PublicFolderMailboxMigrationRequest
   [[-Identity] <PublicFolderMailboxMigrationRequestIdParameter>]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Description

Get-PublicFolderMailboxMigrationRequest Cmdlet 預設會顯示下列屬性。

  • 名稱：系統指派給特定信箱移轉作業的名稱。
  • TargetMailbox：要移轉的信箱。
  • 狀態：作業的目前狀態。

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

範例

範例 1

Get-PublicFolderMailboxMigrationRequest

本範例會傳回所有移轉要求的相關資訊。

範例 2

Get-PublicFolderMailboxMigrationRequest -HighPriority $true

在內部部署 Exchange 中，此範例會傳回優先順序值為 High、Higher、Highest 或 Emergency 的所有移轉要求。

範例 3

Get-PublicFolderMailboxMigrationRequest | ?{$_.TargetMailbox -eq $null}

此範例會傳回沒有目標信箱的公用資料夾信箱移轉要求。

範例 4

Get-PublicFolderMailboxMigrationRequest | group TargetMailbox |?{$_.Count -gt 1}

此範例會傳回針對相同目標信箱) 建立的重複公用資料夾移轉要求 (要求。 如果命令未傳回任何結果，則沒有任何重複的移轉要求。

參數

-BatchName

BatchName 參數會根據建立批次工作時所指派的易記 BatchName 值來篩選結果。 此值的格式為： MigrationService:<Batch name provided at batch creation> 。

資料庫名稱

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, 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

-HighPriority

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

HighPriority 參數會根據建立要求時指派的 Priority 值來篩選結果。 這個參數的有效輸入是 $true 或 $false。 以下是這些值篩選結果的方式：

  • $true傳回以 [優先順序] 值 [高]、[更高]、[最高] 或 [緊急] 建立的要求。
  • $false傳回使用 Priority 值 Normal、Low、Lower 或 Lowest 建立的要求。

資料庫名稱

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

-Identity

Identity 參數會指定您要檢視的公用資料夾信箱移轉要求。 值會使用語法： \PublicFolderMailboxMigration<GUID> (例如， \PublicFolderMailboxMigrationac6d9eb4-ee49-405f-b90d-04e9a258bd7e) 。

這個參數不能與下列參數搭配使用：

  • BatchName
  • HighPriority
  • 名稱
  • RequestQueue
  • 暫停
  • 狀態
Type:PublicFolderMailboxMigrationRequestIdParameter
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

-Name

Name 參數會指定公用資料夾信箱移轉要求的名稱。 如果在建立時未指定名稱，則預設值會 PublicFolderMailboxMigration<GUID> (例如， PublicFolderMailboxMigration2ffdef13-01b9-4586-af2b-d5a5482010a8) 。

資料庫名稱

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, Exchange Online

-RequestQueue

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

RequestQueue 參數會根據執行要求的信箱資料庫來識別要求。 您可以使用唯一識別資料庫的任何值。 例如：

  • 名稱
  • 辨別名稱 (DN)
  • GUID

資料庫名稱

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

-ResultSize

ResultSize 參數會指定傳回的結果筆數上限。 若要傳回符合查詢的所有要求，請使用 unlimited 作為此參數的值。 預設值為 1000。

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

-Status

Status 參數會根據狀態篩選結果。 您可以使用下列值：

  • AutoSuspended
  • 已完成
  • CompletedWithWarning
  • CompletionInProgress
  • 失敗
  • InProgress
  • 已排入佇列
  • 重試
  • 暫止
  • 已同步處理

資料庫名稱

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

-Suspend

Suspend 參數會指定是否要傳回已暫停的要求。 這個參數的有效輸入是 $true 或 $false。

資料庫名稱

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