EXCHANGE 2013 Search-mailbox命令详解
Search-MailboxExchange 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参数指定要搜索的邮箱的标识。
此参数接受下列值：
[*] Alias
示例：JPhillips
[*] Canonical DN
示例：Atlanta.Corp.Contoso.Com/Users/JPhillips
[*] Display Name
示例：Jeff Phillips
[*] Distinguished Name (DN)
示例：CN=JPhillips,CN=Users,DC=Atlanta,DC=Corp,DC=contoso,DC=com
[*] Domain\Account
示例：Atlanta\JPhillips
[*] GUID
示例：fb456636-fe7d-4d58-9d15-5af57d0354c2
[*]
Immutable>
示例：fb456636-fe7d-4d58-9d15-5af57d0354c2@contoso.com
[*] Legacy Exchange DN
示例：/o=Contoso/ou=AdministrativeGroup/cn=Recipients/cn=JPhillips
[*] SMTP Address
示例：Jeff.Phillips@contoso.com
[*] User Principal Name
示例：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参数。
http://blog.51cto.com/e/u261/themes/default/images/spacer.gif重要说明：
您需要分配有“邮箱导入导出”管理角色才能使用此开关。默认情况下，不向任何角色组分配此角色。通常，您可以将角色分配给内置或自定义角色组。或者，您可以将角色分配给用户或通用安全组。
使用 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开关指定值。
页:
[1]