你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Get-MsolDevice
获取单个设备或设备列表。
语法
Get-MsolDevice
-Name <String>
[<CommonParameters>] Get-MsolDevice
[-All]
[-ReturnRegisteredOwners]
[<CommonParameters>] Get-MsolDevice
-DeviceId <Guid>
[<CommonParameters>] Get-MsolDevice
-All
-LogonTimeBefore <DateTime>
[<CommonParameters>] Get-MsolDevice
-ObjectId <Guid>
[<CommonParameters>] Get-MsolDevice
-RegisteredOwnerUpn <String>
[<CommonParameters>] Get-MsolDevice
-All
-IncludeSystemManagedDevices
[<CommonParameters>] 说明
Get-MsolDevice cmdlet 获取单个设备或设备列表。
示例
示例 1：获取设备对象
PS C:\>Get-MsolDevice -Name "NIC0123"此命令获取名为 NIC0123的设备对象。
示例 2：获取设备对象列表
PS C:\>Get-MsolDevice -All此命令获取设备对象的列表。 由于未使用 ReturnRegisteredOwners 参数，因此设备对象不包含 registeredOwners 属性。
示例 3：获取包含 registeredOwners 属性的设备对象列表
PS C:\>Get-MsolDevice -All -ReturnRegisteredOwners此命令获取设备对象的列表。 由于使用了 ReturnRegisteredOwners 参数，因此设备对象包含 registeredOwners 属性。
示例 4：按设备 ID 获取设备
PS C:\>Get-MsolDevice -DeviceId "1aa200c4-bdfb-42b5-9a1e-5f1bafbe4274"此命令获取具有相应设备 ID 的设备。
示例 5：按对象 ID 获取设备对象
PS C:\>Get-MsolDevice -ObjectId "566F7EA7-7BF1-4F4A-AF23-A1B46DBD46D6"此命令获取具有相应对象 ID 的设备。
示例 6：获取 UPN 注册的设备
PS C:\>Get-MsolDevice -RegisteredOwnerUpn "pattifuller@contoso.com"此命令获取用户使用名为 pattifuller@contoso.com的 UPN 注册的所有设备。
示例 7：按活动 (登录) 时间戳获取设备
PS C:\>Get-MsolDevice -All -LogonTimeBefore 'January 1, 2017 12:00:00 AM'Ths 命令获取 2017 年 1 月 1 日之前具有 ApproximateLastLogonTimestamp 的所有设备
示例 8：获取设备并包括系统托管设备
PS C:\>Get-MsolDevice -All -IncludeSystemManagedDevices此命令获取所有设备，包括自动试点设备和与 Intune (使用的其他设备，例如 EAS)
参数
-All
指示此 cmdlet 返回所有结果。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-DeviceId
指定此 cmdlet 获取的设备的设备 ID。
| 类型: | Guid |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-IncludeSystemManagedDevices
指示此 cmdlet 包括由系统管理的设备，例如自动试点。
| 类型: | SwitchParamater |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-LogonTimeBefore
指定用于筛选设备列表的日期 (UTC) 。
| 类型: | DateTime |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-Name
指定此 cmdlet 获取的设备显示名称。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-ObjectId
指定此 cmdlet 获取的设备的唯一对象 ID。
| 类型: | Guid |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-RegisteredOwnerUpn
指定用户对象，该用户对象是设备的注册所有者。 你需要 (UPN) 或 ObjectId 提供用户主体名称，或者传递包含用户的 UPN 或 ObjectId 的 Microsoft.Online.Administration.User 对象的实例。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | True |
| 接受通配符: | False |
-ReturnRegisteredOwners
指示此 cmdlet 返回设备的 registeredOwners 属性。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输出
Microsoft.Online.Administration.Device
此 cmdlet 返回设备对象，其中包括以下信息：
- AccountEnabled：设备的状态：启用或禁用。
- ObjectId：设备的唯一 ID。
- DeviceId：设备的设备 ID。
- DisplayName：设备的显示名称。
- DeviceObjectVersion：设备的对象版本号。
- DeviceOSType：设备操作系统类型。
- DeviceOSVersion：设备操作系统版本号。
- DeviceTrustType：设备信任类型。 该值可以是以下值之一：Workplace Joined、AzureAD Joined、Domain Joined。
- DeviceTrustLevel：设备信任级别。 该值可以是以下值之一：身份验证、符合、托管。
- DevicePhysicalIds：设备物理 ID。
- ApproximateLastLogonTimestamp：使用此设备的最后一个登录时间戳。
- AlternativeSecurityIds：设备备用安全 ID。
- DirSyncEnabled：如果设备已启用 DirSync。
- LastDirSyncTime：DirSync 同步设备的最后一个时间戳。
- RegisteredOwners：设备的注册所有者。
- GraphDeviceObject：从图形 API 返回的设备对象。