Export (0) Print
Expand All
0 out of 2 rated this helpful - Rate this topic

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 $true, the command sends the mailbox logs via e-mail to the administrator running the task. The default value of this parameter is $false.

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 $false, this parameter is ignored.

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 $true, the command returns the recovery password for the mobile phone as one of the displayed statistics.

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

 

 

Exceptions 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"
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.