teamworkDevice リソースの種類

[アーティクル]
03/26/2023

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

テナント用にプロビジョニングされた Microsoft Teams 対応デバイスの詳細を表します。

Microsoft Teams 対応デバイスは、Teams 認定コラボレーションデバイスです。これには、Microsoft Teams Rooms (Windows および Android 上)、Microsoft Teams 電話、パネル、Surface Hubs、SIP デバイスが含まれます。これらのカテゴリは、[Teams デバイス] セクションの Teams 管理センターで使用できるカテゴリと同じです。

詳細については、「Microsoft Teams でデバイスを管理する」を参照してください。

注: 携帯電話、ノート PC、コンピューター、タブは含まれません。

エンティティから継承します。

メソッド

メソッド	戻り値の種類	説明
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	デバイスをテナントに登録したユーザーの ID。
createdDateTime	DateTimeOffset	デバイスがテナントに登録された UTC 日時。
currentUser	teamworkUserIdentity	デバイス上のサインインユーザー。
deviceType	teamworkDeviceType	デバイスの種類。使用できる値は、`unknown`、`ipPhone`、、`surfaceHubteamsRoom`、`collaborationBar`、`teamsDisplay`、 `touchConsoleunknownFutureValuelowCostPhoneteamsPanelsipsipAnalog`です。
hardwareDetail	teamworkHardwareDetail	ハードウェア関連のプロパティのコレクション。たとえば、 oemSerialNumber と model です。
healthStatus	teamworkDeviceHealthStatus	デバイスの正常性状態。使用可能な値: `unknown`、`offline`、`critical`、`nonUrgent`、`healthy`、`unknownFutureValue`。
id	String	デバイス識別子。エンティティから継承されます。
lastModifiedBy	identitySet	デバイスの詳細を最後に変更したユーザーの ID。
lastModifiedDateTime	DateTimeOffset	デバイスの詳細が最後に変更された UTC 日時。
notes	String	管理者がデバイスに追加したメモ。

teamworkDeviceType 値

メンバー	値	説明
不明	0	不明なデバイス。
ipPhone	1	IP Phone デバイスは、ユーザーが音声通話を発信したり、会議に参加したりするためのデスクフォンです。
teamsRoom	2	Microsoft Teams Roomsは、会議エクスペリエンスを会議室に拡張するように設計された Windows IoT ベースのデバイスです。
surfaceHub	3	Surface Hub デバイスは、対話型ホワイトボードを備えた壁取り付けデバイスまたはローラースタンドマウントデバイスです。
collaborationBar	4	コラボレーションバーは、小さな会議スペースに使用される Android でMicrosoft Teams Roomsされます。
teamsDisplay	5	Teams ディスプレイデバイスは、Teams 電話の進化です。これらのデバイスは、アンビエントタッチスクリーンと Cortana を利用したハンズフリーエクスペリエンスを備えた、オールインワンの専用 Teams デバイスのカテゴリです。
touchConsole	6	タッチコンソールデバイスは、すべてのデバイス操作を実行するために、Android 上のTeams Roomsのオプションの周辺機器です。
lowCostPhone	7	低コストの電話デバイスは、コスト効率の高い Microsoft Teams 電話です。
teamsPanel	8	Microsoft Teams パネルは、Teams 経由でスケジュールされた会議の詳細を表示するコンパクトなタッチスクリーンデバイスです。
sip	9	Microsoft からの SIP ゲートウェイを使用した Teams 呼び出しをサポートするセッション開始プロトコル (SIP) デバイス。
sipAnalog	10	SIP ゲートウェイを介して Microsoft Teams に登録されているエレベーターフォン、駐車場電話、工場のフロアデバイスなどのレガシアナログエンドポイント。
unknownFutureValue	11	進化可能な列挙センチネル値。使用しないでください。

teamworkDeviceHealthStatus 値

メンバー	値	説明
不明	0	不明な正常性状態。
オフライン	1	デバイスはオフラインであり、使用できません。
critical	2	状態では、デバイスのパフォーマンスに大きな影響を与えたり、通話や会議で使用できなくなったりする可能性があるため、緊急の注意と対処が必要です。
nonUrgent	3	状態は、オンラインデバイスのパフォーマンスに最小限の影響を与える可能性がある問題または通知が原因で注意が必要です。
健康	4	デバイスはオンラインで良好な状態です。
unknownFutureValue	5	進化可能な列挙センチネル値。使用しないでください。

リレーションシップ

リレーションシップ	型	説明
アクティビティ	teamworkDeviceActivity	デバイスの使用状況に基づいて変更されるアクティビティプロパティ。
configuration	teamworkDeviceConfiguration	デバイスの構成プロパティ。
健康	teamworkDeviceHealth	デバイスの正常性プロパティ。
操作	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"
}

次の方法で共有