Set-MigrationUser
此 cmdlet 仅在基于云的服务中有效。
使用 Set-MigrationUser cmdlet 修改现有迁移批处理中用户的迁移设置。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Default (默认值)
Set-MigrationUser
[-Identity] <MigrationUserIdParameter>
[-ApproveSkippedItems]
[-BadItemLimit <Unlimited>]
[-CompleteAfter <DateTime>]
[-Confirm]
[-DomainController <Fqdn>]
[-LargeItemLimit <Unlimited>]
[-Partition <MailboxIdParameter>]
[-StartAfter <DateTime>]
[-SyncNow]
[-WhatIf]
[<CommonParameters>]
说明
某些设置既可以应用于批处理，也可以应用于批处理中的单个用户。 应用于用户的设置将覆盖批处理上的任何相应设置。
您必须先获得权限，然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数，但如果某些参数未包含在分配给你的权限中，则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Set-MigrationUser -Identity laura@contoso.com -LargeItemLimit 15 -BadItemLimit 15
本示例更改现有迁移批处理中用户 laura@contoso.com 的大型项限制和错误项限制。
示例 2
Set-MigrationUser -Identity laura@contoso.com -ApproveSkippedItems
本示例批准用户在现有迁移批处理中遇到的 laura@contoso.com 所有跳过项。
参数
-ApproveSkippedItems
适用：Exchange Online
此参数仅在基于云的服务中可用。
ApprovSkippedItems 开关将当前时间之前发现的所有跳过项标记为已批准。 不必为此开关指定值。
如果在此迁移期间检测到的数据丢失严重，则如果不批准跳过的项目，迁移就无法完成。 项目可能已被跳过，因为它们在源邮箱中已损坏，无法复制到目标邮箱，它们大于为租户配置的最大允许邮件大小，或者当迁移准备好完成时，它们被检测到目标邮箱中缺失。
有关最大消息大小值的详细信息，请参阅Exchange Online限制。
不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-BadItemLimit
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此参数只在本地 Exchange 中可用。
保留此参数以供 Microsoft 内部使用。
注意：此参数已从基于云的服务中弃用。 在迁移完成之前，管理员必须查看 数据一致性分数 和任何跳过的项目。
参数属性
| 类型: | Unlimited |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-CompleteAfter
适用：Exchange Online
此参数仅在基于云的服务中可用。
CompleteAfter 参数指定用户完成之前的延迟。 用户的数据迁移开始，但在使用此参数指定的日期/时间之前不会完成。
请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果计算机配置为使用短日期格式 MM/dd/yyyy，请输入 09/01/2018 以指定 2018 年 9 月 1 日。 可以只输入日期，也可以输入当天的日期和时间。 如果输入当天的日期和时间，请将该值括在引号 (") 中，例如，"09/01/2018 5:00 PM"。
在 Exchange Online PowerShell 中，如果指定日期/时间值而不指定时区，则该值位于协调世界时 (UTC) 中。
若要指定此参数的日期/时间值，请使用下列方法之一：
- 指定 UTC 中的日期/时间值：例如，“2021-05-06 14：30：00z”。
- 将日期/时间值指定为将本地时区中的日期/时间转换为 UTC 的公式：例如
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime()。 有关详细信息，请参阅 Get-Date。
参数属性
| 类型: | DateTime |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Confirm
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 的影响取决于 cmdlet 是否需要确认才能继续操作。
- 破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：
-Confirm:$false。 - 其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。 对于这些 cmdlet，指定不带值的 Confirm 开关会引入暂停，强制你在继续操作之前确认命令。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | Cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DomainController
适用：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 |
-Identity
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Identity 参数指定要迁移的用户的电子邮件地址。
还可以从 Get-MigrationUser cmdlet 的输出中通过 MigrationUser 属性中的 GUID 值来标识用户。 如果意外在多个批中提交了同一个用户，则此标识方法非常有用。
参数属性
| 类型: | MigrationUserIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-LargeItemLimit
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此参数只在本地 Exchange 中可用。
保留此参数以供 Microsoft 内部使用。
注意：此参数已从基于云的服务中弃用。 在迁移完成之前，管理员必须查看 数据一致性分数 和任何跳过的项目。
参数属性
| 类型: | Unlimited |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Partition
适用：Exchange Online
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
参数属性
| 类型: | MailboxIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-StartAfter
适用：Exchange Online
此参数仅在基于云的服务中可用。
StartAfter 参数指定用户的数据迁移开始前的延迟。 迁移已准备就绪，但用户的实际数据迁移直到使用此参数指定的日期/时间才会开始。
请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果计算机配置为使用短日期格式 MM/dd/yyyy，请输入 09/01/2018 以指定 2018 年 9 月 1 日。 可以只输入日期，也可以输入当天的日期和时间。 如果输入当天的日期和时间，请将该值括在引号 (") 中，例如，"09/01/2018 5:00 PM"。
在 Exchange Online PowerShell 中，如果指定日期/时间值而不指定时区，则该值位于协调世界时 (UTC) 中。
若要指定此参数的日期/时间值，请使用下列方法之一：
- 指定 UTC 中的日期/时间值：例如，“2021-05-06 14：30：00z”。
- 将日期/时间值指定为将本地时区中的日期/时间转换为 UTC 的公式：例如
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime()。 有关详细信息，请参阅 Get-Date。
参数属性
| 类型: | DateTime |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SyncNow
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
SyncNow 开关指定是否为迁移的用户触发增量同步。 不必为此开关指定值。
增量同步会将任何最近的更改从源邮箱复制到目标邮箱。 可以在完成迁移批处理之前执行增量同步，以减少完成所需的时间。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
WhatIf 开关显示命令的功能，而无需进行任何更改。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。