EXCHANGE 2013 Search-mailbox命令详解

2020-12-16 18:20 来源:未知 作者:mas 责编:mas

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 ID

示例: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,则必须指定用来放置日志的目标邮箱和目标文件夹。若要从源邮箱中删除邮件,而不将其复制到目标邮箱中,请不要指定  TargetMailboxTargetFolder和 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开关指定值。

【版权声明】本站部分内容来源于互联网,本站不拥有所有权,如果发现本站有侵权的内容,欢迎发送邮件至 benumon@163.com 举报,并提供相关证据,一经查实,本站将立刻删除涉嫌侵权内容。

分享:

更多文章

相关文章

关键词:

一生受益-思韵闪耀-专业IT技术社区 - 爱编程,爱源码,爱技术,一生受益。

powerby 一生受益-思韵闪耀    豫ICP备13002912号-2