Applies to: Exchange Server 2013

Topic Last Modified: 2012-07-12

Use the Get-LogonStatistics cmdlet to retrieve logon statistics, such as user name, logon time, last access time, client version, and adapter speed.

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

Syntax

Get-LogonStatistics -Identity <LogonableObjectIdParameter> <COMMON PARAMETERS>
Get-LogonStatistics -Database <DatabaseIdParameter> <COMMON PARAMETERS>
Get-LogonStatistics -Server <ServerIdParameter> <COMMON PARAMETERS>
COMMON PARAMETERS: [-DomainController <Fqdn>]

Examples

EXAMPLE 1

This example returns logon statistics for all users connected to the server Server01.

Copy Code
Get-LogonStatistics -Server Server01

Detailed Description

The Get-LogonStatistics cmdlet retrieves logon information about currently active sessions. On Mailbox servers only, you can use the Get-LogonStatistics cmdlet without parameters. In this case, the cmdlet returns the logon statistics for all mailboxes on all databases on the local server.

Note:
Users who log on to their mailboxes using Microsoft Office Outlook Web App aren't continually connected to the Mailbox server. An Outlook Web App client connects to the server, performs tasks, and then disconnects from the server. Therefore, you may see few or no logon statistics for Outlook Web App, even if users are logged on with this client.

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 "Recipient Provisioning Permissions" section in the Recipients Permissions topic.

Parameters

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 logon statistics for all the mailboxes in the database specified.

You can use the following value:

  • Database

This parameter accepts pipeline input from the Get-MailboxDatabase command.

Identity

Required

Microsoft.Exchange.Configuration.Tasks.LogonableObjectIdParameter

The Identity parameter specifies a mailbox for which you want to obtain logon statistics. You can use one of the following values:

  • GUID

  • Distinguished name (DN)

  • Domain\Account

  • User principal name (UPN)

  • Legacy Exchange DN

  • SmtpAddress

  • Alias

This parameter accepts pipeline input from the Get-Mailbox command.

Server

Required

Microsoft.Exchange.Configuration.Tasks.ServerIdParameter

The Server parameter specifies the server from which you want to obtain logon 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 logon statistics for all the mailboxes on all the databases, including recovery databases, on the specified server. If you don't specify this parameter, the command returns logon statistics for the local server.

This parameter accepts pipeline input from the Get-ExchangeServer and Get-MailboxServer commands.

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.

Input Types

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.

Return Types

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.