teamworkDevice 资源类型

命名空间：microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

表示有关为租户预配的已启用 Microsoft Teams 的设备的详细信息。

已启用 Microsoft Teams 的设备是 Teams 认证的协作设备。 它们包括 Windows 和 Android) 、Microsoft Teams 电话、面板、Surface Hub 和 SIP 设备上的Microsoft Teams 会议室 (。 这些类别与 Teams 管理中心“ Teams 设备”部分下的可用类别相同。

有关详细信息，请参阅 在 Microsoft Teams 中管理设备。

注意：这不包括手机、笔记本电脑、计算机、选项卡等。

继承自 entity。

Methods

方法	返回类型	说明
列出 teamworkDevices	teamworkDevice 集合	获取为租户预配的所有已启用 Microsoft Teams 的设备的列表。
获取 teamworkDevice	teamworkDevice	获取已启用 Microsoft Teams 的设备的属性。
重新 启动	teamworkDeviceOperation	重启已启用 Microsoft Teams 的指定设备。
runDiagnostics	teamworkDeviceOperation	运行并生成已启用 Microsoft Teams 的指定设备的诊断日志。
updateSoftware	teamworkDeviceOperation	更新已启用 Microsoft Teams 的设备的软件。
列举操作	teamworkDeviceOperation 集合	获取在已启用 Teams 的设备上运行的操作的列表。

属性

属性	类型	说明
activityState	teamworkDeviceActivityState	设备的活动状态。 可能的值包括 unknown、busy、idle、unavailable、unknownFutureValue。
companyAssetTag	String	管理员在设备上分配的公司资产标记。
createdBy	identitySet	将设备注册到租户的用户的标识。
createdDateTime	DateTimeOffset	设备注册到租户的 UTC 日期和时间。
currentUser	teamworkUserIdentity	设备上的已登录用户。
deviceType	teamworkDeviceType	设备类型。 可能的值为：unknown、、teamsRoomipPhone、teamsDisplaylowCostPhonetouchConsolesurfaceHubcollaborationBarteamsPanel、sip、sipAnalog、 。 unknownFutureValue
hardwareDetail	teamworkHardwareDetail	硬件相关属性的集合。 例如 oemSerialNumber 和 model。
healthStatus	teamworkDeviceHealthStatus	设备的运行状况状态。 可能的值包括 unknown、offline、critical、nonUrgent、healthy、unknownFutureValue。
id	String	设备标识符。 继承自 entity。
lastModifiedBy	identitySet	上次修改设备详细信息的用户的标识。
lastModifiedDateTime	DateTimeOffset	上次修改设备详细信息的 UTC 日期和时间。
notes	String	管理员添加到设备的笔记。

teamworkDeviceType 值

成员	值	说明
unknown	0	未知设备。
ipPhone	1	IP 电话设备是供用户拨打和接听音频呼叫或加入会议的桌面电话。
teamsRoom	2	Microsoft Teams 会议室是基于 Windows IoT 的设备，旨在将会议体验扩展到会议室。
surfaceHub	3	Surface Hub 设备是壁装式或滚筒式安装式设备，带有交互式白板。
collaborationBar	4	协作栏在用于小型会议空间的 Android 上Microsoft Teams 会议室。
teamsDisplay	5	Teams 显示设备是 Teams 手机的演变。 这些设备是一种一体式专用 Teams 设备，具有环境触摸屏和由 Cortana 提供支持的免手动体验。
touchConsole	6	触摸控制台设备是 Android 上Teams 会议室的可选外围设备，用于执行所有设备操作。
lowCostPhone	7	低成本电话设备是经济高效的 Microsoft Teams 电话。
teamsPanel	8	Microsoft Teams 面板是显示通过 Teams 安排的会议详细信息的紧凑触摸屏设备。
sip	9	会话初始协议 (SIP) 支持使用 Microsoft SIP 网关进行 Teams 呼叫的设备。
sipAnalog	10	通过 SIP 网关注册到 Microsoft Teams 的旧式模拟终结点，例如电梯电话、停车场电话或工厂车间设备。
unknownFutureValue	11	可演变枚举 sentinel 值。 请勿使用。

teamworkDeviceHealthStatus 值

成员	值	说明
unknown	0	未知的运行状况状态。
离线	1	设备处于脱机状态，无法使用。
关键	2	状态需要紧急关注和操作，因为它可能会对设备的性能产生重大影响，或者使其在通话或会议中不可用。
nonUrgent	3	状态需要注意，因为问题或通知可能对联机设备的性能影响最小。
健康	4	设备处于联机状态且状态良好。
unknownFutureValue	5	可演变枚举 sentinel 值。 请勿使用。

关系

关系	类型	说明
活动	teamworkDeviceActivity	根据设备使用情况更改的活动属性。
configuration	teamworkDeviceConfiguration	设备的配置属性。
健康	teamworkDeviceHealth	设备的运行状况属性。
operations	teamworkDeviceOperation 集合	设备上的异步操作。

JSON 表示形式

以下 JSON 表示形式显示了资源类型。

{
  "@odata.type": "#microsoft.graph.teamworkDevice",
  "activityState": "String",
  "companyAssetTag": "String",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "createdDateTime": "String (timestamp)",
  "currentUser": {
    "@odata.type": "microsoft.graph.teamworkUserIdentity"
  },
  "deviceType": "String",
  "hardwareDetail": {
    "@odata.type": "microsoft.graph.teamworkHardwareDetail"
  },
  "healthStatus": "String",
  "id": "String (identifier)",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "notes": "String"
}