.png)
Get-ActiveSyncDeviceStatistics
Applies to: Exchange Server 2010
Topic Last Modified: 2011-03-19
Use the Get-ActiveSyncDeviceStatistics cmdlet to retrieve the list of mobile phones configured to synchronize with a specified user's mailbox and return a list of statistics about the mobile phones.
Get-ActiveSyncDeviceStatistics -Identity <ActiveSyncDeviceIdParameter> [-DomainController <Fqdn>] [-GetMailboxLog <SwitchParameter>] [-NotificationEmailAddresses <MultiValuedProperty>] [-ShowRecoveryPassword <SwitchParameter>]
Get-ActiveSyncDeviceStatistics -Mailbox <MailboxIdParameter> [-DomainController <Fqdn>] [-GetMailboxLog <SwitchParameter>] [-NotificationEmailAddresses <MultiValuedProperty>] [-ShowRecoveryPassword <SwitchParameter>]
| Parameter | Required | Type | Description |
|---|---|---|---|
|
Identity |
Required |
Microsoft.Exchange.Configuration.Tasks.ActiveSyncDeviceIdParameter |
The Identity parameter specifies the user's device ID. If the Mailbox parameter is specified, the Identity parameter is disabled. |
|
Mailbox |
Required |
Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter |
The Mailbox parameter specifies the user mailbox for which you want to retrieve the mobile phone statistics. |
|
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. |
|
GetMailboxLog |
Optional |
System.Management.Automation.SwitchParameter |
The GetMailboxLog parameter specifies whether to send the mailbox logs via e-mail to the administrator running the task. If the parameter is set to |
|
NotificationEmailAddresses |
Optional |
Microsoft.Exchange.Data.MultiValuedProperty |
The NotificationEmailAddresses parameter specifies an optional list of comma-separated aliases or e-mail addresses where the mailbox logs are sent. If the GetMailboxLog parameter is set to |
|
ShowRecoveryPassword |
Optional |
System.Management.Automation.SwitchParameter |
The ShowRecoveryPassword parameter specifies whether to return the recovery password for the mobile phone as one of the displayed statistics. If this parameter is set to |
The Get-ActiveSyncDeviceStatistics cmdlet returns a list of statistics about each mobile phone. Additionally, it allows you to retrieve logs and send those logs to a recipient for troubleshooting purposes.
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 "Exchange ActiveSync user settings" entry in the Client Access Permissions topic.
| Parameter | Description |
|---|---|
|
FirstSyncTime |
The date on which the mobile phone first synchronized with the user's mailbox. |
|
LastPingHeartbeat |
The length of the last heartbeat interval. |
|
LastPolicyUpdateTime |
The time at which the mobile phone was last successfully updated. |
|
LastPolicyUpdateRequestTime |
The last time the mobile phone requested a policy update from the server. |
|
LastSyncAttemptTime |
The last time the mobile phone tried to synchronize with the user's mailbox. |
|
LastSuccessSync |
The last time the mobile phone successfully synchronized with the user's mailbox. |
|
LastSyncResponseStatus |
The last status code sent to the mobile phone during the most recent synchronization. |
|
DeviceFriendlyName |
The display name of the partnership configured on the mobile phone. After the display name is configured, the mobile phone stores this name in the user's mailbox. |
|
DeviceId |
The string ID of the mobile phone stored in the user's mailbox. |
|
DeviceModel |
The model of the mobile phone. This information is stored in the user's mailbox. |
|
DeviceOperatorNetwork |
The mobile operator being used by the mobile phone. The mobile phone stores this information in the user's mailbox. |
|
DeviceOSAgent |
The client operating system running on the mobile phone. The mobile phone stores this information in the user's mailbox. |
|
DeviceOSLanguage |
The language of the operating system on the mobile phone. |
|
LastPingHeartbeat |
The length of time that has elapsed since the last response from the mobile phone, also known as a heartbeat, was received. |
|
DeviceWipeSentTime |
The time at which the last device wipe command was sent from the server. |
|
DeviceWipeRequestTime |
The time at which the RemoteWipe setting was enabled on the mobile phone. |
|
DeviceWipeAckTime |
The time at which the server received the last wipe acknowledgement sent by the client. |
|
RecoveryPassword |
The recovery password for the mobile phone. |
| Error | Description |
|---|---|
|
|
|
This example retrieves the statistics for the mobile phone configured to synchronize with the mailbox that belongs to the user Tony Smith.
Get-ActiveSyncDeviceStatistics -Identity TonySmith
This example uses the Get-CASMailbox cmdlet to determine who in the organization has a Microsoft Exchange ActiveSync device. For each device, the Exchange ActiveSync device statistics are retrieved.
Get-CASMailbox -Filter {hasactivesyncdevicepartnership -eq $true -and -not displayname -like "CAS_{*"} | Get-Mailbox | foreach { Get-ActiveSyncDeviceStatistics -Mailbox $_}
This example retrieves the statistics for the mobile phone configured to synchronize with the mailbox that belongs to the user Tony Smith. It also outputs the Exchange ActiveSync log file and sends it to the System Administrator at admin@contoso.com.
Get-ActiveSyncDeviceStatistics -Mailbox TonySmith -GetMailboxLog $true -NotificationEmailAddresses "admin@contoso.com"
