Share via


Get-LogonStatistics

 

Applies to: Exchange Server 2007 SP1, Exchange Server 2007 SP2, Exchange Server 2007 SP3

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

Syntax

Get-LogonStatistics [-Identity <LogonableObjectIdParameter>] [-DomainController <Fqdn>]

Get-LogonStatistics -Database <DatabaseIdParameter> [-DomainController <Fqdn>]

Get-LogonStatistics -Server <ServerIdParameter> [-DomainController <Fqdn>]

Detailed Description

The Get-LogonStatistics cmdlet retrieves logon information about sessions that are currently active.

Note

Users who log on to their mailboxes using Microsoft Outlook Web Access are not continually connected to the Mailbox server. An Outlook Web Access client connects to the server, performs tasks, and then disconnects. Therefore, you may see very few or even no logon statistics for Outlook Web Access, even if users are logged on with this client.

To run the Get-LogonStatistics cmdlet, the account you use must be delegated the following:

  • Exchange View-Only Administrator role

For more information about permissions, delegating roles, and the rights that are required to administer Exchange Server 2007, see Permission Considerations.

On Mailbox servers only, you can use the Get-LogonStatistics cmdlet without parameters. In this case, the cmdlet will return the logon statistics for all mailboxes on all databases on the local server.

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 on the database specified.

You can use the following values:

  • Server\StorageGroup\Database

  • Server\Database

  • Database

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

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 do not specify this parameter, the command returns logon statistics for the local server.

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

DomainController

Optional

Microsoft.Exchange.Data.Fqdn

To specify the fully qualified domain name (FQDN) of the domain controller that retrieves data from the Active Directory directory service, include the DomainController parameter in the command.

Identity

Optional

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 cmdlet.

Input Types

Return Types

Errors

Error Description

 

Exceptions

Exceptions Description

 

Example

In this example, the Get-LogonStatistics command is used to return logon statistics for all users who are connected to the server named Server01.

Get-LogonStatistics -Server Server01