通过

Restore-Mailbox

模块:
Exchange PowerShell

此 cmdlet 仅在 2010 Exchange Server可用。

使用 Restore-Mailbox cmdlet 从还原的数据库中提取邮箱内容。

注意：在 Exchange Server 2010 Service Pack 1 (SP1) 或更高版本中，使用 New-MailboxRestoreRequest cmdlet 而不是 Restore-Mailbox cmdlet 从还原的数据库中提取邮箱内容。

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

语法

Default （默认值） 

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

适用：Exchange Server 2010

AllContentKeywords 参数指定以下所有项的筛选器：

  • 主题
  • 邮件正文
  • 附件内容

这允许对所有这些字段进行 OR 搜索。 如果搜索条件是主题、邮件正文或附件内容的一部分，则会获得结果。

参数属性

类型:

String[]

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

参数集

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

-AllowDuplicates

适用：Exchange Server 2010

AllowDuplicates 开关复制邮件项目，无需检查邮件项目是否是现有项目的副本，也不删除重复项目。 不必为此开关指定值。

建议将此开关与 IncludeFolders 参数一起使用。

参数属性

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

参数集

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

-AttachmentFilenames

适用：Exchange Server 2010

AttachmentFilenames 参数指定附件文件名的筛选器。 可以在字符串中使用通配符。 例如，可以使用 *.txt 导出扩展名为 .txt 的项目。

参数属性

类型:

String[]

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

参数集

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

-BadItemLimit

适用：Exchange Server 2010

BadItemLimit 参数指定邮箱中在导出作失败之前要跳过的损坏项目数。

参数属性

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

参数集

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

-Confirm

适用：Exchange Server 2010

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

-ContentKeywords

适用：Exchange Server 2010

ContentKeywords 参数指定源邮箱中邮件正文和附件内容的关键字 (keyword) 筛选器。

参数属性

类型:

String[]

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

参数集

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

-EndDate

适用：Exchange Server 2010

EndDate 参数指定要从源邮箱导出的筛选内容的结束日期。 仅导出邮箱中日期早于结束日期的项目。 输入特定日期时，请使用在本地计算机上配置的“区域选项”设置中定义的短日期格式。 例如，如果计算机配置为使用短日期格式 MM/dd/yyyy，请输入 03/01/2010 以指定 2010 年 3 月 1 日。

参数属性

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

参数集

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

-ExcludeFolders

适用：Exchange Server 2010

ExcludeFolders 参数指定在导出期间要排除的文件夹的列表。 文件夹在输入时被排除。 它们未本地化。 例如，排除日历仅排除英语日历，因为其他语言的日历是不同的单词。

参数属性

类型:

MapiFolderPath[]

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

参数集

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

-GlobalCatalog

适用：Exchange Server 2010

GlobalCatalog 参数指定用于搜索目标邮箱的全局编录。

参数属性

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

参数集

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

-Identity

适用：Exchange Server 2010

Identity 参数指定要还原的邮箱。 可以使用能够唯一标识邮箱的任意值。 例如：

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • 域\用户名
  • 电子邮件地址
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • 用户 ID 或用户主体名称 (UPN)

参数属性

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

参数集

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

-IncludeFolders

适用：Exchange Server 2010

IncludeFolders 参数指定在导出期间要包含的文件夹的列表。 输入文件夹时会包含这些文件夹。 它们未本地化。 例如，包括日历仅包括英语日历，因为其他语言中的日历是不同的单词。

参数属性

类型:

MapiFolderPath[]

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

参数集

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

-Locale

适用：Exchange Server 2010

Locale 参数指定要还原的消息的区域设置。 使用此筛选器集，仅提取具有指定区域设置的消息。

参数属性

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

参数集

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

-MaxThreads

适用：Exchange Server 2010

MaxThreads 参数指定要使用的最大线程数。

参数属性

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

参数集

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

-RecipientKeywords

适用：Exchange Server 2010

RecipientKeywords 参数指定源邮箱中项目的收件人关键字 (keyword) 筛选器。 此筛选器会查找搜索字符串，即使它是单词的一部分。 这不是整个单词搜索。

参数属性

类型:

String[]

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

参数集

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

-RecoveryDatabase

适用：Exchange Server 2010

RecoveryDatabase 参数指定要从中还原邮箱的恢复数据库。 可以使用任何能够唯一标识此数据库的值。 例如：

  • 名称
  • 可分辨名称 (DN)
  • GUID

参数属性

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

参数集

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

-RecoveryMailbox

适用：Exchange Server 2010

RecoveryMailbox 参数指定要用作源邮箱的邮箱。 如果源邮箱不同于目标邮箱，则此参数是必需的。

可以通过邮箱的 GUID 值来标识邮箱。 您可以通过使用 Get-Mailbox 或 Get-MailboxStatistics cmdlet 查找 GUID 值。

参数属性

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

参数集

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

-SenderKeywords

适用：Exchange Server 2010

SenderKeywords 参数指定源邮箱中项目的发件人关键字 (keyword) 筛选器。 此筛选器会查找搜索字符串，即使它是单词的一部分。 这不是整个单词搜索。

参数属性

类型:

String[]

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

参数集

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

-StartDate

适用：Exchange Server 2010

StartDate 参数指定开始日期。 开始日期必须早于结束日期。

参数属性

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

参数集

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

-SubjectKeywords

适用：Exchange Server 2010

SubjectKeywords 参数指定源邮箱中项目主题的关键字 (keyword) 筛选器。 此筛选器会查找搜索字符串，即使它是单词的一部分。 这不是整个单词搜索。

参数属性

类型:

String[]

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

参数集

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

-TargetFolder

适用：Exchange Server 2010

TargetFolder 参数指定在指定的邮箱上创建的邮箱文件夹。 如果要还原的邮箱不同于目标邮箱，则此参数是必需的。 (例如，使用 Identity 参数指定的值与使用 RecoveryMailbox 参数指定的值不同。) 在这种情况下，Restore-Mailbox 命令执行合并。 如果值相同，则不需要 TargetFolder 参数。

参数属性

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

参数集

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

-ValidateOnly

适用：Exchange Server 2010

ValidateOnly 开关指定是在不进行更改的情况下评估命令的潜在成功还是失败。 不必为此开关指定值。

参数属性

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

参数集

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

-WhatIf

适用：Exchange Server 2010

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 不返回任何数据。