EXCHANGE 2013 Search-mailbox命令详解

tyxiayu

　　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参数指定要搜索的邮箱的标识。
　　此参数接受下列值：

• 　　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参数。
　　重要说明：
　　您需要分配有“邮箱导入导出”管理角色才能使用此开关。默认情况下，不向任何角色组分配此角色。通常，您可以将角色分配给内置或自定义角色组。或者，您可以将角色分配给用户或通用安全组。
　　使用 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开关指定值。