Get-EXOMobileDeviceStatistics

Module:

ExchangePowerShell

Applies to:

Exchange Online

This cmdlet is available only in the Exchange Online PowerShell module. For more information, see About the Exchange Online PowerShell module.

Use the Get-EXOMobileDeviceStatistics cmdlet to retrieve the list of mobile devices configured to synchronize with a specified user's mailbox and return a list of statistics about the mobile devices.

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

Syntax

Get-EXOMobileDeviceStatistics
   [-Identity <String>]
   [-ActiveSync]
   [-ExternalDirectoryObjectId <Guid>]
   [-GetMailboxLog]
   [-NotificationEmailAddresses <String[]>]
   [-OWAforDevices]
   [-PrimarySmtpAddress <String>]
   [-RestApi]
   [-ShowRecoveryPassword]
   [-UniversalOutlook]
   [-UserPrincipalName <String>]
   [<CommonParameters>]

Get-EXOMobileDeviceStatistics
   [-Mailbox <String>]
   [-ActiveSync]
   [-GetMailboxLog]
   [-NotificationEmailAddresses <String[]>]
   [-OWAforDevices]
   [-RestApi]
   [-ShowRecoveryPassword]
   [-UniversalOutlook]
   [<CommonParameters>]

Description

This cmdlet returns a list of statistics about each mobile device. Additionally, it allows you to retrieve logs and send those logs to a recipient for troubleshooting purposes.

Examples

Example 1

Get-EXOMobileDeviceStatistics -Mailbox john.doe@contoso.com

This example returns the statistics of all devices linked to user with email john.doe@contoso.com

Example 2

Get-EXOMobileDeviceStatistics -Mailbox john.doe@contoso.com -ActiveSync

This example returns the statistics for active sync devices linked to user with email john.doe@contoso.com

Parameters

-ActiveSync

The ActiveSync switch filters the results by Exchange ActiveSync devices. You don't need to specify a value with this switch.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ExternalDirectoryObjectId

The ExternalDirectoryObjectId parameter identifies the mailbox that you want to view by the ObjectId in Microsoft Entra ID.

You can't use this parameter with the Identity, PrimarySmtpAddress, or UserPrincipalName parameters.

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online

-GetMailboxLog

This parameter is reserved for internal Microsoft use.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Identity

The Identity parameter specifies the mobile device that you want to view. You can use any value that uniquely identifies the mobile device. For example:

• GUID
• DeviceID

You can't use this parameter with the ExternalDirectoryObjectId, Mailbox, PrimarySmtpAddress, or UserPrincipalName parameters.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online

-Mailbox

The Mailbox parameter filters the results by the user mailbox that's associated with the mobile device. You can use any value that uniquely identifies the mailbox. For example:

• GUID
• User ID or user principal name (UPN)

You can't use this parameter with the Identity, PrimarySmtpAddress, or UserPrincipalName parameters.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online

-NotificationEmailAddresses

This parameter is reserved for internal Microsoft use.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-OWAforDevices

The OWAforDevices switch filters the results by devices where Outlook on the web for devices is enabled. You don't need to specify a value with this switch.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-PrimarySmtpAddress

The PrimarySmtpAddress identifies the mailbox that you want to view by primary SMTP email address (for example, navin@contoso.com).

You can't use this parameter with the ExternalDirectoryObjectId, Identity, or UserPrincipalName parameters.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online

-RestApi

The RestApi switch filters the results by REST API devices. You don't need to specify a value with this switch.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ShowRecoveryPassword

This parameter is reserved for internal Microsoft use.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-UniversalOutlook

The UniversalOutlook switch filters the results by Mail and Calendar devices. You don't need to specify a value with this switch.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-UserPrincipalName

The UserPrincipalName parameter identifies the mailbox that you want to view by UPN (for example, navin@contoso.onmicrosoft.com).

You can't use this parameter with the ExternalDirectoryObjectId, Mailbox, Identity, or PrimarySmtpAddress parameters.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online