Get-PublicFolderMigrationRequest

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

內部部署 Exchange 才有提供此 Cmdlet。

使用 Get-PublicFolderMigrationRequest Cmdlet 來檢視New-PublicFolderMigrationRequest Cmdlet) 所建立之序列公用資料夾移轉要求 (要求的相關資訊。

注意：Exchange 2013 累積更新 8 (CU8) 終止公用資料夾的序列移轉支援，而 Cmdlet 已無法再于 Exchange Online 中使用。 請改用對應 的 *-MigrationBatch 和 *-PublicFolderMailboxMigration* Cmdlet。

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

Syntax

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

Description

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

範例

範例 1

Get-PublicFolderMigrationRequest

此範例會傳回進行中移轉要求的狀態。

範例 2

Get-PublicFolderMigrationRequest -Identity "PFMigrate10_11_12" | Format-List Suspended,AutoSuspended

此範例會傳回名稱PFMigrate10_11_12且要求已暫停的所有移轉要求。

參數

-BatchName

BatchName 參數會指定提供給批次移轉要求的名稱。

資料庫名稱

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

-DomainController

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

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 參數會指定您想要檢視之公用資料夾移轉要求的身分識別。 您可以使用下列值：

  • GUID
  • 名稱

您無法將此參數與其他篩選參數搭配使用 (BatchName、HighPriority、Name、RequestQueue、Status 或 Suspend) 。

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

-Name

Name 參數會依公用資料夾移轉要求的名稱來篩選結果。

資料庫名稱

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

-RequestQueue

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

-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

-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

輸入

Input types

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

輸出

Output types

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