Set-MailboxImportRequest

模块:: Exchange PowerShell

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。某些参数和设置可能只属于一个环境或另一个环境。

创建请求后，使用 Set-MailboxImportRequest cmdlet 更改导入请求选项。可使用 Set-MailboxImportRequest cmdlet 从失败的导入请求中恢复。

此 cmdlet 仅在邮箱导入导出角色中可用，默认情况下，该角色不会分配给任何角色组。要使用此 cmdlet，需将邮箱导入导出角色添加到角色组（例如，添加到“组织管理”角色组）。有关详细信息，请参阅向角色组添加角色。

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

语法

Identity

Set-MailboxImportRequest
    [-Identity] <MailboxImportRequestIdParameter>
    [-AcceptLargeDataLoss]
    [-BadItemLimit <Unlimited>]
    [-BatchName <String>]
    [-CompletedRequestAgeLimit <Unlimited>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-InternalFlags <InternalMrsFlag[]>]
    [-LargeItemLimit <Unlimited>]
    [-Priority <RequestPriority>]
    [-RequestExpiryInterval <Unlimited>]
    [-SkipMerging <SkippableMergeComponent[]>]
    [-WhatIf]
    [<CommonParameters>]

Rehome

Set-MailboxImportRequest
    [-Identity] <MailboxImportRequestIdParameter>
    [-RehomeRequest]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-RequestExpiryInterval <Unlimited>]
    [-WhatIf]
    [<CommonParameters>]

Default

Set-MailboxImportRequest
    [-Identity] <MailboxImportRequestIdParameter>
    [-AzureSharedAccessSignatureToken <String>]
    [-AcceptLargeDataLoss]
    [-BatchName <String>]
    [-CompletedRequestAgeLimit <Unlimited>]
    [-Confirm]
    [-RequestExpiryInterval <Unlimited>]
    [-SkipInitialConnectionValidation]
    [-SkipMerging <SkippableMergeComponent[]>]
    [-SkippedItemApprovalTime <System.DateTime>]
    [-WhatIf]
    [<CommonParameters>]

说明

您可以通过管道从 Get-MailboxImportRequest cmdlet 传输 Set-MailboxImportRequest cmdlet。

您必须先获得权限，然后才能运行此 cmdlet。尽管本文列出了 cmdlet 的所有参数，但如果某些参数未包含在分配给你的权限中，则可能无法访问这些参数。若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Set-MailboxImportRequest -Identity "Kweku\Import" -BadItemLimit 5

本示例将导入请求 Kweku\Import 更改为最多接受五个损坏的邮箱项目。

示例 2

Get-MailboxImportRequest -Status Suspended | Set-MailboxImportRequest -BatchName April14

本示例查找所有状态为 Suspended 的导入请求，然后为它们提供一个批处理名称 April14。

参数

-AcceptLargeDataLoss

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

AcceptLargeDataLoss 开关指定即使无法将源邮箱中的大量项目复制到目标邮箱，该请求也应继续。不必为此开关指定值。

在 Exchange 2013 或更高版本中，如果将 LargeItemLimit 参数设置为值 51 或更高版本，则需要使用此开关。否则，该命令将失败。

在 Exchange2010 中，如果将 BadItemLimit 参数设置为 51 或更高的值，则需要使用此开关。否则，该命令将失败。

在 Exchange Online 中，此开关不依赖于 BadItemLimit 或 LargeItemLimit 参数，因为这些参数不可用。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

Default

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

Identity

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-AzureSharedAccessSignatureToken

适用：Exchange Online

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

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

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

Default

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-BadItemLimit

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

BadItemLimit 参数指定在请求失败之前允许出现的最大无效项目数。无效项目是源邮箱中无法复制到目标邮箱的损坏项目。无效项目限制还包括缺少的项目。缺少的项目是请求即将完成时在目标邮箱中找不到的源邮箱项目。

此参数的有效输入是一个整数或值 unlimited。默认值为 0，这意味着如果检测到任何无效项目，请求将失败。如果你认为有几个损坏项目没有关系，可以将此参数设置为一个合理的值（我们建议为 10 或更低），以便请求可以继续进行。如果检测到的损坏项目太多，请考虑使用 New-MailboxRepairRequest cmdlet 尝试修复源邮箱中的已损坏项目，然后重试请求。

在 Exchange 2010 中，如果将此值设置为 51 或更高版本，则还需要使用 AcceptLargeDataLoss 开关。否则，该命令将失败。

