共用方式為


Get-MailboxImportRequest

內部部署 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

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