Get-MailboxExportRequest

此 cmdlet 仅适用于本地 Exchange。

使用 Get-MailboxExportRequest cmdlet 可以查看使用 New-MailboxExportRequest cmdlet 启动的正在执行的导出请求的详细状态。

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

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

语法

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

说明

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

您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

示例

示例 1

Get-MailboxExportRequest -Identity "tony\DB01toPST"

本示例返回标识为 tony\DB01toPST 的正在执行的导出请求的状态。

示例 2

Get-MailboxExportRequest -Status InProgress -Database DB01

在 Exchange Server 2010 中,此示例返回驻留在数据库 DB01 上的邮箱或存档的正在进行的导出请求的状态。

示例 3

Get-MailboxExportRequest -BatchName "Attachment_CompanyReport" -Status Completed

本示例返回已完成的 Attachment_CompanyReport 批次中的导出请求的状态。

示例 4

Get-MailboxExportRequest -Name "DB01toPST" -Suspend $true

本示例返回名称为 DB01toPST 的所有导出请求,并且导出已被挂起。

参数

-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

-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

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

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>\MailboxExportX 为 (其中 X = 0-9) 。 如果在使用 New-MailboxExportRequest cmdlet 创建请求时为导出请求指定了名称,请使用以下语法: Alias\Name。 Exchange 自动在请求前面加上邮箱的别名。

此参数不能与以下参数一起使用:

  • BatchName
  • 邮箱
  • 名称
  • 状态
  • 暂停
  • HighPriority
Type:MailboxExportRequestIdParameter
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

-Mailbox

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 参数指定返回具有指定名称的导出请求。

使用此参数根据在创建导出请求时提供的名称进行搜索。

如果在创建请求时未指定名称,则默认名称为 MailboxExportX(其中 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

-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 参数指定了要返回的结果的最大数量。 若要返回所有与查询相匹配的请求,则请将此参数的值设为无限制。 默认值为 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

-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

-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

输入

Input types

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

输出

Output types

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