注意：此参数已从基于云的服务中弃用。在导入完成之前，管理员必须查看数据一致性分数和任何跳过的项目。

参数属性

类型:	Unlimited
默认值:	None
支持通配符:	False
不显示:	False

参数集

Identity

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-BatchName

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

BatchName 参数指定批次的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

Default

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

Identity

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-CompletedRequestAgeLimit

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

CompletedRequestAgeLimit 参数指定已完成的请求在被自动删除之前保留的时间。默认的 CompletedRequestAgeLimit 参数值为 30 天。

参数属性

类型:	Unlimited
默认值:	None
支持通配符:	False
不显示:	False

参数集

Default

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

Identity

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

适用：Exchange Server 2010、Exchange Server 2013、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 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此参数只在本地 Exchange 中可用。

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。可以使用完全限定的域名 (FQDN) 来标识域控制器。例如，dc01.contoso.com。

参数属性

类型:	Fqdn
默认值:	None
支持通配符:	False
不显示:	False

参数集

Identity

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

Rehome

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Identity

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

Identity 参数指定导入请求的标识。默认情况下，导入请求命名 <alias>\MailboxImportX (其中 X = 0-9) 。如果使用 New-MailboxImportRequest cmdlet 为导入请求指定了名称，请使用以下语法： Alias\Name。

参数属性

类型:	MailboxImportRequestIdParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	1
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-InternalFlags

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此参数只在本地 Exchange 中可用。

InternalFlags 参数指定请求中的可选步骤。此参数主要用于调试。

参数属性

类型:	InternalMrsFlag[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

Identity

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-LargeItemLimit

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此参数只在本地 Exchange 中可用。

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

有关最大消息大小值的详细信息，请参阅 Exchange Server 中的消息大小限制。

此参数的有效输入是一个整数或值 unlimited。默认值为 0，这意味着如果检测到任何大项目，请求将失败。如果你认为有几个大项目没有关系，可以将此参数设置为一个合理的值（我们建议为 10 或更低），以便请求可以继续进行。

如果将此值设置为 51 或更高，则还需使用 AcceptLargeDataLoss 开关。否则，该命令将失败。

注意：此参数已从基于云的服务中弃用。在导入完成之前，管理员必须查看数据一致性分数和任何跳过的项目。

参数属性

类型:	Unlimited
默认值:	None
支持通配符:	False
不显示:	False

参数集

Identity

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Priority

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此参数只在本地 Exchange 中可用。

Priority 参数指定该请求在请求队列中应有的处理顺序。请求根据服务器运行状况、状态、优先级和最后更新时间按顺序处理。有效的优先级值为：

Lowest
Lower
Low
正常：此值为默认值。
High
Higher
Highest
Emergency

参数属性

类型:	RequestPriority
默认值:	None
支持通配符:	False
不显示:	False

参数集

Identity

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-RehomeRequest

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE

此参数只在本地 Exchange 中可用。

RehomeRequest 参数告知 Microsoft Exchange 邮箱复制服务 (MRS) 需要将请求移动到要导入的邮箱所在的同一数据库。不必为此开关指定值。

此开关主要用于调试目的。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

Rehome

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-RequestExpiryInterval

适用：Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

RequestExpiryInterval 参数指定已完成或失败的请求的保留期限。如果使用此参数，那么在指定的时间间隔过期后，已完成或失败的请求会自动删除。如果不使用此参数：

已完成的请求根据 CompletedRequestAgeLimit 参数值自动删除。
如果请求失败，则需要使用相应的 Remove-*Request cmdlet 手动将其删除。

若要指定值，请将其输入为时间跨度：dd.hh：mm：ss，其中 dd = 天，hh = 小时，mm = 分钟，ss = 秒。

如果使用值 Unlimited，则不会自动删除已完成的请求。

参数属性

类型:	Unlimited
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SkipInitialConnectionValidation

适用：Exchange Online

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

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

Default

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SkipMerging

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

SkipMerging 参数指定导入中应跳过的步骤。此参数主要用于调试。

参数属性

类型:	SkippableMergeComponent[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

Default

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

Identity

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SkippedItemApprovalTime

适用：Exchange Online

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

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

参数属性

类型:	System.DateTime
默认值:	None
支持通配符:	False
不显示:	False

参数集

Default

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WhatIf

适用：Exchange Server 2010、Exchange Server 2013、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。

输入

Input types

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。

反馈

此页面是否有帮助？