Get-ActiveSyncDeviceStatistics
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 Get-ActiveSyncDeviceStatistics cmdlet 可以检索配置为与指定用户的邮箱同步的移动设备的列表,并能返回这些移动设备统计信息的列表。
注意:此 cmdlet 在 Exchange 2010 中效果最佳。 在 Exchange 或 Exchange Online的更高版本中,请改用 Get-MobileDeviceStatistics cmdlet。 如果有使用 Get-ActiveSyncDeviceStatistics 的脚本,请将其更新为使用 Get-MobileDeviceStatistics。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Get-ActiveSyncDeviceStatistics
[-Identity] <ActiveSyncDeviceIdParameter>
[-DomainController <Fqdn>]
[-GetMailboxLog]
[-NotificationEmailAddresses <MultiValuedProperty>]
[-ShowRecoveryPassword]
[<CommonParameters>]
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 中可用。
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-GetMailboxLog
GetMailboxLog 开关指定是否将移动设备统计信息发送到 NotificationEmailAddresses 参数指定的电子邮件地址。 不必为此开关指定值。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Identity
Identity 参数指定用户的设备 ID。 如果已指定 Mailbox 参数,则 Identity 参数将被禁用。
Type: | ActiveSyncDeviceIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Mailbox
Mailbox 参数指定要检索其移动电话统计信息的用户邮箱。 可以使用能够唯一标识邮箱的任意值。 例如:
- 名称
- 别名
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- 域\用户名
- 电子邮件地址
- GUID
- LegacyExchangeDN
- SamAccountName
- 用户 ID 或用户主体名称 (UPN)
Type: | MailboxIdParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-NotificationEmailAddresses
NotificationEmailAddresses 参数指定一个逗号分隔的电子邮件地址列表,用于在使用 GetMailboxLog 开关时接收移动设备统计信息。
仅当还在同一命令中使用 GetMailboxLog 开关时,此参数才有意义。
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-ShowRecoveryPassword
ShowRecoveryPassword 参数指定是否将移动电话的恢复密码作为显示的统计信息之一返回。 如果此参数设置为 $true,该命令会将移动电话的恢复密码作为显示的统计信息之一返回。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
输入
Input types
若要了解此 cmdlet 接受的输入类型,请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空,则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型(亦称为"输出类型"),请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空,则表明此 cmdlet 不返回任何数据。