Get-MigrationUserStatistics
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 Get-MigrationUserStatistics cmdlet 可查看有关特定用户迁移请求的详细信息。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Get-MigrationUserStatistics
[-Identity] <MigrationUserIdParameter>
[-Diagnostic]
[-DiagnosticArgument <String>]
[-DiagnosticInfo <String>]
[-DomainController <Fqdn>]
[-IncludeReport]
[-LimitSkippedItemsTo <Int32>]
[-IncludeSkippedItems]
[-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 中可用。
Diagnostic 开关指定是否在结果中返回非常详细的信息。 不必为此开关指定值。
通常情况下，仅在应 Microsoft 客户服务和支持部门请求排查问题时，才使用此开关。
| Type: | SwitchParameter |
| 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 |
-DiagnosticArgument
此参数只在本地 Exchange 中可用。
DiagnosticArgument 参数修改使用 Diagnostic 开关返回的结果。 通常情况下，仅在应 Microsoft 客户服务和支持部门请求排查问题时，才使用 Diagnostic 开关和 DiagnosticArgument 参数。
| Type: | String |
| 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 |
-DiagnosticInfo
此参数仅在基于云的服务中可用。
通常，仅应 Microsoft Customer Service 和 Support 的请求使用 DiagnosticInfo 参数来解决问题。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-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 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Identity 参数指定要检索其迁移信息的用户。 使用电子邮件地址作为此参数的值。
| Type: | MigrationUserIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IncludeReport
IncludeReport 开关指定是否返回其他详细信息，可通过这些详细信息进行疑难解答。 不必为此开关指定值。
| Type: | SwitchParameter |
| 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, Exchange Online |
-IncludeSkippedItems
IncludeSkippedItems 开关指定是否包括用户的跳过项。 不必为此开关指定值。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-LimitSkippedItemsTo
LimitSkippedItemsTo 参数指定已跳过项目的最大数目以在命令输出的 SkippedItems 属性中显示相关信息。 例如，如果此参数设置为 5，则该 cmdlet 可为指定用户返回最多五个已跳过项目的信息，即使已跳过项目数不止五个。
| Type: | Int32 |
| 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, Exchange Online |
-Partition
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
| Type: | MailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-SkipSubscription
SkipSubscription 开关指定是否跳过为用户加载订阅。 不必为此开关指定值。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。