New-MoveRequest
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 New-MoveRequest cmdlet 可以开始异步邮箱或个人存档移动过程。 你还可以使用 WhatIf 参数检查邮箱为移动所做的准备情况。
注意:2020 年 4 月 15 日之后,不应使用此 cmdlet 在Exchange Online组织中手动移动邮箱。 只能使用此 cmdlet 迁移至 Exchange Online 或从 Exchange Online 进行迁移。 如果邮箱出现问题,并希望通过在Exchange Online组织中移动邮箱来修复它,请改为打开Microsoft 支持部门请求。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
New-MoveRequest
[-Identity] <MailboxOrMailUserIdParameter>
-RemoteHostName <Fqdn>
[-Outbound]
[-RemoteCredential <PSCredential>]
[-RemoteGlobalCatalog <Fqdn>]
[-AcceptLargeDataLoss]
[-AllowLargeItems]
[-ArchiveDomain <String>]
[-ArchiveOnly]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompleteAfter <DateTime>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-DomainController <Fqdn>]
[-ForceOffline]
[-IgnoreRuleLimitErrors]
[-IncrementalSyncInterval <TimeSpan>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-MoveOptions <MultiValuedProperty>]
[-MRSServer <Fqdn>]
[-PreventCompletion]
[-PrimaryOnly]
[-Priority <RequestPriority>]
[-Protect]
[-ProxyToMailbox <MailboxIdParameter>]
[-RemoteArchiveTargetDatabase <String>]
[-RemoteOrganizationName <String>]
[-RemoteTargetDatabase <String>]
[-RequestExpiryInterval <Unlimited>]
[-SkipMoving <SkippableMoveComponent[]>]
[-StartAfter <DateTime>]
[-Suspend]
[-SuspendComment <String>]
[-SuspendWhenReadyToComplete]
[-TargetDeliveryDomain <Fqdn>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>]
New-MoveRequest
[-Identity] <MailboxOrMailUserIdParameter>
-RemoteHostName <Fqdn>
[-Remote]
[-RemoteCredential <PSCredential>]
[-RemoteGlobalCatalog <Fqdn>]
[-AcceptLargeDataLoss]
[-AllowLargeItems]
[-ArchiveDomain <String>]
[-ArchiveOnly]
[-ArchiveTargetDatabase <DatabaseIdParameter>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompleteAfter <DateTime>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-DomainController <Fqdn>]
[-ForceOffline]
[-IgnoreRuleLimitErrors]
[-IncrementalSyncInterval <TimeSpan>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-MoveOptions <MultiValuedProperty>]
[-MRSServer <Fqdn>]
[-PreventCompletion]
[-PrimaryOnly]
[-Priority <RequestPriority>]
[-Protect]
[-ProxyToMailbox <MailboxIdParameter>]
[-RemoteOrganizationName <String>]
[-RequestExpiryInterval <Unlimited>]
[-SkipMoving <SkippableMoveComponent[]>]
[-StartAfter <DateTime>]
[-Suspend]
[-SuspendComment <String>]
[-SuspendWhenReadyToComplete]
[-TargetDatabase <DatabaseIdParameter>]
[-TargetDeliveryDomain <Fqdn>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>]
New-MoveRequest
[-Identity] <MailboxOrMailUserIdParameter>
-RemoteCredential <PSCredential>
-RemoteGlobalCatalog <Fqdn>
[-RemoteLegacy]
[-AcceptLargeDataLoss]
[-AllowLargeItems]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompleteAfter <DateTime>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-DomainController <Fqdn>]
[-ForceOffline]
[-IgnoreRuleLimitErrors]
[-IncrementalSyncInterval <TimeSpan>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-MoveOptions <MultiValuedProperty>]
[-MRSServer <Fqdn>]
[-PreventCompletion]
[-Priority <RequestPriority>]
[-Protect]
[-ProxyToMailbox <MailboxIdParameter>]
[-RemoteTargetDatabase <String>]
[-RequestExpiryInterval <Unlimited>]
[-SkipMoving <SkippableMoveComponent[]>]
[-StartAfter <DateTime>]
[-Suspend]
[-SuspendComment <String>]
[-SuspendWhenReadyToComplete]
[-TargetDatabase <DatabaseIdParameter>]
[-TargetDeliveryDomain <Fqdn>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>]
New-MoveRequest
[-Identity] <MailboxOrMailUserIdParameter>
[-AcceptLargeDataLoss]
[-AllowLargeItems]
[-ArchiveOnly]
[-ArchiveTargetDatabase <DatabaseIdParameter>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompleteAfter <DateTime>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-DomainController <Fqdn>]
[-DoNotPreserveMailboxSignature]
[-ForceOffline]
[-ForcePull]
[-ForcePush]
[-IgnoreRuleLimitErrors]
[-IncrementalSyncInterval <TimeSpan>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-MoveOptions <MultiValuedProperty>]
[-MRSServer <Fqdn>]
[-PreventCompletion]
[-PrimaryOnly]
[-Priority <RequestPriority>]
[-Protect]
[-ProxyToMailbox <MailboxIdParameter>]
[-RequestExpiryInterval <Unlimited>]
[-SkipMoving <SkippableMoveComponent[]>]
[-StartAfter <DateTime>]
[-Suspend]
[-SuspendComment <String>]
[-SuspendWhenReadyToComplete]
[-TargetDatabase <DatabaseIdParameter>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>]
New-MoveRequest
[-Identity] <MailboxOrMailUserIdParameter>
-TargetDeliveryDomain <Fqdn>
[-Outbound]
[-AcceptLargeDataLoss]
[-AllowLargeItems]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompleteAfter <DateTime>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-DomainController <Fqdn>]
[-ForceOffline]
[-IncrementalSyncInterval <TimeSpan>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-MoveOptions <MultiValuedProperty>]
[-PreventCompletion]
[-Priority <RequestPriority>]
[-Protect]
[-ProxyToMailbox <MailboxIdParameter>]
[-RequestExpiryInterval <Unlimited>]
[-SkipMoving <SkippableMoveComponent[]>]
[-StartAfter <DateTime>]
[-Suspend]
[-SuspendComment <String>]
[-SuspendWhenReadyToComplete]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>]
New-MoveRequest
[-Identity] <MailboxOrMailUserIdParameter>
-TargetDeliveryDomain <Fqdn>
[-Remote]
[-TargetDatabase <DatabaseIdParameter>]
[-AcceptLargeDataLoss]
[-AllowLargeItems]
[-ArchiveTargetDatabase <DatabaseIdParameter>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompleteAfter <DateTime>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-DomainController <Fqdn>]
[-ForceOffline]
[-IncrementalSyncInterval <TimeSpan>]
[-InternalFlags <InternalMrsFlag[]>]
[-LargeItemLimit <Unlimited>]
[-MoveOptions <MultiValuedProperty>]
[-PreventCompletion]
[-Priority <RequestPriority>]
[-Protect]
[-ProxyToMailbox <MailboxIdParameter>]
[-RequestExpiryInterval <Unlimited>]
[-SkipMoving <SkippableMoveComponent[]>]
[-StartAfter <DateTime>]
[-Suspend]
[-SuspendComment <String>]
[-SuspendWhenReadyToComplete]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>]
说明
您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
New-MoveRequest -Identity 'tony@alpineskihouse.com' -TargetDatabase "DB01" -WhatIf
本示例使用 WhatIf 开关测试邮箱为移动到同一林中的新数据库 DB01 所做的准备情况,以及命令的完成情况。 当使用 WhatIf 开关时,系统将对邮箱执行检查,如果邮箱未准备好,则会收到一个错误。
示例 2
New-MoveRequest -Identity 'tony@alpineskihouse.com' -TargetDatabase "DB01"
本示例将 Tony Smith 的邮箱移动到新数据库 DB01。
示例 3
Get-Mailbox -Database DB01 | New-MoveRequest -TargetDatabase DB02 -BatchName "DB01toDB02"
本示例将为数据库 DB01 中的所有邮箱创建一个批移动请求,并使用 BatchName 参数值 DB01toDB02 将它们移动到数据库 DB02。
参数
-AcceptLargeDataLoss
AcceptLargeDataLoss 开关指定即使无法将源邮箱中的大量项目复制到目标邮箱,该请求也应继续。 不必为此开关指定值。
在 Exchange 2013 或更高版本或 Exchange Online 中,如果将 LargeItemLimit 参数设置为值 51 或更高的值,则需要使用此开关。 否则,该命令将失败。
在 Exchange2010 中,如果将 BadItemLimit 参数设置为 51 或更高的值,则需要使用此开关。 否则,该命令将失败。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-AllowLargeItems
此参数只在本地 Exchange 中可用。
AllowLargeItems 开关指定可顺利复制超过目标邮箱限制的项目。 不必为此开关指定值。
此开关不能与 LargeItemLimit 参数一起使用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ArchiveDomain
ArchiveDomain 参数指定要将存档移动到的外部域的 FQDN。 此参数用于将存档移动到基于云的服务。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ArchiveOnly
ArchiveOnly 开关指定仅移动与邮箱关联的个人存档。 不必为此开关指定值。
此开关不能与 PrimaryOnly 开关一起使用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ArchiveTargetDatabase
此参数只在本地 Exchange 中可用。
ArchiveTargetDatabase 参数指定个人存档的目标邮箱数据库。 可以使用任何能够唯一标识此数据库的值。 例如:
- 名称
- 可分辨名称 (DN)
- GUID
如果不使用此参数,则存档将移至与主邮箱相同的数据库。
Type: | DatabaseIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-BadItemLimit
BadItemLimit 参数指定在请求失败之前允许出现的最大无效项目数。 无效项目是源邮箱中无法复制到目标邮箱的损坏项目。 无效项目限制还包括缺少的项目。 缺少的项目是请求即将完成时在目标邮箱中找不到的源邮箱项目。
此参数的有效输入是一个整数或值 unlimited。 默认值为 0,这意味着如果检测到任何无效项目,请求将失败。 如果你认为有几个损坏项目没有关系,可以将此参数设置为一个合理的值(我们建议为 10 或更低),以便请求可以继续进行。 如果检测到的损坏项目太多,请考虑使用 New-MailboxRepairRequest cmdlet 尝试修复源邮箱中的已损坏项目,然后重试请求。
在 Exchange 2010 中,如果将此值设置为 51 或更高版本,则还需要使用 AcceptLargeDataLoss 开关。 否则,该命令将失败。
注意:在基于云的服务中不建议使用此参数。 将来,如果不使用此参数,将改为使用已跳过的项目审批语义。
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-BatchName
BatchName 参数为移动一批邮箱指定一个描述性名称。 之后,可在使用 Get-MoveRequest cmdlet 时,将 BatchName 参数中的名称用作搜索字符串。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, 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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-CompletedRequestAgeLimit
CompletedRequestAgeLimit 参数指定已完成的请求在自动删除之前可保留的时间。 默认的 CompletedRequestAgeLimit 参数值为 30 天。
Type: | Unlimited |
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 |
-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 2010, Exchange Server 2013, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DoNotPreserveMailboxSignature
此参数只在本地 Exchange 中可用。
DoNotPreserveMailboxSignature 开关指定移动不保留邮箱映射签名。 不必为此开关指定值。
建议仅当移动请求失败时使用此开关,因为命名属性标识符已耗尽。 如果使用此参数,则用户必须在移动请求完成后重新启动 Outlook。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ForceOffline
ForceOffline 开关强制在脱机模式下执行邮箱移动。 不必为此开关指定值。
以脱机模式移动邮箱意味着用户将无法在邮箱移动过程中访问电子邮件。
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 |
-ForcePull
此参数只在本地 Exchange 中可用。
ForcePull 开关指定应为拖移的本地移动类型。 不必为此开关指定值。
此参数仅用于本地移动。
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 |
-ForcePush
此参数只在本地 Exchange 中可用。
ForcePush 开关指定应为推移的本地移动类型。 不必为此开关指定值。
此参数仅用于本地移动。
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 |
-Identity
Identity 参数指定邮箱或邮件用户的标识。 可以使用下列值:
- GUID
- 可分辨名称 (DN)
- 域\帐户
- 用户主体名称 (UPN)
- LegacyExchangeDN
- SMTP 地址
- 别名
Type: | MailboxOrMailUserIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IgnoreRuleLimitErrors
此参数仅在 Exchange Server 2010 或 Exchange Server 2013 中可用
IgnoreRuleLimitErrors 开关指定命令不会将用户的规则移动到运行 Exchange 的目标服务器。 不必为此开关指定值。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013 |
-IncrementalSyncInterval
IncrementalSyncInterval 参数指定增量同步之间的等待时间。 该参数与 CompleteAfter 参数一起使用,以创建将在初始同步完成后执行定期增量同步的移动请求。
若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。
有效值为 00:00:00 至 120.00:00:00(120 天)。 默认值为 24 小时。
Type: | TimeSpan |
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 |
-InternalFlags
此参数只在本地 Exchange 中可用。
InternalFlags 参数指定请求中的可选步骤。 此参数主要用于调试。
Type: | InternalMrsFlag[] |
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 |
-LargeItemLimit
LargeItemLimit 参数指定在请求失败之前允许出现的最大大项目数。 大项目是超过目标邮箱中允许的最大邮件大小的源邮箱邮件。 如果目标邮箱没有专门配置最大邮件大小值,则使用组织范围的值。
有关最大邮件大小值的详细信息,请参阅下列主题:
- Exchange Server:Exchange Server 中的邮件大小限制
- Exchange Online:Exchange Online 限制
此参数的有效输入是一个整数或值 unlimited。 默认值为 0,这意味着如果检测到任何大项目,请求将失败。 如果你认为有几个大项目没有关系,可以将此参数设置为一个合理的值(我们建议为 10 或更低),以便请求可以继续进行。
如果将此值设置为 51 或更高,则还需使用 AcceptLargeDataLoss 开关。 否则,该命令将失败。
注意:在基于云的服务中不建议使用此参数。 将来,如果不使用此参数,将改为使用已跳过的项目审批语义。
Type: | Unlimited |
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 |
-MoveOptions
MoveOptions 参数指定为进行调试而要跳过的移动阶段。 除非 Microsoft 客户服务和支持或特定文档指示使用此参数,否则请不要这么做。
此参数不能与 SkipMoving 参数一起使用。
Type: | MultiValuedProperty |
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 |
-MRSServer
此参数仅在 2010 Exchange Server可用。
MRSServer 参数指定运行 Microsoft Exchange 邮箱复制服务 (MRS) 实例的客户端访问服务器的 FQDN。 此参数仅用于调试目的。 仅在支持人员的指导下使用此参数。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-Outbound
Outbound 开关指定此邮箱移动是跨林移动并正在从源林启动。 不必为此开关指定值。
此开关不能与 Remote 开关一起使用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-PreventCompletion
PreventCompletion 开关指定是否运行移动请求但不允许其完成。 不必为此开关指定值。
请勿使用此开关,我们建议使用 CompleteAfter 参数。
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 |
-PrimaryOnly
PrimaryOnly 开关指定此命令只应移动主邮箱;不移动个人存档。 不必为此开关指定值。
仅当用户具有您不希望移动的个人存档时,您可以使用此开关。 如果用户没有个人存档,则不使用此开关。
不能将此开关用于 ArchiveOnly 开关。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Priority
此参数只在本地 Exchange 中可用。
Priority 参数指定该请求在请求队列中应有的处理顺序。 请求根据服务器运行状况、状态、优先级和最后更新时间按顺序处理。 有效的优先级值为:
- Lowest
- Lower
- Low
- Normal:此值为默认值。
- High
- Higher
- Highest
- Emergency
Type: | RequestPriority |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Protect
此参数只在本地 Exchange 中可用。
保留此参数以供 Microsoft 内部使用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-ProxyToMailbox
此参数仅在基于云的服务中可用。
ProxyToMailbox 参数通过指定邮箱(也称为代理)的位置来指定移动目标。 可以使用能够唯一标识邮箱的任意值。 例如:
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
Type: | MailboxIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-Remote
Remote 开关指定移动操作超出组织范围,而且该移动正在从目标林启动。 不必为此开关指定值。
此开关不能与 Outbound 开关一起使用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RemoteArchiveTargetDatabase
RemoteArchiveTargetDatabase 参数指定要将个人存档移动到的远程林中的目标数据库名称。 将使用存档的用户从本地林移动到远程林时使用此参数。 对于从远程林移动到本地林,请使用 ArchiveTargetDatabase 参数。
如果使用此参数,必须指定 Remote 或 RemoteLegacy 参数。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RemoteCredential
RemoteCredential 参数指定有权执行邮箱移动的管理员的用户名和密码。
此参数的值需要 Get-Credential cmdlet。 要暂停此命令并接收凭据提示,请使用值 (Get-Credential)
。 或者,在运行此命令之前,请将凭据存储在变量(例如,$cred = Get-Credential
)中,然后将变量名称 ($cred
) 用作此参数。 有关详细信息,请参阅 Get-Credential。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RemoteGlobalCatalog
RemoteGlobalCatalog 参数指定远程林的全局编录服务器的完全限定的域名 (FQDN)。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RemoteHostName
RemoteHostName 参数指定用于移动邮箱的跨林组织的 FQDN。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RemoteLegacy
此参数只在本地 Exchange 中可用。
RemoteLegacy 开关指定此邮箱移动来自仅安装了 Exchange 2010 Server 的远程林。 不必为此开关指定值。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-RemoteOrganizationName
保留此参数以供 Microsoft 内部使用。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013 |
-RemoteTargetDatabase
RemoteTargetDatabase 参数指定远程林中目标数据库的名称。 将邮箱从本地林移动到远程林时,请使用此参数。 对于从远程林移动到本地林,请使用 TargetDatabase 参数。
如果使用此参数,必须指定 Remote 或 RemoteLegacy 参数。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-RequestExpiryInterval
RequestExpiryInterval 参数指定已完成或失败的请求的保留期限。 如果使用此参数,那么在指定的时间间隔过期后,已完成或失败的请求会自动删除。 如果不使用此参数:
- 已完成的请求根据 CompletedRequestAgeLimit 参数值自动删除。
- 如果请求失败,则需要使用相应的 Remove-*Request cmdlet 手动将其删除。
若要指定值,请以时间跨度格式 dd.hh:mm:ss 输入值(其中 dd = 天,hh = 小时,mm = 分钟,ss = 秒)。
如果使用值 Unlimited,则不会自动删除已完成的请求。
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 |
-SkipMoving
此参数已被 MoveOptions 参数替换。
SkipMoving 参数指定为进行调试而要跳过的移动阶段。 除非 Microsoft 客户服务和支持或特定文档指示使用此参数,否则请不要这么做。
Type: | SkippableMoveComponent[] |
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 |
-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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Suspend
Suspend 开关指定是否搁置请求。 不必为此开关指定值。
如果您使用此开关,则会将请求排入队列,但在使用相关恢复 cmdlet 恢复请求之前,请求不会处于 InProgress 状态。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SuspendComment
SuspendComment 参数指定有关搁置请求的原因的说明。 如果指定了 Suspend 参数,则只能使用此参数。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SuspendWhenReadyToComplete
SuspendWhenReadyToComplete 开关指定是否在移动请求达到 CompletionInProgress 状态之前挂起该请求。 不必为此开关指定值。
请勿使用此开关,我们建议使用 CompleteAfter 参数。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-TargetDatabase
此参数只在本地 Exchange 中可用。
TargetDatabase 参数指定邮箱的目标邮箱数据库。 可以使用任何能够唯一标识此数据库的值。 例如:
- 名称
- 可分辨名称 (DN)
- GUID
如果不使用此参数,自动分发逻辑将在运行该命令的 Active Directory 网站中选择一个随机数据库。
Type: | DatabaseIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-TargetDeliveryDomain
TargetDeliveryDomain 参数指定移动请求完成时在源林中为已启用邮件的用户创建的外部电子邮件地址的 FQDN。 只有使用 Remote 或 RemoteLegacy 参数执行远程移动时,才允许使用此参数。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-WorkloadType
此参数只在本地 Exchange 中可用。
保留此参数以供 Microsoft 内部使用。
Type: | RequestWorkloadType |
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 |
输入
Input types
若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。