teamworkDevice リソースの種類
名前空間: 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"
}
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示