你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Get-MsolDevice

  • 参考
模块:
MSOnline

获取单个设备或设备列表。

语法

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.comUPN。

示例 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 返回所有结果。

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DeviceId

指定此 cmdlet 获取的设备的设备 ID。

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-IncludeSystemManagedDevices

指示此 cmdlet 包括由系统管理的设备，例如自动试点。

Type:SwitchParamater
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-LogonTimeBefore

指定用于筛选设备列表的 UTC) 日期 (。

Type:DateTime
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

指定此 cmdlet 获取的设备的显示名称。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ObjectId

指定此 cmdlet 获取的设备的唯一对象 ID。

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RegisteredOwnerUpn

指定设备注册所有者的用户对象。 需要 (UPN) 或 ObjectId 提供用户主体名称，或者传递包含用户的 UPN 或 ObjectId 的 Microsoft.Online.Administration.User 对象的实例。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ReturnRegisteredOwners

指示此 cmdlet 返回设备的 registeredOwners 属性。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 返回的设备对象。