Get-LogonStatistics

Reference

Module:: ExchangePowerShell

Applies to:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

This cmdlet is functional only in Exchange Server 2010.

The Get-LogonStatistics cmdlet has been deprecated and is no longer used.

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

Syntax

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

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

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

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.

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 Mailbox Permissions topic.

Examples

Example 1

Get-LogonStatistics -Server Server01

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

Parameters

-Database

The Database parameter specifies the mailbox database to get logon statistics from (all mailboxes in the specified database). You can use any value that uniquely identifies the mailbox database. For example:

Name
Distinguished name (DN)
GUID

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

You can't use this parameter with the Identity or Server parameters.

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

The DomainController parameter specifies the domain controller that's used by this cmdlet to read data from or write data to Active Directory. You identify the domain controller by its fully qualified domain name (FQDN). For example, 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

-Identity

The Identity parameter specifies the mailbox to get logon statistics from. You can use one of the following values to identify the mailbox:

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.

You can't use this parameter with the Database or Server parameters.

Type:	LogonableObjectIdParameter
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, Exchange Online

-Server

The Server parameter specifies the Mailbox server to get logon statistics from (all mailboxes on all databases, including recovery databases, on the specified server). You can use one of the following values to identify the server:

Fully qualified domain name (FQDN)
NetBIOS name

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

You can't use this parameter with the Database or Identity parameters.

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

Inputs

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.

Outputs

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

Share via