Get-StoreUsageStatistics
此 cmdlet 仅适用于本地 Exchange。
使用 Get-StoreUsageStatistics cmdlet 可以帮助诊断服务器或数据库的性能问题。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Database
Get-StoreUsageStatistics
-Database <DatabaseIdParameter>
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-Filter <String>]
[<CommonParameters>]
Identity
Get-StoreUsageStatistics
[-Identity] <GeneralMailboxIdParameter>
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-Filter <String>]
[<CommonParameters>]
Server
Get-StoreUsageStatistics
-Server <ServerIdParameter>
[-IncludePassive]
[-DomainController <Fqdn>]
[-Filter <String>]
[<CommonParameters>]
说明
Microsoft Exchange 信息存储收集有关延迟、输入/输出 (I/O) 、页计数、处理器使用情况和 TimeInServer 的每个用户信息。 TimeInServer 指标表示同步和异步请求在用户邮箱的 Microsoft Exchange 信息存储中花费的总时间。 可以在Microsoft Exchange 信息存储中检索指定数据库上 25 个使用率最高的帐户的此资源信息。 邮箱的使用率是指服务器在对该邮箱执行操作方面所花费的时间。 cmdlet 报告最后 10 分钟内每一分钟的前 25 个用户(每十分钟间隔 250 个对象)。 资源使用率是反映不同用户给服务器带来的负载的指标。
您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果某些参数未包含在分配给你的权限中,则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Get-StoreUsageStatistics -Server EX1 | ft -auto
本示例检索服务器 EX1 上所有活动数据库的存储使用情况统计信息。
示例 2
Get-StoreUsageStatistics -Server EX1 -IncludePassive | ft -auto
本示例检索服务器 EX1 上所有活动和被动数据库的存储使用情况统计信息。
示例 3
Get-StoreUsageStatistics -Database DB1 | Sort-Object LogRecordBytes -desc | Select-Object -First 10 | ft DigestCategory, *guid, LogRecordBytes, *time* -auto
此示例检索数据库 DB1 的存储使用情况统计信息,并按 10 个最高的日志文件生成器对输出进行排序。
参数
-CopyOnServer
适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
CopyOnServer 参数指定要从中获取使用情况统计信息的邮箱数据库副本。 可以使用唯一标识邮箱数据库的任何值。 例如:
- 名称
- 可分辨名称 (DN)
- GUID
此参数与服务器或标识参数一起使用。
参数属性
| 类型: | ServerIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Database
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
Identity
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Database
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Database 参数指定邮箱数据库的名称,以便从 (指定邮箱数据库) 的前 25 个最大邮箱获取使用情况统计信息。 可以使用唯一标识邮箱数据库的任何值。 例如:
- 名称
- 可分辨名称 (DN)
- GUID
不能将此参数与标识或服务器参数一起使用。
参数属性
| 类型: | DatabaseIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Database
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-DomainController
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。
参数属性
| 类型: | Fqdn |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Filter
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
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 语法信息。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Identity
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Identity 参数指定要从中获取使用情况统计信息的邮箱。 可以使用以下值之一来标识邮箱:
- GUID
- 可分辨名称 (DN)
- 域\帐户
- 用户主体名称 (UPN)
- 旧版 Exchange DN
- SMTP 地址
- 别名
仅当邮箱是存储资源的前 25 个用户之一时,命令才会返回邮箱的结果。
不能将此参数与数据库或服务器参数一起使用。
参数属性
| 类型: | GeneralMailboxIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-IncludePassive
适用:Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
IncludePassive 开关指定是否包含使用 Server 参数指定的邮箱服务器上邮箱数据库的主动副本和被动副本的使用情况统计信息。 不必为此开关指定值。
如果不使用此开关,则结果中仅包含来自邮箱数据库的活动副本的统计信息。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Server
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Server
适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Server 参数指定邮箱服务器从) (指定服务器上所有活动数据库的前 25 个邮箱获取使用情况统计信息。 可以使用以下值之一来标识服务器:
- 完全限定的域名 (FQDN)
- NetBIOS 名称
不能将此参数与数据库或标识参数一起使用。
参数属性
| 类型: | ServerIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Server
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。
输入
Input types
若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。