Get-PublicFolderMailboxMigrationRequest

內部部署 Exchange 和雲端式服務有提供此 Cmdlet。 某些參數和設定可能僅限於一個環境或另一個環境。

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

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

語法

Filtering

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

Identity

Get-PublicFolderMailboxMigrationRequest
    [[-Identity] <PublicFolderMailboxMigrationRequestIdParameter>]
    [-DomainController <Fqdn>]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

Description

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

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

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

範例

範例 1

Get-PublicFolderMailboxMigrationRequest

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

範例 2

Get-PublicFolderMailboxMigrationRequest -HighPriority $true

在內部部署 Exchange 中,此範例會傳回優先順序值為「高」、「較高」、「最高」或「緊急」的所有移轉要求。

範例 3

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

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

範例 4

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

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

參數

-BatchName

適用項目:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

資料庫名稱

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Filtering
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DomainController

適用項目:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

DomainController 參數會指定此 Cmdlet 用來向 Active Directory 讀取或寫入資料的網域控制站。 您可以透過網域控制站的完整網域名稱 (FQDN) 來識別網域控制站。 例如,dc01.contoso.com。

參數屬性

類型:Fqdn
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-HighPriority

適用項目:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

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

  • $true 傳回以 [高]、[較高]、[最高] 或 [緊急] 優先順序值建立的要求。
  • $false 傳回以 [正常]、[低]、[較低] 或 [最低] 優先順序值建立的要求。

資料庫名稱

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Filtering
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Identity

適用項目:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

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

  • BatchName
  • HighPriority
  • 名稱
  • RequestQueue
  • 暫停
  • 狀態

警告: Identity 參數的值 $null 或不存在的值會傳回 所有 物件,就像您在執行 Get- 命令而不使用Identity 參數一樣。 請確認 Identity 參數的任何值清單均正確無誤,且不包含不存在的$null值。

參數屬性

類型:PublicFolderMailboxMigrationRequestIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Identity
Position:1
必要:False
來自管線的值:True
來自管線按屬性名稱的值:True
來自剩餘引數的值:False

-Name

適用項目:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

資料庫名稱

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Filtering
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RequestQueue

適用項目:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

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

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

資料庫名稱

參數屬性

類型:DatabaseIdParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Filtering
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ResultSize

適用項目:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

參數屬性

類型:Unlimited
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Status

適用項目:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

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

資料庫名稱

參數屬性

類型:RequestStatus
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Filtering
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Suspend

適用項目:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

資料庫名稱

參數屬性

類型:Boolean
預設值:None
支援萬用字元:False
不要顯示:False

參數集

Filtering
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援常見參數: -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。