Get-MobileDevice

模块:: ExchangePowerShell

适用于:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

此 cmdlet 可在本地 Exchange 和基于云的服务中使用。一些参数和设置可能只适用于某个特定的环境。

使用 Get-MobileDevice cmdlet 获取组织中具有有效合作关系的设备列表。

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

语法

Get-MobileDevice
   -Mailbox <MailboxIdParameter>
   [-ActiveSync]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-Monitoring]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-OWAforDevices]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [-RestApi]
   [-UniversalOutlook]
   [<CommonParameters>]

Get-MobileDevice
   [[-Identity] <MobileDeviceIdParameter>]
   [-ActiveSync]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-Monitoring]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-OWAforDevices]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [-RestApi]
   [-UniversalOutlook]
   [<CommonParameters>]

说明

Get-MobileDevice cmdlet 返回每个移动设备的标识、配置和状态信息。

您必须先获得权限，然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Get-MobileDevice -Mailbox "Tony Smith"

此示例返回 Tony Smith 使用的所有与其邮箱关联的移动设备。

示例 2

Get-MobileDevice -ResultSize unlimited | Format-Table -Auto DeviceModel,Identity

此示例返回组织中所有移动设备的摘要列表。

示例 3

Get-MobileDevice -Identity Lila\ExchangeActiveSyncDevices\REST§Outlook§5eec4e941e0748a264512fd83770d5ac | Format-List

此示例返回有关 Lila 邮箱上指定设备的详细信息。

参数

-ActiveSync

ActiveSync 开关按Exchange ActiveSync设备筛选结果。不必为此开关指定值。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DomainController

此参数只在本地 Exchange 中可用。

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。可以使用完全限定的域名 (FQDN) 来标识域控制器。例如，dc01.contoso.com。

类型:	Fqdn
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-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 语法信息。

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

ClientType
DeviceAccessControlRule
DeviceAccessState
DeviceAccessStateReason
DeviceActiveSyncVersion
DeviceId
DeviceImei
DeviceMobileOperator
DeviceModel
DeviceOS
DeviceOSLanguage
DeviceTelephoneNumber
DeviceType
DeviceUserAgent
FirstSyncTime
FriendlyName
ProvisioningFlags
UserDisplayName

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Identity

Identity 参数指定要查看的移动设备。可以使用以下唯一标识移动设备的值：

标识 (<Mailbox Name>\ExchangeActiveSyncDevices\<MobileDeviceObjectName> 例如， CarlosM\ExchangeActiveSyncDevices\REST§Outlook§5eec4e941e0748a264512fd83770d5ac)
可分辨名称 (DN)
GUID (与 ExchangeObjectId) 相同

类型:	MobileDeviceIdParameter
Position:	1
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-Mailbox

Mailbox 参数按邮箱筛选结果。可以使用能够唯一标识邮箱的任意值。例如：

名称
别名
可分辨名称 (DN)
可分辨名称 (DN)
域\用户名
电子邮件地址
GUID
LegacyExchangeDN
SamAccountName
用户 ID 或用户主体名称 (UPN)

数据库名称

类型:	MailboxIdParameter
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-Monitoring

此参数只在本地 Exchange 中可用。

需要“监视”开关才能返回结果中的监视邮箱。不必为此开关指定值。

监视邮箱与托管可用性和 Exchange Health Manager 服务相关联，并且具有 MonitoringMailbox 的 RecipientTypeDetails 属性值。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OrganizationalUnit

OrganizationUnit 参数根据对象在 Active Directory 中的位置筛选结果。只返回存在于指定位置的对象。此参数的有效输入是由 Get-OrganizationalUnit cmdlet 返回的组织单位 (OU) 或域。可以使用任何能够唯一标识此 OU 或域的值。例如：

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

类型:	OrganizationalUnitIdParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OWAforDevices

OWAforDevices 开关根据是否为设备启用设备Outlook 网页版来筛选结果。不必为此开关指定值。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RestApi

RestApi 开关按 REST API 设备筛选结果。不必为此开关指定值。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResultSize

ResultSize 参数指定了要返回的结果的最大数量。若要返回所有与查询相匹配的请求，则请将此参数的值设为无限制。默认值为 1000。

类型:	Unlimited
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SortBy

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

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

可以按下列属性排序：

DeviceAccessControlRule
DeviceAccessState
DeviceAccessStateReason
DeviceId
DeviceImei
DeviceMobileOperator
DeviceModel
DeviceOS
DeviceOSLanguage
DeviceTelephoneNumber
DeviceType
DeviceUserAgent
FirstSyncTime
FriendlyName
UserDisplayName

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UniversalOutlook

UniversalOutlook 开关按邮件和日历设备筛选结果。不必为此开关指定值。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

Input types

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。