Get-ActiveSyncDeviceClass
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 Get-ActiveSyncDeviceClass cmdlet 检索已连接到组织的 ActiveSync 设备列表。 此 cmdlet 将返回移动设备类型及型号信息。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
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 中可用。
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 |
-Filter
Filter 参数使用 OPATH 语法按指定的属性和值筛选结果。 搜索条件使用 语法 "Property -ComparisonOperator 'Value'"
。
- 将整个 OPATH 筛选器括在双引号“”中。 如果筛选器包含系统值 (,例如
$true
、$false
或$null
) ,请改用单引号 ' 。 虽然此参数是一个字符串 (不是) 的系统块,但也可以使用大括号 { },但前提是筛选器不包含变量。 - 属性是可筛选的属性。
- ComparisonOperator 是一个 OPATH 比较运算符, (例如
-eq
用于等于和-like
字符串比较) 。 有关比较运算符的详细信息,请参阅 about_Comparison_Operators。 - Value 是要搜索的属性值。 将文本值和变量括在单引号 (
'Value'
或'$Variable'
) 。 如果变量值包含单引号,则需要识别 (转义) 单引号才能正确展开变量。 例如,使用'$($User -Replace "'","''")'
而不是'$User'
。 不要将整数或系统值括在引号 (例如,改用500
、$true
、$false
或$null
) 。
可以使用逻辑运算符 -and
和 -or
将多个搜索条件链接在一起。 例如,"Criteria1 -and Criteria2"
或 "(Criteria1 -and Criteria2) -or Criteria3"
。
有关 Exchange 中的 OPATH 筛选器的详细信息,请参阅 其他 OPATH 语法信息。
可以按下列属性进行筛选:
- DeviceModel
- DeviceType
- LastUpdateTime
Type: | String |
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 参数指定要查看的 ActiveSync 设备类。 可以使用唯一标识 ActiveSync 设备类的任何值。 例如:
- 名称
- 可分辨名称 (DN)
- GUID
Type: | ActiveSyncDeviceClassIdParameter |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SortBy
SortBy 参数指定用作结果排序依据的属性。 每次只能按一个属性进行排序。 结果将按升序进行排序。
如果默认视图不包括要排序依据的属性,则可以使用 | Format-Table -Auto Property1,Property2,...PropertyX
追加命令。 创建包含要查看的所有属性的新视图。 支持在属性名称中使用通配符 (*)。
可以按下列属性排序:
- DeviceModel
- DeviceType
- LastUpdateTime
Type: | String |
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 不返回任何数据。