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。