New-MailboxImportRequest
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 New-MailboxImportRequest cmdlet 可以开始将 .pst 文件导入到邮箱或存档。
注意:Exchange Online不再支持此 cmdlet。 若要在 Exchange Online 中导入 .pst 文件,请参阅使用网络上传导入 PST 文件。
此 cmdlet 仅在邮箱导入导出角色中可用,默认情况下,该角色不分配给任何角色组。 要使用此 cmdlet,需将邮箱导入导出角色添加到角色组(例如,添加到“组织管理”角色组)。 有关详细信息,请参阅向角色组添加角色。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
New-MailboxImportRequest
[-Mailbox] <MailboxOrMailUserIdParameter>
-FilePath <LongPath>
[-AcceptLargeDataLoss]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-ContentCodePage <Int32>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-InternalFlags <InternalMrsFlag[]>]
[-IsArchive]
[-LargeItemLimit <Unlimited>]
[-MRSServer <Fqdn>]
[-Name <String>]
[-Priority <RequestPriority>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceRootFolder <String>]
[-Suspend]
[-SuspendComment <String>]
[-TargetRootFolder <String>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>]
New-MailboxImportRequest
[-Mailbox] <MailboxLocationIdParameter>
-FilePath <LongPath>
[-AcceptLargeDataLoss]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-ContentCodePage <Int32>]
[-DomainController <Fqdn>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-InternalFlags <InternalMrsFlag[]>]
[-IsArchive]
[-LargeItemLimit <Unlimited>]
[-MigrationMailbox <MailboxIdParameter>]
[-Name <String>]
[-Priority <RequestPriority>]
[-RequestExpiryInterval <Unlimited>]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceEndpoint <MigrationEndpointIdParameter>]
[-SourceRootFolder <String>]
[-Suspend]
[-SuspendComment <String>]
[-TargetRootFolder <String>]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>]
New-MailboxImportRequest
[-Mailbox] <MailboxLocationIdParameter>
-AzureBlobStorageAccountUri <Uri>
-AzureSharedAccessSignatureToken <String>
[-AcceptLargeDataLoss]
[-AssociatedMessagesCopyOption <FAICopyOption>]
[-AzureStatusPublishEndpointInfo <String>]
[-BadItemLimit <Unlimited>]
[-BatchName <String>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-ConflictResolutionOption <ConflictResolutionOption>]
[-ContentCodePage <Int32>]
[-ExcludeDumpster]
[-ExcludeFolders <String[]>]
[-IncludeFolders <String[]>]
[-IsArchive]
[-LargeItemLimit <Unlimited>]
[-MRSContentFilterSasUri <Uri>]
[-MigrationBatch <MigrationBatchIdParameter>]
[-MigrationMailbox <MailboxIdParameter>]
[-MigrationUser <MigrationUserIdParameter>]
[-Name <String>]
[-RequestExpiryInterval <Unlimited>]
[-SkipInitialConnectionValidation]
[-SkipMerging <SkippableMergeComponent[]>]
[-SourceEndpoint <MigrationEndpointIdParameter>]
[-SourceRootFolder <String>]
[-SuspendComment <String>]
[-Suspend]
[-TargetRootFolder <String>]
[-WhatIf]
[<CommonParameters>]
说明
您可以为每个邮箱创建多个邮箱导入请求,并且每个邮箱导入请求必须具有唯一的名称。 Microsoft Exchange 为邮箱导入请求自动生成最多 10 个唯一名称。 但是,若要为邮箱创建 10 个以上的导入请求,需要在创建导入请求时指定一个唯一的名称,或者可以使用 Remove-MailboxExportRequest cmdlet 删除现有导入请求,然后再启动具有默认请求的新导入请求 <Alias>\MailboxImportX
(其中 X = 0-9) 。
默认情况下,如果目标邮箱或目标存档中存在匹配项,导入操作将检查重复的项目,并且不会将数据从 .pst 文件复制到邮箱或存档。
在本地 Exchange 中,需要向要导出或导入 PST 文件的网络共享授予组 Exchange 受信任子系统的以下权限:
- 从共享中导入 PST 文件:读取权限
- 将导出的 PST 文件保存到共享:读/写权限。
如果您不授予此权限,则将收到一条错误消息,指示 Exchange 无法建立与网络共享上 PST 文件的连接。
示例
示例 1
New-MailboxImportRequest -Mailbox Ayla -FilePath \\SERVER01\PSTFiles\Recovered.pst -TargetRootFolder "RecoveredFiles" -IncludeFolders "#Inbox#"
本示例将 SERVER01 中已恢复的 .pst 文件导入到用户 Ayla 的主邮箱。 只导入 .pst 文件的“收件箱”中的数据。 将数据导入到 Ayla 的目标邮箱的 RecoveredFiles 文件夹中。
示例 2
New-MailboxImportRequest Kweku -FilePath \\server\share\User1.pst -IsArchive -TargetRootFolder /
本示例将 .pst 文件导入到 Kweku 的存档文件夹。 未指定 TargetRootFolder;因此,合并现有文件夹下的内容,如果目标文件夹结构中不包含这些内容,则创建新文件夹。
示例 3
Dir \\SERVER01\PSTshareRO\Recovered\*.pst | %{ New-MailboxImportRequest -Name RecoveredPST -BatchName Recovered -Mailbox $_.BaseName -FilePath $_.FullName -TargetRootFolder SubFolderInPrimary}
本示例导入共享文件夹上的所有 .pst 文件。 在相应用户的别名后命名每个 .pst 文件名。 命令为所有 .pst 文件创建导入请求并将数据导入到匹配的邮箱。
参数
-AcceptLargeDataLoss
AcceptLargeDataLoss 开关指定即使无法将源邮箱中的大量项目复制到目标邮箱,该请求也应继续。 不必为此开关指定值。
在 Exchange 2013 或更高版本中,如果将 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 |
-AssociatedMessagesCopyOption
AssociatedMessagesCopyOption 参数指定处理请求时是否复制关联邮件。 关联邮件指包含隐藏数据(其中包含有关规则、视图和窗体的信息)的特殊邮件。 默认情况下,复制关联的消息。 此参数不能与 IncludedRecipients 参数或任意 Conditional 参数一起使用。
- DoNotCopy:不会复制关联的消息。
- MapByMessageClass:此选项通过查找源消息的 MessageClass 属性来查找相应的关联消息。 如果源和目标文件夹中都有此类的关联邮件,则会覆盖目标中的关联邮件。 如果目标中没有关联的消息,则会在目标中创建一个副本。
- 复制:此选项将关联的消息从源复制到目标。 如果源位置和目标位置中都存在相同的消息类型,则这些关联的消息会重复。 这是默认选项。
Copy:此选项将关联邮件从源位置复制到目标位置。如果源位置和目标位置存在同一邮件类型,这些关联邮件将造成重复。这是默认选项。
Type: | FAICopyOption |
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 |
-AzureBlobStorageAccountUri
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-AzureSharedAccessSignatureToken
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-AzureStatusPublishEndpointInfo
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
Type: | String |
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 尝试修复源邮箱中的已损坏项目,然后重试请求。
在 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-MailboxImportRequest 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 |
-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 |
-ConflictResolutionOption
ConflictResolutionOption 参数指定目标中有多个匹配消息时要执行的操作。 有效值包含:
- ForceCopy (Exchange 2016 或更高版本)
- KeepAll
- KeepLatestItem
- KeepSourceItem (这是默认值)
- KeepTargetItem (Exchange 2016 或更高版本)
- UpdateFromSource (Exchange 2016 或更高版本)
Type: | ConflictResolutionOption |
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 |
-ContentCodePage
ContentCodePage 参数指定特定代码页以用于 ANSI pst 文件。 ANSI pst 文件在 Outlook 97 到 Outlook 2002 中使用。 可以在 代码页标识符 主题中找到有效值。
Type: | Int32 |
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 |
-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 |
-ExcludeDumpster
ExcludeDumpster 开关指定是否排除“可恢复的项目”文件夹。 不必为此开关指定值。
如果不使用此开关,则会使用以下子文件夹复制“可恢复的项目”文件夹:
- 删除
- 版本
- 清除
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 |
-ExcludeFolders
ExcludeFolders 参数指定在导入期间要排除的文件夹的列表。
如果 exADNoMk 联合身份验证服务 (AD FS) 已部署,允许单一登录外部部署邮箱,且 AD FS 配置为对登录令牌请求使用除 ExchangeGUID 之外的其他属性,则您必须设置 ImmutableId 参数。 exExchangeNoVersion 和 AD FS 两者必须为同一用户请求相同的令牌,才能确保跨界 exExchangeNoVersion 部署应用场景的正常运行。
<FolderName>/*
:使用此语法表示 SourceRootFolder 参数中指定的文件夹下的个人文件夹,例如“MyProjects”或“MyProjects/FY2010”。
#<FolderName>#/*
:使用此语法表示已知文件夹,而不考虑该文件夹在其他语言中的名称。 例如,#Inbox# 表示收件箱文件夹,即使收件箱本地化为土耳其语(即 Gelen Kutusu)。 已知文件夹包括以下类型:
- Inbox
- SentItems
- DeletedItems
- 日历
- 联系人
- 草稿
- 日志
- 任务
- 注意
- JunkEmail
- CommunicatorHistory
- 语音邮件
- Fax
- 冲突
- SyncIssues
- LocalFailures
- ServerFailures
如果用户创建的个人文件夹与已知文件夹的名称相同,并且其周围带有 #符号,则可以使用反斜杠 (\) 作为转义字符来指定该文件夹。 例如,如果用户创建名为 #Notes# 的文件夹,并且你想要指定该文件夹而不是已知的 Notes 文件夹,请使用以下语法: \#Notes\#
。
如果用户创建的个人文件夹的名称与已知文件夹的名称相同且周围有 # 符号,则可以将反斜杠 (\) 用作转义字符以指定该文件夹。例如,如果用户创建了一个名为 #Notes# 的文件夹且您想指定该文件夹,但不是已知的“Notes”文件夹,请使用以下语法:\#Notes\#.
如果导入“可恢复项目”文件夹时没有指定 TargetRootFolder 参数,则可恢复项目内容会放入目标邮箱或存档的“可恢复项目”文件夹中。
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 |
-FilePath
此参数只在本地 Exchange 中可用。
FilePath 参数指定要从中导入数据的 .pst 文件的网络共享路径,例如,\\SERVER01\PST Files\ToImport.pst。
您需要向要在其中导出或导入 PST 文件的网络共享授予对“Exchange 受信任子系统”组的以下权限:
- 从共享中导入 PST 文件:读取权限
- 将导出的 PST 文件保存到共享:读/写权限。
如果您不授予此权限,则将收到一条错误消息,指示 Exchange 无法建立与网络共享上 PST 文件的连接。
Type: | LongPath |
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 |
-IncludeFolders
IncludeFolders 参数指定在导入期间要包含的文件夹的列表。
如果 exADNoMk 联合身份验证服务 (AD FS) 已部署,允许单一登录外部部署邮箱,且 AD FS 配置为对登录令牌请求使用除 ExchangeGUID 之外的其他属性,则您必须设置 ImmutableId 参数。 exExchangeNoVersion 和 AD FS 两者必须为同一用户请求相同的令牌,才能确保跨界 exExchangeNoVersion 部署应用场景的正常运行。
<FolderName>/*
:使用此语法表示 SourceRootFolder 参数中指定的文件夹下的个人文件夹,例如“MyProjects”或“MyProjects/FY2010”。
#<FolderName>#/*
:使用此语法表示已知文件夹,而不考虑该文件夹在其他语言中的名称。 例如,#Inbox# 表示收件箱文件夹,即使收件箱本地化为土耳其语(即 Gelen Kutusu)。 已知文件夹包括以下类型:
- Inbox
- SentItems
- DeletedItems
- 日历
- 联系人
- 草稿
- 日志
- 任务
- 注意
- JunkEmail
- CommunicationHistory
- 语音邮件
- Fax
- 冲突
- SyncIssues
- LocalFailures
- ServerFailures
如果用户创建的个人文件夹与已知文件夹的名称相同,并且其周围带有 #符号,则可以使用反斜杠 (\) 作为转义字符来指定该文件夹。 例如,如果用户创建名为 #Notes# 的文件夹,并且你想要指定该文件夹而不是已知的 Notes 文件夹,请使用以下语法: \#Notes\#
。
如果用户创建的个人文件夹的名称与已知文件夹的名称相同且周围有 # 符号,则可以将反斜杠 (\) 用作转义字符以指定该文件夹。例如,如果用户创建了一个名为 #Notes# 的文件夹且您想指定该文件夹,但不是已知的“Notes”文件夹,请使用以下语法:\#Notes\#.
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 |
-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 |
-IsArchive
IsArchive 开关指定将 .pst 文件导入到用户存档。 不必为此开关指定值。
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 |
-LargeItemLimit
LargeItemLimit 参数指定在请求失败之前允许出现的最大大项目数。 大项目是超过目标邮箱中允许的最大邮件大小的源邮箱邮件。 如果目标邮箱没有专门配置最大邮件大小值,则使用组织范围的值。
有关最大邮件大小值的详细信息,请参阅下列主题:
- Exchange 2016: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 |
-Mailbox
Mailbox 参数指定要将内容导入到的目标邮箱。
在 Exchange 2016 CU7 或更高版本中,此参数的类型是 MailboxLocationIdParameter,因此可用于标识邮箱的最简单值是别名值。
在 Exchange 2016 CU6 或更早版本中,此参数的类型是 MailboxOrMailUserIdParameter,因此可以使用任何唯一标识邮箱的值。 例如:
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
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 |
-MigrationBatch
此参数仅在基于云的服务中可用。
此参数保留供内部Microsoft使用
Type: | MigrationBatchIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-MigrationMailbox
保留此参数以供 Microsoft 内部使用。
Type: | MailboxIdParameter, AzureImportRequest |
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 |
-MigrationUser
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
Type: | MigrationUserIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-MRSContentFilterSasUri
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | 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 |
-Name
Name 参数指定特定请求的名称,以供跟踪和显示。 由于每个邮箱可以有多个导入请求,因此 Exchange 在名称前面加上邮箱的别名。 例如,如果为别名为 Kweku 的用户邮箱创建导入请求并指定此参数的值为 PC1toArchive,则此导入请求的标识为 Kweku\PC1toArchive。
如果不使用此参数指定名称,Exchange 将为每个邮箱生成最多 10 个请求名称,即 MailboxImportX (其中 X = 0-9) 。 请求的标识显示为 并可 <alias>\MailboxImportX
搜索。
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 |
-Priority
此参数只在本地 Exchange 中可用。
Priority 参数指定此请求在请求队列中应有的处理顺序。 根据服务器运行状况、状态、优先级和上次更新时间,按顺序处理请求。
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 |
-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 |
-SkipInitialConnectionValidation
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-SkipMerging
SkipMerging 参数指定导入中应跳过的步骤。 此参数主要用于调试。
Type: | SkippableMergeComponent[] |
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 |
-SourceEndpoint
保留此参数以供 Microsoft 内部使用。
Type: | MigrationEndpointIdParameter |
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 |
-SourceRootFolder
SourceRootFolder 参数指定从中导入数据的 .pst 文件的根文件夹。 指定根文件夹后,不会导入超出 SourceRootFolder 参数值范围的文件夹层次结构,并且将 SourceRootFolder 参数映射为 TargetRootFolder 参数。 如果未指定此参数,该命令会导入所有文件夹。
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 |
-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 |
-TargetRootFolder
TargetRootFolder 参数指定放置导入内容的顶级邮箱文件夹。 如果未指定此参数,则命令会将文件夹导入到目标邮箱或存档中的文件夹结构顶层。 如果文件夹已经存在,则合并现有文件夹下的内容,如果目标文件夹结构中不包含这些内容,则创建新文件夹。
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 |
-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 不返回任何数据。