Search-Mailbox
Exchange 2013
适用于：Exchange Server 2013
使用 Search-Mailbox cmdlet 可以搜索邮箱并将结果复制到指定的目标邮箱，从源邮箱删除邮件，或同时从目标邮箱和源邮箱中删除邮件。
语法
Search-Mailbox -TargetFolder <String>-TargetMailbox <MailboxIdParameter> [-DeleteContent<SwitchParameter>] [-LogLevel <Suppress | Basic | Full>] [-LogOnly<SwitchParameter>] <COMMON PARAMETERS>
Search-Mailbox [-DeleteContent<SwitchParameter>] <COMMON PARAMETERS>
Search-Mailbox -EstimateResultOnly <SwitchParameter><COMMON PARAMETERS>
COMMON PARAMETERS: -Identity<MailboxOrMailUserIdParameter> [-Confirm [<SwitchParameter>]][-DomainController <Fqdn>] [-DoNotIncludeArchive <SwitchParameter>][-Force <SwitchParameter>] [-IncludeUnsearchableItems <SwitchParameter>][-SearchDumpster <SwitchParameter>] [-SearchDumpsterOnly<SwitchParameter>] [-SearchQuery <String>] [-WhatIf[<SwitchParameter>]]
示例
示例 1
本示例搜索 Joe Healy 的邮箱，并将搜索结果复制到JoeHealy-ProjectHamilton 文件夹中的 DiscoveryMailbox 中。
Search-Mailbox -Identity "JoeHealy" -SearchQuery "Subject:Project Hamilton" -TargetMailbox"DiscoveryMailbox" -TargetFolder "JoeHealy-ProjectHamilton"-LogLevel Full
示例 2
本示例搜索 April Stewart 的邮箱中主题包含“Your bank statement”短语的邮件，并将结果记录在管理员邮箱的 SearchAndDeleteLog 文件夹中。邮件将不复制到目标邮箱。
Search-Mailbox -Identity "AprilStewart" -SearchQuery 'Subject:"Your bank statement"'-TargetMailbox "administrator" -TargetFolder"SearchAndDeleteLog" -LogOnly -LogLevel Full
示例 3
本示例搜索 April Stewart 的邮箱中主题包含“Your bank statement”短语的邮件，然后从源邮箱中删除这些邮件。您必须分配有“邮箱导入导出”管理角色才能使用 DeleteContent开关。
Search-Mailbox -Identity "AprilStewart" -SearchQuery 'Subject:"Your bank statement"'-DeleteContent
示例 4
此示例将在组织的所有邮箱中搜索包含单词“election”、“candidate”或“vote”的邮件。搜索结果会复制到文件夹 AllMailboxes-Election 下的 Discovery Search Mailbox 中。
Get-Mailbox | Search-Mailbox -SearchQuery'election OR candidate OR vote' -TargetMailbox "Discovery SearchMailbox" -TargetFolder "AllMailboxes-Election" -LogLevel Full
详细说明
您可以使用 Search-Mailbox cmdlet 搜索指定的邮箱中的邮件并执行下列任一任务：
将邮件复制到指定的目标邮箱。
从源邮箱中删除邮件。您必须分配有“邮箱导入导出”管理角色才能删除邮件。
从源邮箱复制邮件并将其从目标邮箱中删除。
执行单个项目恢复以恢复用户的“可恢复项目”文件夹中的项目。
在邮箱的“可恢复项目”文件夹达到“可恢复项目”硬配额时进行清理。
您必须先获得权限，然后才能运行此 cmdlet。虽然此主题中列出了该 cmdlet 的所有参数，但如果这些参数未包含在分配给您的权限中，则您无法使用这些参数。若要查看所需的权限，请参阅邮件策略和遵从性权限主题中的“就地电子数据展示”和“删除邮箱内容”条目。
参数
|
参数 |
必需 |
类型 |
说明 |
||
|
EstimateResultOnly |
必需 |
System.Management.Automation.SwitchParameter |
EstimateResultOnly开关指定将只提供由该搜索返回的邮件总数和总大小的估计值。邮件将不复制到目标邮箱。此开关不能与 TargetMailbox参数一起使用。 |
||
|
Identity |
必需 |
Microsoft.Exchange.Configuration.Tasks.MailboxOrMailUserIdParameter |
Identity参数指定要搜索的邮箱的标识。 此参数接受下列值：
示例：JPhillips
示例：Atlanta.Corp.Contoso.Com/Users/JPhillips
示例：Jeff Phillips
示例：CN=JPhillips,CN=Users,DC=Atlanta,DC=Corp,DC=contoso,DC=com
示例：Atlanta\JPhillips
示例：fb456636-fe7d-4d58-9d15-5af57d0354c2
示例：fb456636-fe7d-4d58-9d15-5af57d0354c2@contoso.com
示例：/o=Contoso/ou=AdministrativeGroup/cn=Recipients/cn=JPhillips
示例：Jeff.Phillips@contoso.com
示例：JPhillips@contoso.com |
||
|
TargetFolder |
必需 |
System.String |
TargetFolder参数指定目标邮箱中用来保存搜索结果的文件夹名称。执行时在目标邮箱中创建该文件夹。 |
||
|
TargetMailbox |
必需 |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
TargetMailbox参数指定搜索结果所复制到的目标邮箱的标识。可以使用下列值：
指定 TargetMailbox参数的值时，还必须指定 TargetFolder参数。此参数不能与 EstimateResultOnly开关一起使用。 |
||
|
Confirm |
可选 |
System.Management.Automation.SwitchParameter |
Confirm开关令此命令暂停处理，并且需要您在继续处理之前确认此命令将执行的操作。无需为 Confirm开关指定值。 |
||
|
DeleteContent |
可选 |
System.Management.Automation.SwitchParameter |
DeleteContent开关指定从源邮箱中永久删除由搜索返回的邮件。与 TargetMailbox参数一起使用时，会将邮件复制到目标邮箱并将其从源邮箱中删除。如果将搜索的日志记录级别设置为 Basic或 Full，则必须指定用来放置日志的目标邮箱和目标文件夹。若要从源邮箱中删除邮件，而不将其复制到目标邮箱中，请不要指定 TargetMailbox、TargetFolder和 LogLevel参数。
|
||
|
DomainController |
可选 |
Microsoft.Exchange.Data.Fqdn |
此参数仅在本地 Exchange 2013 中可用。 DomainController参数指定将此配置更改写入 Active Directory 的域控制器的完全限定的域名 (FQDN)。 |
||
|
DoNotIncludeArchive |
可选 |
System.Management.Automation.SwitchParameter |
DoNotIncludeArchive开关指定用户的存档邮箱不应当包括在搜索中。不必为该开关指定值。 |
||
|
Force |
可选 |
System.Management.Automation.SwitchParameter |
Force开关将覆盖使用 DeleteContent开关永久删除邮件时显示的确认提示。 |
||
|
IncludeUnsearchableItems |
可选 |
System.Management.Automation.SwitchParameter |
IncludeUnsearchableItems开关指定是否包括无法由 Exchange 搜索功能建立索引的项目。当 IncludeUnsearchableItems开关设置为 $true时，将指定应当在搜索结果中包括无法由 Exchange 搜索建立索引的项目。 |
||
|
LogLevel |
可选 |
Microsoft.Exchange.Data.Storage.Infoworker.MailboxSearch.LoggingLevel |
LogLevel参数指定搜索的日志记录级别。它可以具有下列值之一：
默认日志级别为 Basic。 |
||
|
LogOnly |
可选 |
System.Management.Automation.SwitchParameter |
LogOnly开关指定执行搜索并仅生成一个日志。搜索返回的邮件将不复制到目标邮箱。通过使用LogLevel参数指定日志记录级别。 |
||
|
SearchDumpster |
可选 |
System.Management.Automation.SwitchParameter |
SearchDumpster参数指定是否搜索“可恢复邮件”文件夹，该文件夹用来存储从“已删除邮件”文件夹中删除的邮件或硬删除的邮件，直到将这些邮件从邮箱数据库中清除为止。默认情况下，始终搜索“可恢复项目”文件夹。若要从搜索中排除该文件夹，请将 SearchDumpster开关设置为 $false，例如，-SearchDumpster:$false |
||
|
SearchDumpsterOnly |
可选 |
System.Management.Automation.SwitchParameter |
SearchDumpsterOnly开关指定仅搜索指定邮箱的“可恢复项目”文件夹。您还可以将此开关与 DeleteContent开关一起使用，以删除“可恢复项目”文件夹中的邮件，从而减小该文件夹的大小。 |
||
|
SearchQuery |
可选 |
System.String |
SearchQuery参数指定使用关键字查询语言 (KQL) 格式的搜索字符串或查询。有关 KQL 的详细信息，请参阅关键字查询语言语法参考。 如果此参数为空，则返回所有的邮件。 |
||
|
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
WhatIf开关指示命令模拟将对相应对象执行的操作。使用 WhatIf开关，您可以查看会发生的更改，而无需应用其中任何更改。无需为 WhatIf开关指定值。 |
重要说明：