收件人 Cmdlet


Get-MailboxStatistics

适用于: Exchange Server 2010 SP2

上一次修改主题: 2011-09-07

使用 Get-MailboxStatistics cmdlet 可以获取有关邮箱的信息,例如,邮箱大小、所包含的邮件数、以及最后访问时间。此外,还可以获取已完成移动请求的移动历史记录或移动报告。

语法


Get-MailboxStatistics -Identity <GeneralMailboxOrMailUserIdParameter> [-Archive <SwitchParameter>] [-DomainController <Fqdn>] [-IncludeMoveHistory <SwitchParameter>] [-IncludeMoveReport <SwitchParameter>]

Get-MailboxStatistics -Database <DatabaseIdParameter> [-DomainController <Fqdn>]

Get-MailboxStatistics -Server <ServerIdParameter> [-DomainController <Fqdn>]
详细说明

只能在邮箱服务器上使用不带参数的 Get-MailboxStatistics cmdlet。在这种情况下,该 cmdlet 将返回本地服务器上所有数据库中所有邮箱的统计信息。

Bb124612.note(zh-CN,EXCHG.141).gif注意:
Get-MailboxStatistics cmdlet 要求至少成功完成下列任一参数:ServerDatabaseIdentity

可以使用 Get-MailboxStatistics cmdlet 返回已完成移动请求的详细移动历史记录和移动报告,以解决移动请求问题。若要查看移动历史记录,必须将此 cmdlet 作为一个对象进行传递。移动历史记录保留在邮箱数据库中并以增量方式进行编号,上次执行的移动请求始终编号为 0。有关详细信息,请参阅本主题稍后部分的“示例 6”、“示例 7”和“示例 8”。

Bb124612.note(zh-CN,EXCHG.141).gif注意:
只能看到已完成的移动请求的移动报告和移动历史记录。

您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数未包含在分配给您的权限中,则您无法访问这些参数。 若要查看所需的权限,请参阅邮箱权限主题中的“收件人设置权限”部分。

参数

参数 必需 类型 描述

Database

必需

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

Database 参数指定邮箱数据库的名称。为 Database 参数指定值时,Exchange 命令行管理程序将返回指定数据库中所有邮箱的统计信息。

可以使用下列值:

  • GUID
  • 数据库

此参数接受来自 Get-MailboxDatabase cmdlet 的管道输入。

Identity

必需

Microsoft.Exchange.Configuration.Tasks.GeneralMailboxOrMailUserIdParameter

Identity 参数指定邮箱。指定 Identity 参数的值时,此命令会查找 Identity 参数中指定的邮箱,连接到邮箱所在的服务器,并返回邮箱的统计信息。

此参数接受下列值:

  • Alias
    示例: JPhilips
  • Canonical DN
    示例: Atlanta.Corp.Contoso.Com/Users/JPhilips
  • Display Name
    示例: Jeff Philips
  • Distinguished Name (DN)
    示例: CN=JPhilips,CN=Users,DC=Atlanta,DC=Corp,DC=contoso,DC=com
  • Domain\Account
    示例: Atlanta\JPhilips
  • 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=JPhilips
  • SMTP Address
    示例: Jeff.Philips@contoso.com
  • User Principal Name
    示例: JPhilips@contoso.com

Server

必需

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

Server 参数指定要从中获取邮箱统计信息的服务器。可以使用下列值之一:

  • 完全限定的域名 (FQDN)
  • NetBIOS 名称

Server 参数指定值时,此命令将返回指定服务器上所有数据库(包括恢复数据库)中所有邮箱的统计信息。如果不指定此参数,则该命令将返回本地服务器的登录统计信息。

Archive

可选

System.Management.Automation.SwitchParameter

Archive 开关参数指定是否返回与指定邮箱关联的存档邮箱的邮箱统计信息。

不必为该参数指定值。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

DomainController 参数指定从 Active Directory 中检索数据的域控制器的完全限定域名 (FQDN)。

IncludeMoveHistory

可选

System.Management.Automation.SwitchParameter

IncludeMoveHistory 开关指定是否返回包含已完成移动请求的历史记录的邮箱的其他信息,例如,状态、标志、目标数据库、损坏项目、开始时间、结束时间、移动请求在各个阶段的持续时间以及失败代码。

IncludeMoveReport

可选

System.Management.Automation.SwitchParameter

IncludeMoveReport 开关指定是否返回已完成移动请求的详细移动报告,例如,服务器连接和移动阶段。

Bb124612.note(zh-CN,EXCHG.141).gif注意:
由于此命令的输出比较详细,应将其发送到 .CSV 文件,以便于分析。
输入类型

若要查看此 cmdlet 接受的输入类型,请参阅 Cmdlet 输入和输出类型。 如果 cmdlet 的输入类型字段为空,则 cmdlet 不接受输入数据。

返回类型

若要查看此 cmdlet 接受的返回类型(也称为输出类型),请参阅 Cmdlet 输入和输出类型。 如果输出类型字段为空,则 cmdlet 不返回数据。

错误

错误 描述

 

 

异常

异常 描述

 

 

示例

示例 1

此示例使用别名 AylaKol 检索某个邮箱的邮箱统计信息。

Get-MailboxStatistics -Identity AylaKol
示例 2

本示例检索 MailboxServer01 服务器上所有邮箱的邮箱统计信息。

Get-MailboxStatistics -Server MailboxServer01
示例 3

本示例检索指定邮箱的邮箱统计信息。

Get-MailboxStatistics -Identity contoso\chris
示例 4

本示例检索指定邮箱数据库中所有邮箱的邮箱统计信息。

Get-MailboxStatistics -Database "Mailbox Database"
示例 5

本示例检索所有断开的邮箱的邮箱统计信息。本示例使用了 WHERE 子句。$_ 变量用于指定通过管道传递的对象。-ne 运算符表示“不等于”。

Get-MailboxStatistics | Where {$_.DisconnectDate -ne $null}
示例 6

本示例返回 Ayla Kol 的邮箱的已完成移动请求的移动历史记录摘要。如果不通过管道将输出传递给 Format-List cmdlet,将不会显示移动历史记录。

Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory | Format-List
示例 7

本示例返回 Ayla Kol 的邮箱的已完成移动请求的详细移动历史记录。本示例使用临时变量存储邮箱统计信息对象。如果多次移动邮箱,将有多个移动报告。上次的移动报告始终是 MoveReport[0]

$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory
$temp.MoveHistory[0]
示例 8

本示例返回 Ayla Kol 的邮箱的详细移动历史记录和详细移动报告。本示例使用临时变量存储移动请求统计信息对象,并将移动报告输出到 CSV 文件中。

$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveReport
$temp.MoveHistory[0] | Export-CSV C:\MoveReport_AylaKol.csv
Page view tracker