Get-MailboxRestoreRequest
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 某些参数和设置可能只属于一个环境或另一个环境。
使用 Get-MailboxRestoreRequest cmdlet 可以查看使用 New-MailboxRestoreRequest cmdlet 启动的正在执行的还原请求的详细状态。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Identity
Get-MailboxRestoreRequest
[[-Identity] <MailboxRestoreRequestIdParameter>]
[-DomainController <Fqdn>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Filtering
Get-MailboxRestoreRequest
[-BatchName <String>]
[-HighPriority <Boolean>]
[-Name <String>]
[-RequestQueue <DatabaseIdParameter>]
[-SourceDatabase <DatabaseIdParameter>]
[-Status <RequestStatus>]
[-Suspend <Boolean>]
[-TargetDatabase <DatabaseIdParameter>]
[-TargetMailbox <MailboxOrMailUserIdParameter>]
[-DomainController <Fqdn>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
说明
您必须先获得权限，然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数，但如果某些参数未包含在分配给你的权限中，则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Get-MailboxRestoreRequest -Identity "Ayla\MailboxRestore"
此示例使用标识 ayla\MailboxRestore 返回正在进行的和排队还原请求的状态，其中 Ayla 是用户的名字。
示例 2
Get-MailboxRestoreRequest -TargetDatabase MBD01
在 Exchange Server 2010 中，此示例返回正在还原到目标数据库 MBD01 的正在进行的还原请求和排队还原请求的状态。
示例 3
Get-MailboxRestoreRequest -RequestQueue MBD01
本示例返回还原到邮箱数据库 MBD01 的正在进行和排队的还原请求的状态。
示例 4
Get-MailboxRestoreRequest -Name "RestoreToMBD01" -Suspend $true
此示例返回名称为 RestoreToMBD01 的所有还原请求，其中还原请求已挂起。
参数
-BatchName
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
BatchName 参数指定赋予批次还原请求的名称。
数据库名称
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Filtering
| 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 Online
HighPriority 参数根据创建请求时分配的 Priority 值筛选结果。 此参数的有效输入为 $true 或 $false。 下面是这些值筛选结果的方式：
- $true返回使用优先级值“高”、“高”、“最高”或“紧急”创建的请求。
- $false返回使用优先级值 Normal、Low、Lower 或 Lowest 创建的请求。
数据库名称
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Filtering
| 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 参数指定还原请求的标识。 Identity 参数由要还原的邮箱的别名和创建还原请求时指定的名称组成。 还原请求的标识使用以下语法： Alias\Name。
如果在创建还原请求时未指定名称，则 Exchange 会自动生成默认名称 MailboxRestore。 Exchange 最多生成 10 个名称，从 MailboxRestore 开始，然后从 MailboxRestoreX (其中 X = 1-9) 。
此参数不能与 Name 参数一起使用。
参数属性
| 类型: | MailboxRestoreRequestIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | 1 |
| 必需: | False |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Name
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Name 参数指定返回采用指定名称的任何还原请求。
使用此参数搜索在创建还原请求时提供的名称。
如果在创建还原请求时未指定名称，则 Exchange 会自动生成默认名称 MailboxRestore。 Exchange 最多生成 10 个名称，从 MailboxRestore 开始，然后从 MailboxRestoreX (其中 X = 1-9) 。
数据库名称
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Filtering
| 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 |
参数集
Filtering
| 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 参数指定了要返回的结果的最大数量。 若要返回所有与查询相匹配的请求，则请将此参数的值设为无限制。 默认值为 1000。
参数属性
| 类型: | Unlimited |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SourceDatabase
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此参数只在本地 Exchange 中可用。
SourceDatabase 参数指定 cmdlet 只能返回从指定源数据库还原的邮箱的还原请求。 可以使用任何能够唯一标识此数据库的值。 例如：
- 名称
- 可分辨名称 (DN)
- GUID
数据库名称
参数属性
| 类型: | DatabaseIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Filtering
| 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 参数基于状态筛选结果。 可以使用下列值：
- AutoSuspended
- 已完成
- CompletedWithWarning
- CompletionInProgress
- 已失败
- InProgress
- 已排队
- 重试
- 已暂停
- 已同步
数据库名称
参数属性
| 类型: | RequestStatus |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Filtering
| 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 |
参数集
Filtering
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-TargetDatabase
适用：Exchange Server 2010
此参数仅在 Exchange Server 2010 中可用。
TargetDatabase 参数指定 cmdlet 应仅返回驻留在目标数据库中的邮箱的还原请求。 可以使用任何能够唯一标识此数据库的值。 例如：
- 名称
- 可分辨名称 (DN)
- GUID
数据库名称
参数属性
| 类型: | DatabaseIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Filtering
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-TargetMailbox
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
TargetMailbox 参数指定目标邮箱的标识。 可以使用下列值：
- GUID
- 可分辨名称 (DN)
- 域\帐户
- 用户主体名称 (UPN)
- 旧版 Exchange DN
- SMTP 地址
- 别名
数据库名称
参数属性
| 类型: | MailboxOrMailUserIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Filtering
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。