Export (0) Print
Expand All

Get-StoreUsageStatistics

 

Applies to: Exchange Server 2013

This cmdlet is available only in on-premises Exchange Server 2013.

Use the Get-StoreUsageStatistics cmdlet to aid in diagnosing performance issues with your servers or databases.

For information about the parameter sets in the Syntax section below, see Syntax.

Get-StoreUsageStatistics -Identity <GeneralMailboxIdParameter> [-CopyOnServer <ServerIdParameter>] <COMMON PARAMETERS>
Get-StoreUsageStatistics -Database <DatabaseIdParameter> [-CopyOnServer <ServerIdParameter>] <COMMON PARAMETERS>
Get-StoreUsageStatistics -Server <ServerIdParameter> [-IncludePassive <SwitchParameter>] <COMMON PARAMETERS>
COMMON PARAMETERS: [-DomainController <Fqdn>] [-Filter <String>]

Below are some examples of how to use the Get-StoreUsageStatistics cmdlet.

This example retrieves store usage statistics for all active databases on server EX1.

Get-StoreUsageStatistics -Server EX1 | ft -auto

This example retrieves store usage statistics for all active and passive databases on server EX1.

Get-StoreUsageStatistics -Server EX1 -IncludePassive | ft -auto

This example retrieves store usage statistics for database DB1, and sorts the output by the 10 highest log file generators.

Get-StoreUsageStatistics -Database DB1 | Sort-Object LogRecordBytes -desc | Select-Object -First 10 | ft DigestCategory, *guid, LogRecordBytes, *time* -auto

The Microsoft Exchange Information Store collects per-user information on latency, input/output (I/O), page counts, processor usage, and TimeInServer. The TimeInServer metric represents the total time that synchronous and asynchronous requests spend in the Microsoft Exchange Information Store for a user's mailbox. You can retrieve this resource information in the Microsoft Exchange Information Store for the 25 highest usage accounts on a specified database. Usage of a mailbox is defined as the amount of server time spent in performing operations for that mailbox. The cmdlet reports the top 25 users for every one-minute period for the last 10 minutes (250 objects per ten-minute interval). The resource usage is an indicator of the load that different users are placing on the server.

You need to be assigned permissions before you can run this cmdlet. Although all parameters for this cmdlet are listed in this topic, you may not have access to some parameters if they're not included in the permissions assigned to you. To see what permissions you need, see the "Mailbox databases" entry in the Recipients Permissions topic.

 

Parameter Required Type Description

Database

Required

Microsoft.Exchange.Configuration.Tasks.DatabaseIdParameter

The Database parameter specifies the name of the mailbox database. When you specify a value for the Database parameter, the Exchange Management Shell returns usage statistics for the top 25 mailboxes on the database specified.

You can use the following value:

  • Database

Identity

Required

Microsoft.Exchange.Configuration.Tasks.GeneralMailboxIdParameter

The Identity parameter specifies a mailbox. When you specify a value for the Identity parameter, the command looks up the mailbox specified in the Identity parameter, connects to the server where the mailbox resides, and returns the statistics for the mailbox. You can use one of the following values:

  • GUID

  • Distinguished name (DN)

  • Domain\Account

  • User principal name (UPN)

  • Legacy Exchange DN

  • SMTP address

  • Alias

NoteNote:
Results are returned for the mailbox only if it's one of the top 25 users of store resources.

Server

Required

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

The Server parameter specifies the server from which you want to obtain mailbox statistics. You can use one of the following values:

  • Fully qualified domain name (FQDN)

  • NetBIOS name

When you specify a value for the Server parameter, the command returns usage statistics for the top 25 mailboxes on all the active databases on the specified server. If you don't specify this parameter, the command returns logon statistics for the local server.

CopyOnServer

Optional

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

The CopyOnServer parameter is used to retrieve statistics from a specific database copy from the server specified with the Server parameter.

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

The DomainController parameter specifies the fully qualified domain name (FQDN) of the domain controller that retrieves data from Active Directory.

Filter

Optional

System.String

The Filter parameter indicates the OPath filter used to filter recipients.

IncludePassive

Optional

System.Management.Automation.SwitchParameter

Without the IncludePassive parameter, the cmdlet retrieves statistics from active database copies only. Using the IncludePassive parameter, you can have the cmdlet return statistics from all active and passive database copies.

To see the input types that this cmdlet accepts, see Cmdlet Input and Output Types. If the Input Type field for a cmdlet is blank, the cmdlet doesn’t accept input data.

To see the return types, which are also known as output types, that this cmdlet accepts, see Cmdlet Input and Output Types. If the Output Type field is blank, the cmdlet doesn’t return data.

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft