Get-MailboxImportRequest

參考

模組:: ExchangePowerShell

適用於:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

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

此 Cmdlet 只能在信箱匯入匯出角色中使用，而且根據預設，角色不會指派給任何角色群組。若您要使用此 cmdlet，必須將「信箱匯入匯出」角色新增至角色群組 (例如，Organization Management 角色群組)。如需詳細資訊，請參閱將角色新增至角色群組。

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

Syntax

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

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

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

Description

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

您必須已獲指派權限，才能執行此指令程式。雖然本主題已列出這個指令程式的所有參數，不過，如果某些參數並未包含在指派給您的權限中，您可能就無法存取這些參數。若要尋找在組織中執行任何 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

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

資料庫名稱

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Database

此參數僅適用于 2010 Exchange Server。

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

名稱
辨別名稱 (DN)
GUID

資料庫名稱

Type:	DatabaseIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-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 2010, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Identity 參數會指定匯入要求的識別碼。根據預設，匯入要求會命名 <alias>\MailboxImportX (其中 X = 0-9) 。如果您指定匯入要求的名稱，請使用下列語法： Alias\Name 。 Microsoft Exchange 會自動在要求前面加上信箱的別名。

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

BatchName
信箱
名稱
狀態
暫停
HighPriority

Type:	MailboxImportRequestIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Mailbox

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

Mailbox 參數會依內容匯入目的地信箱來篩選結果。

在 Exchange 2016 CU7 或更新版本中，此參數的類型為 MailboxLocationIdParameter，因此您可以用來識別信箱的最簡單值是別名值。

在 Exchange 2016 CU6 或更早版本中，此參數是 MailboxOrMailUserIdParameter 類型，因此您可以使用可唯一識別信箱的任何值。例如：

名稱
別名
辨別名稱 (DN)
辨別名稱 (DN)
Domain\Username
電子郵件地址
GUID
LegacyExchangeDN
SamAccountName
使用者識別碼或使用者主要名稱 (UPN)

資料庫名稱

Type:	MailboxOrMailUserIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013

-Name

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

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

資料庫名稱

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Status

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

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

資料庫名稱

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

Type:	RequestStatus
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

輸入

Input types

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

輸出

Output types

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

Get-MailboxImportRequest

Syntax

Description

範例

範例 1

範例 2

範例 3

範例 4

參數

-BatchName

-Database

-DomainController

-HighPriority

-Identity

-Mailbox

-Name

-RequestQueue

-ResultSize

-Status

-Suspend

輸入

輸出

意見反應

意見反應

其他資源