Get-MigrationUserStatistics

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

使用 Get-MigrationUserStatistics cmdlet 可查看有关特定用户迁移请求的详细信息。

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

语法

Get-MigrationUserStatistics
   [-Identity] <MigrationUserIdParameter>
   [-Diagnostic]
   [-DiagnosticArgument <String>]
   [-DiagnosticInfo <String>]
   [-DomainController <Fqdn>]
   [-IncludeCopilotReport]
   [-IncludeReport]
   [-IncludeSkippedItems]
   [-LimitSkippedItemsTo <Int32>]
   [-Partition <MailboxIdParameter>]
   [-SkipSubscription]
   [<CommonParameters>]

说明

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

示例

示例 1

Get-MigrationUserStatistics -Identity davidp@corp.contoso.com -IncludeReport | Format-List Status,Error,Report

此示例使用 IncludeReport 参数显示有关用户迁移状态的详细信息。

示例 2

Get-MigrationUserStatistics -Identity davidp@corp.contoso.com | Format-List SkippedItemCount,SkippedItems

此示例显示迁移失败的邮箱项目数(即已跳过项目),以及有关各已跳过项目的信息。

示例 3

Get-MigrationUserStatistics -Identity davidp@corp.contoso.com -IncludeSkippedItems | Select-Object -ExpandProperty SkippedItems | Format-List DateReceived, Subject

此示例在 SkippedItems 属性中显示结果信息。

示例 4

Get-MigrationUser -BatchId StagedBatch1 | Get-MigrationUserStatistics

此示例显示有关名为 StagedBatch1 的迁移批处理中用户的详细信息。

示例 5

Get-MigrationUser | Get-MigrationUserStatistics

此示例显示有关所有当前迁移批处理中的用户的详细信息。

示例 6

Get-MigrationUserStatistics -Identity davidp@corp.contoso.com -Diagnostic | Format-List Status,Error,DiagnosticInfo

在本地 Exchange 中,此示例使用 Diagnostic 参数显示有关用户迁移的详细故障排除信息。

参数

-Diagnostic

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

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

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

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

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DiagnosticArgument

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

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

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DiagnosticInfo

适用:Exchange Online

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

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DomainController

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

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

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。

类型:Fqdn
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Identity

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

Identity 参数指定要检索其迁移信息的用户。 使用电子邮件地址作为此参数的值。

类型:MigrationUserIdParameter
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-IncludeCopilotReport

适用:Exchange Online

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

{{ Fill IncludeCopilotReport Description }}

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-IncludeReport

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

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

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-IncludeSkippedItems

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

IncludeSkippedItems 开关指定是否包括用户的跳过项。 不必为此开关指定值。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-LimitSkippedItemsTo

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

LimitSkippedItemsTo 参数指定已跳过项目的最大数目以在命令输出的 SkippedItems 属性中显示相关信息。 例如,如果此参数设置为 5,则该 cmdlet 可为指定用户返回最多五个已跳过项目的信息,即使已跳过项目数不止五个。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Partition

适用:Exchange Online

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

保留此参数以供 Microsoft 内部使用。

类型:MailboxIdParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SkipSubscription

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

SkipSubscription 开关指定是否跳过为用户加载订阅。 不必为此开关指定值。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

Input types

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

输出

Output types

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