命名空间：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"
}