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
此参数仅在基于云的服务中可用。
ApproveSkippedItems 开关将当前时间之前发现的所有跳过的项目标记为已批准。 不必为此开关指定值。
如果在此迁移期间检测到的数据丢失严重,则如果不批准跳过的项目,则无法完成迁移。 邮件可能已被跳过,因为它们在源邮箱中已损坏且无法复制到目标邮箱,它们大于为租户配置的最大允许邮件大小,或者在迁移准备完成时检测到它们在目标邮箱中丢失。
有关最大邮件大小值的详细信息,请参阅 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,在不带值的情况下指定“确认”开关会引入一个暂停,从而强制你在继续之前确认命令。
参数属性
| 类型: | 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
标识参数指定要迁移的用户的电子邮件地址。
还可以通过 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 |
| 别名: | WI |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持以下常用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。