|
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参数指定搜索结果所复制到的目标邮箱的标识。可以使用下列值:
- Alias
- 显示名称
- 域\帐户
- SMTP 地址
- DN
- 对象 GUID
- UPN
- LegacyExchangeDN
指定 TargetMailbox参数的值时,还必须指定 TargetFolder参数。此参数不能与 EstimateResultOnly开关一起使用。
Confirm
可选
System.Management.Automation.SwitchParameter
Confirm开关令此命令暂停处理,并且需要您在继续处理之前确认此命令将执行的操作。无需为 Confirm开关指定值。
DeleteContent
可选
System.Management.Automation.SwitchParameter
DeleteContent开关指定从源邮箱中永久删除由搜索返回的邮件。与 TargetMailbox参数一起使用时,会将邮件复制到目标邮箱并将其从源邮箱中删除。如果将搜索的日志记录级别设置为 Basic或 Full,则必须指定用来放置日志的目标邮箱和目标文件夹。若要从源邮箱中删除邮件,而不将其复制到目标邮箱中,请不要指定 TargetMailbox、TargetFolder和 LogLevel参数。
重要说明:
您需要分配有“邮箱导入导出”管理角色才能使用此开关。默认情况下,不向任何角色组分配此角色。通常,您可以将角色分配给内置或自定义角色组。或者,您可以将角色分配给用户或通用安全组。
使用 DeleteContent开关删除内容之前,建议您使用 LogOnly参数测试搜索参数,如示例 2 中所示。
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参数指定搜索的日志记录级别。它可以具有下列值之一:
- Suppress 不保留日志。
- Basic 保留查询和查询执行人员的基本信息。
- Full 除了 Basic日志级别所保留的信息外,Full日志级别还增加了一个完整的搜索结果列表。
默认日志级别为 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开关指定值。 |
|