Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
Get-EXOMobileDeviceStatistics
- Module:
- Exchange PowerShell
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
Identity (Default)
Get-EXOMobileDeviceStatistics
[-Identity <String>]
[-ActiveSync]
[-ExternalDirectoryObjectId <Guid>]
[-GetMailboxLog]
[-NotificationEmailAddresses <String[]>]
[-OWAforDevices]
[-PrimarySmtpAddress <String>]
[-RestApi]
[-ShowRecoveryPassword]
[-UniversalOutlook]
[-UserPrincipalName <String>]
[<CommonParameters>]
MobileDeviceIdentity
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
Applicable: Exchange Online
The ActiveSync switch filters the results by Exchange ActiveSync devices. You don't need to specify a value with this switch.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ExternalDirectoryObjectId
Applicable: Exchange Online
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.
Parameter properties
| Type: | Guid |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-GetMailboxLog
Applicable: Exchange Online
This parameter is reserved for internal Microsoft use.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Identity
Applicable: Exchange Online
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.
Caution: The value $null or a non-existent value for the Identity parameter returns all objects as if you ran the Get- command without the Identity parameter. Verify any lists of values for the Identity parameter are accurate and don't contain non-existent $null values.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-Mailbox
Applicable: Exchange Online
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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-NotificationEmailAddresses
Applicable: Exchange Online
This parameter is reserved for internal Microsoft use.
Parameter properties
| Type: | String[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-OWAforDevices
Applicable: Exchange Online
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.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-PrimarySmtpAddress
Applicable: Exchange Online
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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-RestApi
Applicable: Exchange Online
The RestApi switch filters the results by REST API devices. You don't need to specify a value with this switch.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-ShowRecoveryPassword
Applicable: Exchange Online
This parameter is reserved for internal Microsoft use.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-UniversalOutlook
Applicable: Exchange Online
The UniversalOutlook switch filters the results by Mail and Calendar devices. You don't need to specify a value with this switch.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
-UserPrincipalName
Applicable: Exchange Online
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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Feedback
Was this page helpful?