Get-MailboxStatistics
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 Get-MailboxStatistics cmdlet 可返回有关邮箱的信息，例如邮箱的大小、它包含的邮件数以及上次访问该邮箱的时间。 此外，还可以获取已完成移动请求的移动历史记录或移动报告。
注意：在 Exchange Online PowerShell 中，建议使用 Get-EXOMailboxStatistics cmdlet 而不是此 cmdlet。 有关详细信息，请参阅使用远程 PowerShell 连接到 Exchange Online。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Get-MailboxStatistics
-Database <DatabaseIdParameter>
[[-StoreMailboxIdentity] <StoreMailboxIdParameter>]
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-Filter <String>]
[-IncludeMoveHistory]
[-IncludeMoveReport]
[-IncludeQuarantineDetails]
[-NoADLookup]
[<CommonParameters>] Get-MailboxStatistics
[-Identity] <GeneralMailboxOrMailUserIdParameter>
[-Archive]
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-IncludeMoveHistory]
[-IncludeMoveReport]
[-IncludeQuarantineDetails]
[-IncludeSoftDeletedRecipients]
[-NoADLookup]
[<CommonParameters>] Get-MailboxStatistics
-Server <ServerIdParameter>
[-DomainController <Fqdn>]
[-Filter <String>]
[-IncludeMoveHistory]
[-IncludeMoveReport]
[-IncludePassive]
[-IncludeQuarantineDetails]
[-NoADLookup]
[<CommonParameters>] 说明
只能在邮箱服务器上使用不带参数的 Get-MailboxStatistics cmdlet。 在这种情况下，cmdlet 返回本地服务器上所有数据库上所有邮箱的统计信息。
Get-MailboxStatistics cmdlet 至少需要以下参数之一才能成功完成：服务器、数据库或标识。
可以使用 Get-MailboxStatistics cmdlet 返回详细的移动历史记录和已完成移动请求的移动报告，以便对移动请求进行故障排除。 若要查看移动历史记录，必须将此 cmdlet 作为对象传递。 移动历史记录保留在邮箱数据库中，以增量方式编号，最后执行的移动请求始终编号为 0。 有关详细信息，请参阅本主题中的“示例 7”、“示例 8”和“示例 9”。
只能查看已完成移动请求的移动报告和移动历史记录。
您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Get-MailboxStatistics -Identity AylaKol此示例使用关联的别名 Ayla Kol 检索用户 Ayla Kol 邮箱的邮箱统计信息。
示例 2
Get-MailboxStatistics -Server MailboxServer01此示例检索服务器 MailboxServer01 上所有邮箱的邮箱统计信息。
示例 3
Get-MailboxStatistics -Identity contoso\chris此示例检索指定邮箱的邮箱统计信息。
示例 4
Get-MailboxStatistics -Database "Mailbox Database"此示例检索指定邮箱数据库中所有邮箱的邮箱统计信息。
示例 5
Get-MailboxDatabase | Get-MailboxStatistics -Filter 'DisconnectDate -ne $null'本示例检索组织中所有邮箱数据库的已断开连接邮箱的邮箱统计信息。 -ne 运算符表示不相等。
示例 6
Get-MailboxStatistics -Database "Mailbox Database" -StoreMailboxIdentity 3b475034-303d-49b2-9403-ae022b43742d此示例检索单个断开连接邮箱的邮箱统计信息。 StoreMailboxIdentity 参数的值是断开连接的邮箱的邮箱 GUID。 还可以使用旧版DN。
示例 7
Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory | Format-List此示例返回 Ayla Kol 邮箱的已完成移动请求的摘要移动历史记录。 如果不通过管道将输出传递给 Format-List cmdlet，则不会显示移动历史记录。
示例 8
$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveHistory
$temp.MoveHistory[0]此示例返回 Ayla Kol 邮箱的已完成移动请求的详细移动历史记录。 此示例使用临时变量来存储邮箱统计信息对象。 如果邮箱已多次移动，则有多个移动报告。 最后一个移动报表始终为 MoveReport[0]。
示例 9
$temp=Get-MailboxStatistics -Identity AylaKol -IncludeMoveReport
$temp.MoveHistory[0] | Export-CSV C:\MoveReport_AylaKol.csv此示例返回 Ayla Kol 邮箱的详细移动历史记录和详细移动报告。 此示例使用临时变量来存储移动请求统计信息对象，并将移动报告输出到 CSV 文件。
参数
-Archive
存档开关指定是否返回与邮箱关联的存档邮箱的邮箱统计信息。 不必为此开关指定值。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-CopyOnServer
此参数只在本地 Exchange 中可用。
CopyOnServer 参数用于从指定服务器上的特定数据库副本检索统计信息。
可以使用唯一标识该服务器的任何值。 例如：
- 名称
- FQDN
- 可分辨名称 (DN)
- Exchange 旧版 DN
Exchange 旧版 DN
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Database
此参数只在本地 Exchange 中可用。
Database 参数返回指定数据库上所有邮箱的统计信息。 可以使用任何能够唯一标识此数据库的值。 例如：
- 名称
- 可分辨名称 (DN)
- GUID
此参数接受来自 Get-MailboxDatabase cmdlet 的管道输入。
| Type: | DatabaseIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
此参数只在本地 Exchange 中可用。
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Filter
此参数只在本地 Exchange 中可用。
Filter 参数使用 OPATH 语法按指定的属性和值筛选结果。 搜索条件使用 语法 "Property -ComparisonOperator 'Value'"。
- 将整个 OPATH 筛选器括在双引号“”中。 如果筛选器包含系统值 (，例如
$true、$false或$null) ，请改用单引号 ' 。 虽然此参数是一个字符串 (不是) 的系统块，但也可以使用大括号 { }，但前提是筛选器不包含变量。 - 属性是可筛选的属性。
- ComparisonOperator 是一个 OPATH 比较运算符， (例如
-eq用于等于和-like字符串比较) 。 有关比较运算符的详细信息，请参阅 about_Comparison_Operators。 - Value 是要搜索的属性值。 将文本值和变量括在单引号 (
'Value'或'$Variable') 。 如果变量值包含单引号，则需要识别 (转义) 单引号才能正确展开变量。 例如，使用'$($User -Replace "'","''")'而不是'$User'。 不要将整数或系统值括在引号 (例如，改用500、$true、$false或$null) 。
可以使用逻辑运算符 -and 和 -or将多个搜索条件链接在一起。 例如，"Criteria1 -and Criteria2" 或 "(Criteria1 -and Criteria2) -or Criteria3"。
有关 Exchange 中的 OPATH 筛选器的详细信息，请参阅 其他 OPATH 语法信息。
例如，若要在特定邮箱数据库上显示所有断开连接的邮箱，请使用以下语法： 'DisconnectDate -ne $null'。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Identity 参数指定要为其返回统计信息的邮箱。 可以使用能够唯一标识邮箱的任意值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
| Type: | GeneralMailboxOrMailUserIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IncludeMoveHistory
IncludeMoveHistory 开关指定是否返回包含已完成移动请求历史记录的邮箱的其他信息，例如状态、标志、目标数据库、不良项目、开始时间、结束时间、移动请求处于不同阶段的持续时间以及失败代码。 不必为此开关指定值。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IncludeMoveReport
IncludeMoveReport 开关指定是否返回已完成移动请求的详细移动报告，例如服务器连接和移动阶段。 不必为此开关指定值。
由于此命令的输出是详细的，因此应将输出发送到 .CSV 文件，以便于分析。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-IncludePassive
此参数只在本地 Exchange 中可用。
IncludePassive 开关指定是否从所有主动和被动数据库副本返回统计信息。 不必为此开关指定值。
如果不使用此开关，该命令仅从活动数据库副本检索统计信息。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IncludeQuarantineDetails
此参数只在本地 Exchange 中可用。
IncludeQuarantineDetails 开关指定是否返回有关未包含在结果中的邮箱的其他隔离详细信息。 可以使用这些详细信息来确定邮箱何时以及为何被隔离。 不必为此开关指定值。
具体而言，此开关返回邮箱上的 QuarantineDescription、QuarantineLastCrash 和 QuarantineEnd 属性的值。 若要查看这些值，需要使用格式化 cmdlet。 例如，Get-MailboxStatistics <MailboxIdentity> -IncludeQuarantineDetails | Format-List Quarantine*。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IncludeSoftDeletedRecipients
此参数仅在基于云的服务中可用。
IncludeSoftDeletedRecipients 开关指定是否在结果中包含软删除的邮箱。 不必为此开关指定值。
软删除的邮箱是仍然可以恢复的已删除邮箱。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-NoADLookup
此参数只在本地 Exchange 中可用。
NoADLookup 开关指定从邮箱数据库检索信息，而不是从 Active Directory 检索信息。 不必为此开关指定值。
在查询包含大量邮箱的邮箱数据库时，此开关有助于提高 cmdlet 性能。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Server
此参数只在本地 Exchange 中可用。
Server 参数指定要从中获取邮箱统计信息的服务器。 可以使用下列值之一：
- 完全限定的域名 (FQDN)
- NetBIOS 名称
为 Server 参数指定值时，命令将返回指定服务器上所有数据库（包括恢复数据库）上所有邮箱的统计信息。 如果不指定此参数，则该命令将返回本地服务器的登录统计信息。
| Type: | ServerIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-StoreMailboxIdentity
此参数只在本地 Exchange 中可用。
当与 Database 参数一起使用时，StoreMailboxIdentity 参数指定邮箱标识，以返回指定数据库上单个邮箱的统计信息。 可以使用下列值之一：
- MailboxGuid
- LegacyDN
使用此语法检索有关断开连接的邮箱的信息，这些邮箱没有相应的 Active Directory 对象，或者具有相应的 Active Directory 对象，该对象不指向邮箱数据库中断开连接的邮箱。
| Type: | StoreMailboxIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。