Get-StoreUsageStatistics
此 cmdlet 仅适用于本地 Exchange。
使用 Get-StoreUsageStatistics cmdlet 可以帮助诊断服务器或数据库的性能问题。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Get-StoreUsageStatistics
-Database <DatabaseIdParameter>
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-Filter <String>]
[<CommonParameters>]
Get-StoreUsageStatistics
[-Identity] <GeneralMailboxIdParameter>
[-CopyOnServer <ServerIdParameter>]
[-DomainController <Fqdn>]
[-Filter <String>]
[<CommonParameters>]
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
CopyOnServer 参数指定要从中获取使用情况统计信息的邮箱数据库副本。 可以使用唯一标识邮箱数据库的任何值。 例如:
- 名称
- 可分辨名称 (DN)
- GUID
此参数与服务器或标识参数一起使用。
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
Database 参数指定邮箱数据库的名称,以便从 (指定邮箱数据库) 的前 25 个最大邮箱获取使用情况统计信息。 可以使用唯一标识邮箱数据库的任何值。 例如:
- 名称
- 可分辨名称 (DN)
- GUID
不能将此参数与标识或服务器参数一起使用。
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
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
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 语法信息。
Type: | String |
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 |
-Identity
Identity 参数指定要从中获取使用情况统计信息的邮箱。 可以使用以下值之一来标识邮箱:
- GUID
- 可分辨名称 (DN)
- 域\帐户
- 用户主体名称 (UPN)
- 旧版 Exchange DN
- SMTP 地址
- 别名
仅当邮箱是存储资源前 25 个用户之一时,该命令才会返回邮箱的结果。
不能将此参数与数据库或服务器参数一起使用。
Type: | GeneralMailboxIdParameter |
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 |
-IncludePassive
IncludePassive 开关指定是否包含使用 Server 参数指定的邮箱服务器上邮箱数据库的主动副本和被动副本的使用情况统计信息。 不必为此开关指定值。
如果不使用此开关,则结果中仅包含来自邮箱数据库的活动副本的统计信息。
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
Server 参数指定邮箱服务器从) (指定服务器上所有活动数据库的前 25 个邮箱获取使用情况统计信息。 可以使用以下值之一来标识服务器:
- 完全限定的域名 (FQDN)
- NetBIOS 名称
不能将此参数与数据库或标识参数一起使用。
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 |
输入
Input types
若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。