Restore-Mailbox
此 cmdlet 仅在 2010 Exchange Server可用。
使用 Restore-Mailbox cmdlet 从还原的数据库中提取邮箱内容。
注意:在 Exchange Server 2010 Service Pack 1 (SP1) 或更高版本中,使用 New-MailboxRestoreRequest cmdlet 而不是 Restore-Mailbox cmdlet 从还原的数据库中提取邮箱内容。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Restore-Mailbox
[-Identity] <MailboxIdParameter>
-RecoveryDatabase <DatabaseIdParameter>
-RecoveryMailbox <StoreMailboxIdParameter>
-TargetFolder <String>
[-AllowDuplicates]
[-AllContentKeywords <String[]>]
[-AttachmentFilenames <String[]>]
[-BadItemLimit <Int32>]
[-Confirm]
[-ContentKeywords <String[]>]
[-EndDate <DateTime>]
[-ExcludeFolders <MapiFolderPath[]>]
[-GlobalCatalog <Fqdn>]
[-IncludeFolders <MapiFolderPath[]>]
[-Locale <CultureInfo>]
[-MaxThreads <Int32>]
[-RecipientKeywords <String[]>]
[-SenderKeywords <String[]>]
[-StartDate <DateTime>]
[-SubjectKeywords <String[]>]
[-ValidateOnly]
[-WhatIf]
[<CommonParameters>]
说明
Restore-Mailbox cmdlet 会将最终用户数据从运行 Microsoft Exchange Server 2010 的任何服务器复制到具有足够空间和资源来支持邮箱的组织的 Exchange 2010 邮箱服务器上的邮箱。 Restore-Mailbox cmdlet 只能使用服务器上断开连接的邮箱作为数据源,而 cmdlet 只能使用连接的邮箱作为数据的目标。
您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数并未包含在分配给您的权限中,那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase
本示例从数据库 MyRecoveryDatabase 还原用户 Scott 的邮箱。
示例 2
Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase -RecoveryMailbox John -TargetFolder Recovery
本示例将 John 的邮箱内容还原到“恢复”文件夹下的 Scott 邮箱中。
示例 3
Restore-Mailbox -Identity Scott -RecoveryDatabase MyRecoveryDatabase -SubjectKeywords "Meeting" -ContentKeywords "business" -IncludeFolders \Inbox,\Calendar
本示例仅还原主题为“会议”的邮件,邮件正文包含“业务”一词,并且邮件位置位于“收件箱”或“日历”文件夹中。 此示例假定邮箱为英语。
示例 4
Get-Mailbox -Database MyDatabase | Restore-Mailbox -RecoveryDatabase MyRecoveryDatabase
本示例大容量还原 MyRecoveryDatabase 中也存在的 MyDatabase 邮箱数据库中的所有邮箱。
参数
-AllContentKeywords
AllContentKeywords 参数指定以下所有项的筛选器:
- 主题
- 邮件正文
- 附件内容
这允许对所有这些字段进行 OR 搜索。 如果搜索条件是主题、邮件正文或附件内容的一部分,则会获得结果。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-AllowDuplicates
AllowDuplicates 开关复制邮件项目,无需检查邮件项目是否是现有项目的副本,也不删除重复项目。 不必为此开关指定值。
建议将此开关与 IncludeFolders 参数一起使用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-AttachmentFilenames
AttachmentFilenames 参数指定附件文件名的筛选器。 可以在字符串中使用通配符。 例如,可以使用 *.txt 导出扩展名为 .txt 的项目。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-BadItemLimit
BadItemLimit 参数指定邮箱中在导出操作失败之前要跳过的损坏项目数。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-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 |
-ContentKeywords
ContentKeywords 参数指定源邮箱中邮件正文和附件内容的关键字筛选器。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-EndDate
EndDate 参数指定用于筛选将从源邮箱导出的内容的结束日期。 仅导出邮箱中日期早于结束日期的项目。 输入特定日期时,请使用在本地计算机上配置的“区域选项”设置中定义的短日期格式。 例如,如果计算机配置为使用短日期格式 mm/dd/yyyy,请输入 03/01/2010 以指定 2010 年 3 月 1 日。
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-ExcludeFolders
ExcludeFolders 参数指定在导出期间要排除的文件夹的列表。 输入时会排除文件夹。 它们未本地化。 例如,排除日历仅排除英语日历,因为其他语言的日历是不同的单词。
Type: | MapiFolderPath[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-GlobalCatalog
GlobalCatalog 参数指定用于搜索目标邮箱的全局编录。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-Identity
Identity 参数指定要还原的邮箱。 可以使用能够唯一标识邮箱的任意值。 例如:
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
Type: | MailboxIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-IncludeFolders
IncludeFolders 参数指定在导出期间要包含的文件夹的列表。 输入文件夹时会包含这些文件夹。 它们未本地化。 例如,包括日历仅包括英语日历,因为其他语言中的日历是不同的单词。
Type: | MapiFolderPath[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-Locale
Locale 参数指定要还原的消息的区域设置。 使用此筛选器集,仅提取具有指定区域设置的消息。
Type: | CultureInfo |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-MaxThreads
MaxThreads 参数指定要使用的最大线程数。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-RecipientKeywords
RecipientKeywords 参数指定源邮箱中项目收件人的关键字筛选器。 此筛选器会查找搜索字符串,即使它是单词的一部分。 这不是整个单词搜索。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-RecoveryDatabase
RecoveryDatabase 参数指定要从中还原邮箱的恢复数据库。 可以使用任何能够唯一标识此数据库的值。 例如:
- 名称
- 可分辨名称 (DN)
- GUID
Type: | DatabaseIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-RecoveryMailbox
RecoveryMailbox 参数指定要用作源邮箱的邮箱。 如果源邮箱不同于目标邮箱,则此参数是必需的。
可以通过邮箱的 GUID 值来标识邮箱。 您可以通过使用 Get-Mailbox 或 Get-MailboxStatistics cmdlet 查找 GUID 值。
Type: | StoreMailboxIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-SenderKeywords
SenderKeywords 参数指定源邮箱中项目的发件人的关键字筛选器。 此筛选器会查找搜索字符串,即使它是单词的一部分。 这不是整个单词搜索。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-StartDate
StartDate 参数指定开始日期。 开始日期必须早于结束日期。
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-SubjectKeywords
SubjectKeywords 参数指定源邮箱中项目主题的关键字筛选器。 此筛选器会查找搜索字符串,即使它是单词的一部分。 这不是整个单词搜索。
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-TargetFolder
TargetFolder 参数指定在指定的邮箱上创建的邮箱文件夹。 如果要还原的邮箱不同于目标邮箱,则此参数是必需的。 (例如,使用 Identity 参数指定的值与使用 RecoveryMailbox 参数指定的值不同。) 在这种情况下,Restore-Mailbox 命令执行合并。 如果值相同,则不需要 TargetFolder 参数。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-ValidateOnly
ValidateOnly 开关指示命令评估执行操作所需的条件和要求,然后报告操作是成功还是失败。 不必为此开关指定值。
使用此开关时,不会进行更改。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-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 |
输入
Input types
若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。