Get-MailboxRestoreRequestStatistics

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

使用 Get-MailboxRestoreRequestStatistics cmdlet 可查看有关还原请求的详细信息。

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

语法

IdentityOnPremises

Get-MailboxRestoreRequestStatistics
    [-Identity] <MailboxRestoreRequestIdParameter>
    [-Diagnostic]
    [-DiagnosticArgument <String>]
    [-DomainController <Fqdn>]
    [-IncludeReport]
    [-ReportOnly]
    [<CommonParameters>]

IdentityCloud

Get-MailboxRestoreRequestStatistics
    [-Identity] <MailboxRestoreRequestIdParameter>
    [-IncludeReport]
    [-IncludeSkippedItems]
    [-DiagnosticInfo <String>]
    [-ReportOnly]
    [<CommonParameters>]

MigrationMRSInstance

Get-MailboxRestoreRequestStatistics
    -MRSInstance <Fqdn>
    [-DomainController <Fqdn>]
    [-RequestGuid <Guid>]
    [<CommonParameters>]

MigrationRequestQueue

Get-MailboxRestoreRequestStatistics
    -RequestQueue <DatabaseIdParameter>
    [-Diagnostic]
    [-DiagnosticArgument <String>]
    [-DomainController <Fqdn>]
    [-IncludeReport]
    [-ReportOnly]
    [-RequestGuid <Guid>]
    [<CommonParameters>]

说明

您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果某些参数未包含在分配给你的权限中,则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet

示例

示例 1

Get-MailboxRestoreRequestStatistics -Identity "Tony\MailboxRestore1"

本示例返回标识为 Tony\MailboxRestore1 的还原请求的默认统计信息。 默认情况下返回的信息类型包括名称、邮箱、状态和完成百分比。

示例 2

Get-MailboxRestoreRequestStatistics -Identity Tony\MailboxRestore | Export-CSV \\SERVER01\RestoreRequest_Reports\Tony_Restorestats.csv

本示例将返回 Tony Smith 邮箱的统计信息并将报告导出到 CSV 文件。

示例 3

Get-MailboxRestoreRequestStatistics -Identity Tony\MailboxRestore -IncludeReport | Format-List

本示例通过使用 IncludeReport 参数并将结果通过管道传递到 Format-List 命令,返回有关 Tony Smith 的邮箱还原请求的其他信息。

示例 4

Get-MailboxRestoreRequestStatistics -MRSInstance CAS01.contoso.com

在 Exchange Server 2010 和 2013 中,此示例返回服务器 CAS01 上运行的 MRS 实例正在处理的还原请求的默认统计信息。 此命令仅返回 MRS 实例当前正在处理的还原请求的信息。 如果客户端访问服务器处理完所有还原请求,则不会返回任何信息。 此命令仅用于调试目的,仅应在支持人员请求时执行。

示例 5

Get-MailboxRestoreRequest -Status Failed | Get-MailboxRestoreRequestStatistics -IncludeReport | Format-List > C:\Reports\AllRestoreReports.txt

此示例使用 IncludeReport 参数返回所有状态为“失败”的还原请求的其他信息,然后将信息保存到文本文件 C:\Reports\AllRestoreReports.txt。

参数

-Diagnostic

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此参数只在本地 Exchange 中可用。

Diagnostic 开关指定是否在结果中返回非常详细的信息。 不必为此开关指定值。

通常情况下,仅在应 Microsoft 客户服务和支持部门请求排查问题时,才使用此开关。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

IdentityOnPremises
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
MigrationRequestQueue
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DiagnosticArgument

适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此参数只在本地 Exchange 中可用。

DiagnosticArgument 参数修改使用 Diagnostic 开关返回的结果。 通常情况下,仅在应 Microsoft 客户服务和支持部门请求排查问题时,才使用 Diagnostic 开关和 DiagnosticArgument 参数。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

IdentityOnPremises
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
MigrationRequestQueue
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DiagnosticInfo

适用:Exchange Online

此参数仅在基于云的服务中可用。

通常,仅在Microsoft Customer Service 和 Support 的请求下使用 DiagnosticInfo 参数来解决问题。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

IdentityCloud
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

参数集

IdentityOnPremises
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
MigrationMRSInstance
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
MigrationRequestQueue
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) 。

不能将此参数与 MRSInstance 或 RequestQueue 参数一起使用。

参数属性

类型:MailboxRestoreRequestIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

IdentityOnPremises
Position:1
必需:True
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False
IdentityCloud
Position:1
必需:True
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-IncludeReport

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

IncludeReport 开关指定是否返回其他详细信息,可通过这些详细信息进行疑难解答。 不必为此开关指定值。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

IdentityOnPremises
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
IdentityCloud
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
MigrationRequestQueue
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-IncludeSkippedItems

适用:Exchange Online

此参数仅在基于云的服务中可用。

{{ Fill IncludeSkippedItems Description }}

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

IdentityCloud
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MRSInstance

适用:Exchange Server 2010

此参数仅在 Exchange Server 2010 中可用。

MRSInstance 参数指定Microsoft Exchange 邮箱复制服务 (MRS) 所在的客户端访问服务器的完全限定域名 (FQDN) 。 使用此参数时,将返回此 MRS 实例的所有记录。

不能将此参数与 Identity 或 RequestQueue 参数一起使用。

参数属性

类型:Fqdn
默认值:None
支持通配符:False
不显示:False

参数集

MigrationMRSInstance
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ReportOnly

适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

ReportOnly 开关以报表条目数组的形式返回结果, (编码字符串) 。 不必为此开关指定值。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

IdentityOnPremises
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
IdentityCloud
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
MigrationRequestQueue
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-RequestGuid

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此参数只在本地 Exchange 中可用。

RequestGuid 参数指定还原请求的唯一标识符。 若要查找此 GUID,请使用 Get-MailboxRestoreRequest cmdlet。

参数属性

类型:Guid
默认值:None
支持通配符:False
不显示:False

参数集

MigrationMRSInstance
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
MigrationRequestQueue
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-RequestQueue

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此参数只在本地 Exchange 中可用。

此参数仅用于调试目的。

RequestQueue 参数根据运行请求的邮箱数据库标识请求。 可以使用任何能够唯一标识此数据库的值。 例如:

  • 名称
  • 可分辨名称 (DN)
  • GUID

数据库名称

参数属性

类型:DatabaseIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

MigrationRequestQueue
Position:Named
必需:True
来自管道的值: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 不返回任何数据。