Set-MigrationUser

  • 参考
模块:
ExchangePowerShell
适用于:
Exchange Server 2016, Exchange Server 2019, Exchange Online

此 cmdlet 仅在基于云的服务中有效。

使用 Set-MigrationUser cmdlet 修改现有迁移批处理中用户的迁移设置。

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

语法

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

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

ApprovSkippedItems 开关将当前时间之前发现的所有跳过项标记为已批准。 不必为此开关指定值。

如果在此迁移过程中检测到的数据丢失严重，则如果不批准跳过的项目，迁移将无法完成。 项目可能已被跳过，因为它们在源邮箱中已损坏，无法复制到目标邮箱，它们大于为租户配置的最大允许邮件大小，或者当迁移准备好完成时，它们被检测到目标邮箱中缺失。

有关最大消息大小值的详细信息，请参阅以下主题Exchange Online限制。

不必为此开关指定值。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-BadItemLimit

BadItemLimit 参数指定迁移请求失败之前允许的最大错误项数。 无效项目是源邮箱中无法复制到目标邮箱的损坏项目。 无效项目限制还包括缺少的项目。 缺少的项目是源邮箱中在迁移请求准备好完成时无法在目标邮箱中找到的项目。

此参数的有效输入是一个整数或值 unlimited。 默认值为 0，这意味着如果检测到任何错误项，迁移请求将失败。 如果可以保留一些错误项，则可以将此参数设置为合理的值， (我们建议使用 10 个或更低的) 以便迁移请求可以继续。 如果检测到太多错误项目，请考虑使用 New-MailboxRepairRequest cmdlet 尝试修复源邮箱中损坏的项目，然后再次尝试迁移请求。

注意：此参数已弃用。 将来，如果不使用此参数，将改为使用已跳过的项目审批语义。

Type:Unlimited
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

-CompleteAfter

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

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。
Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Confirm

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet (例如，Remove-* cmdlet) 具有内置的暂停，该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
  • 大多数其他 cmdlet (例如，New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。
Type:SwitchParameter
Aliases:cf
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

-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 2016, Exchange Server 2019

-Identity

Identity 参数指定要迁移的用户的电子邮件地址。

还可以从 Get-MigrationUser cmdlet 的输出中通过 MigrationUser 属性中的 GUID 值来标识用户。 如果意外在多个批中提交了同一个用户，则此标识方法非常有用。

Type:MigrationUserIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-LargeItemLimit

LargeItemLimit 参数指定迁移请求失败之前允许的最大大型项数。 大项目是超过目标邮箱中允许的最大邮件大小的源邮箱邮件。 如果目标邮箱没有专门配置最大邮件大小值，则使用组织范围的值。

有关最大邮件大小值的详细信息，请参阅下列主题：

此参数的有效输入是一个整数或值 unlimited。 默认值为 0，这意味着如果检测到任何大型项，迁移请求将失败。 如果可以保留几个大型项，则可以将此参数设置为合理的值， (我们建议使用 10 个或更低的) 以便迁移请求继续。

注意：此参数已弃用。 将来，如果不使用此参数，将改为使用已跳过的项目审批语义。

Type:Unlimited
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

-Partition

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

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

Type:MailboxIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-StartAfter

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

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。
Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SyncNow

SyncNow 开关指定是否为迁移的用户触发增量同步。 不必为此开关指定值。

增量同步会将任何最近的更改从源邮箱复制到目标邮箱。 可以在完成迁移批处理之前执行增量同步，以减少完成所需的时间。

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

-WhatIf

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

Type:SwitchParameter
Aliases:wi
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