共用方式為

Get-MailboxImportRequest

模組:
Exchange PowerShell

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

使用 Get-MailboxImportRequest 指令程式檢視使用 New-MailboxImportRequest 指令程式初始化之進行中的匯入要求詳細狀態。

此指令只在 Mailbox 匯入匯出角色中提供，且預設情況下，該角色不會被指派到任何角色群組。 若您要使用此 cmdlet，必須將「信箱匯入匯出」角色新增至角色群組 (例如，Organization Management 角色群組)。 欲了解更多資訊，請參閱 「新增角色到角色群組」。

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

語法

Identity 

Get-MailboxImportRequest
    [[-Identity] <MailboxImportRequestIdParameter>]
    [-DomainController <Fqdn>]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

Filtering 

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

Description

Get-MailboxImportRequest 指令程式的搜尋準則為布林 And 陳述式。 如果您使用多個參數，可以縮小搜尋範圍並減少搜尋結果。

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

範例

範例 1

Get-MailboxImportRequest -Identity "tony\Recovered"

此範例會傳回識別碼為 tony\Recovered 之進行中匯入要求的狀態相關預設資訊。 預設會傳回的資訊類型包括名稱、信箱和狀態。

範例 2

Get-MailboxImportRequest -Status InProgress -Database DB01

在 Exchange Server 2010 中，此範例回傳位於資料庫 DB01 的信箱或歸檔的匯入請求狀態。

範例 3

Get-MailboxImportRequest -BatchName "ImportingDB1PSTs" -Status Completed

此範例會傳回已完成之 ImportingDB1PSTs 批次檔中匯入要求的狀態。

範例 4

Get-MailboxImportRequest -Name "Recovered" -Suspend $true

此範例回傳所有名稱為 Recovered 且匯入暫停的匯入請求。

參數

-BatchName

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

BatchName 參數會指定為批次匯入要求提供的名稱。

資料庫名稱

參數屬性

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

參數集

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

-Database

適用：Exchange Server 2010

只有在 Exchange Server 2010 中才能使用此參數。

資料庫參數指定使用者信箱或封存所存放的資料庫。 您可以使用唯一識別資料庫的任何值。 例如：

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

資料庫名稱

參數屬性

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

參數集

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

-DomainController

適用：Exchange Server 2010、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 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

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

HighPriority 參數會根據請求建立時指派的優先權值來過濾結果。 這個參數的有效輸入是 $true 或 $false。 以下是這些數值如何篩選結果的方法：

  • $true 優先權值為高、高、最高或緊急的退貨請求。
  • $false 回傳優先權值為正常、低、較低或最低的請求。

資料庫名稱

參數屬性

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

參數集

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

-Identity

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

Identity 參數會指定匯入要求的識別碼。 預設情況下，匯入請求會以 <alias>\MailboxImportX X = 0-9) 命名為 (。 如果你指定匯入請求的名稱，請使用以下語法： Alias\Name。 Microsoft Exchange 會自動在請求前加上該郵箱的別名。

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

  • BatchName
  • 信箱
  • 名稱
  • 狀態
  • 懸
  • 高優先權

注意：Identity 參數的值$null或不存在的值，會回傳 所有 物件，就像你執行 Get- 指令時沒有 Identity 參數一樣。 請確認 Identity 參數的值清單是否準確，且不包含不存在的 $null 值。

參數屬性

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

參數集

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

-Mailbox

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

此參數只能在內部部署 Exchange 中運作。

信箱參數會依據內容匯入的目的地信箱過濾結果。

在 Exchange 2016 CU7 或更新版本中，參數類型為 MailboxLocationIdParameter。 別名值是辨識信箱最簡單的方法。

資料庫名稱

提示：在 Exchange 2016 CU6 或更早版本中，參數型別為 MailboxOrMailUserIdParameter。 你可以使用任何唯一能識別信箱 (的值，包括 Alias) 。

參數屬性

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

參數集

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

-Name

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

Name 參數會指定傳回具有指定名稱的匯入要求。

使用這個參數搜尋建立匯入要求時提供的名稱。 如果您沒有在要求建立時指定名稱，則預設名稱為 MailboxImportX (其中 X = 0-9)。

資料庫名稱

參數屬性

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

參數集

MailboxFiltering
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False
MailboxLocationFiltering
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

參數集

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

-ResultSize

適用：Exchange Server 2010、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 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

  • 自動懸浮
  • 已完成
  • 已完成警告
  • 完成中
  • 失敗
  • 進行中
  • 已排入佇列
  • 重試
  • 暫止
  • 已同步處理

資料庫名稱

CompletionInProgress 和 AutoSuspended 不適用於匯入請求，也不會回傳任何資訊。

參數屬性

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

參數集

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

-Suspend

適用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

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

資料庫名稱

參數屬性

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

參數集

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

CommonParameters

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

輸入

Input types

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

輸出

Output types

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