Get-ActiveSyncDeviceStatistics
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 某些参数和设置可能只属于一个环境或另一个环境。
使用 Get-ActiveSyncDeviceStatistics cmdlet 可以检索配置为与指定用户的邮箱同步的移动设备的列表，并能返回这些移动设备统计信息的列表。
注意：此 cmdlet 在 Exchange 2010 中效果最佳。 在 Exchange 或 Exchange Online的更高版本中，请改用 Get-MobileDeviceStatistics cmdlet。 如果有使用 Get-ActiveSyncDeviceStatistics 的脚本，请将其更新为使用 Get-MobileDeviceStatistics。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Identity
Get-ActiveSyncDeviceStatistics
[-Identity] <ActiveSyncDeviceIdParameter>
[-DomainController <Fqdn>]
[-GetMailboxLog]
[-NotificationEmailAddresses <MultiValuedProperty>]
[-ShowRecoveryPassword]
[<CommonParameters>]
Mailbox
Get-ActiveSyncDeviceStatistics
-Mailbox <MailboxIdParameter>
[-DomainController <Fqdn>]
[-GetMailboxLog]
[-NotificationEmailAddresses <MultiValuedProperty>]
[-ShowRecoveryPassword]
[<CommonParameters>]
说明
Get-ActiveSyncDeviceStatistics cmdlet 返回每个移动设备统计信息的列表。 此外，该命令还可以检索日志并将这些日志发送给收件人以方便排除故障。
您必须先获得权限，然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数，但如果某些参数未包含在分配给你的权限中，则可能无法访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Get-ActiveSyncDeviceStatistics -Mailbox TonySmith
此示例检索配置为与用户 Tony Smith 的邮箱同步的移动电话的统计信息。
示例 2
$UserList = Get-CASMailbox -Filter "HasActiveSyncDevicePartnership -eq `$true -and -not DisplayName -like 'CAS_{*'"
Get-Mailbox $UserList | foreach {Get-ActiveSyncDeviceStatistics -Mailbox $_}
此示例使用 Get-CASMailbox cmdlet 来确定组织中谁拥有Exchange ActiveSync移动设备。 对于每个移动设备，将检索Exchange ActiveSync设备统计信息。
注意：有关 OPATH 筛选器语法的详细信息，请参阅 其他 OPATH 语法信息。
示例 3
Get-ActiveSyncDeviceStatistics -Mailbox TonySmith -GetMailboxLog -NotificationEmailAddresses "admin@contoso.com"
此示例检索配置为与用户 Tony Smith 的邮箱同步的移动电话的统计信息。 它还输出Exchange ActiveSync日志文件，并将其发送到 中的admin@contoso.com系统管理员。
参数
-DomainController
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
此参数只在本地 Exchange 中可用。
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。
参数属性
| 类型: | Fqdn |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-GetMailboxLog
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
GetMailboxLog 开关指定是否将移动设备统计信息发送到 NotificationEmailAddresses 参数指定的电子邮件地址。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Identity
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Identity 参数指定用户的设备 ID。 如果已指定 Mailbox 参数，则 Identity 参数将被禁用。
参数属性
| 类型: | ActiveSyncDeviceIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Identity
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Mailbox
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Mailbox 参数指定要检索其移动电话统计信息的用户邮箱。 可以使用能够唯一标识邮箱的任意值。 例如：
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
参数属性
| 类型: | MailboxIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Mailbox
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-NotificationEmailAddresses
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
NotificationEmailAddresses 参数指定一个逗号分隔的电子邮件地址列表，用于在使用 GetMailboxLog 开关时接收移动设备统计信息。
仅当还在同一命令中使用 GetMailboxLog 开关时，此参数才有意义。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ShowRecoveryPassword
适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ShowRecoveryPassword 参数指定是否将移动电话的恢复密码作为显示的统计信息之一返回。 如果此参数设置为 $true，该命令会将移动电话的恢复密码作为显示的统计信息之一返回。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。