Get-MailboxImportRequest

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。

使用 Get-MailboxImportRequest cmdlet 可以查看使用 New-MailboxImportRequest cmdlet 启动的持续导入请求的详细状态。

此 cmdlet 仅在邮箱导入导出角色中可用,默认情况下,该角色不分配给任何角色组。 要使用此 cmdlet,需将邮箱导入导出角色添加到角色组(例如,添加到“组织管理”角色组)。 有关详细信息,请参阅向角色组添加角色

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法

语法

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>]

说明

Get-MailboxImportRequest cmdlet 的搜索条件是布尔 And 语句。 如果使用多个参数,可以缩小搜索范围并减少搜索结果。

您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 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

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返回使用优先级值 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)
  • 域\用户名
  • 电子邮件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 用户 ID 或用户主体名称 (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 参数指定了要返回的结果的最大数量。 若要返回所有与查询相匹配的请求,则请将此参数的值设为无限制。 默认值为 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

若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。