Get-ActiveSyncDeviceClass

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 某些参数和设置可能是一个环境或另一个环境独占。

使用 Get-ActiveSyncDeviceClass cmdlet 检索已连接到组织的 ActiveSync 设备列表。 此 cmdlet 将返回移动设备类型及型号信息。

有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。

语法

Default (默认值)

Get-ActiveSyncDeviceClass
    [[-Identity] <ActiveSyncDeviceClassIdParameter>]
    [-DomainController <Fqdn>]
    [-Filter <String>]
    [-SortBy <String>]
    [<CommonParameters>]

说明

您可以使用此 cmdlet 按类型查看移动电话或设备列表。 例如,可以返回组织中所有 Android 移动数字设备或组织中所有 Windows Phone 设备的列表。

您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果分配给你的权限中未包含某些参数,则可能无权访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Get-ActiveSyncDeviceClass -Filter "DeviceType -eq 'WP'"

本示例返回所有 Windows Phone 的列表。

示例 2

Get-ActiveSyncDeviceClass | group-object -Property DeviceType

本示例列出了组织内的所有设备类型和各个类型的设备数量。

参数

-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

-Filter

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

Filter 参数使用 OPATH 语法按指定的属性和值筛选结果。 搜索条件使用语法 "Property -ComparisonOperator 'Value'"。

  • 请用双引号“ ”括住整个 OPATH 筛选器。 如果筛选器包含系统值 (例如 $true、 或 $false$null) ,请改用单引号 ' '。 尽管此参数是字符串 (而不是系统块) ,但您也可以使用大括号 { },但前提是筛选器不包含变量。
  • 属性是可筛选的属性。
  • ComparisonOperator 是一个 OPATH 比较运算符 (例如 -eq ,对于等值和 -like 字符串比较) 。 有关比较运算符的详细信息,请参阅 about_Comparison_Operators。
  • 值是要搜索的属性值。 请将文本值和变量括在单引号 ('Value' 或 '$Variable') 中。 如果变量值包含单引号,则需要标识单引号 (转义) 正确展开变量。 例如, '$User'使用 '$($User -Replace "'","''")'. 而不是 。 不要将整数或系统值括在引号中,例如,使用 500、 $true ($false$null 或改为) 。

可以使用逻辑运算符 -and 和 -or将多个搜索条件链接在一起。 例如,"Criteria1 -and Criteria2" 或 "(Criteria1 -and Criteria2) -or Criteria3"。

有关 Exchange 中 OPATH 筛选器的详细信息,请参阅 其他 OPATH 语法信息。

可以按下列属性进行筛选:

  • DeviceModel
  • DeviceType
  • LastUpdateTime

参数属性

类型:String
默认值: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

标识参数指定要查看的 ActiveSync 设备类。 可以使用唯一标识 ActiveSync 设备类的任何值。 例如:

  • 名称
  • 可分辨名称 (DN)
  • GUID

注意: Identity 参数的值$null或不存在值将返回 所有 对象,就像您在没有 Identity 参数的情况下运行 Get- 命令一样。 验证 Identity 参数的任何值列表是否准确,且不包含不存在的$null值。

参数属性

类型:ActiveSyncDeviceClassIdParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:False
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-SortBy

适用:Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online

SortBy 参数指定用作结果排序依据的属性。 每次只能按一个属性进行排序。 结果将按升序进行排序。

如果默认视图不包括要充当排序依据的属性,可以在命令中 | Format-Table -Auto Property1,Property2,...PropertyX追加 。 创建包含要查看的所有属性的新视图。 支持在属性名称中使用通配符 (*)。

可以按下列属性排序:

  • DeviceModel
  • DeviceType
  • LastUpdateTime

参数属性

类型:String
默认值: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 不返回任何数据。