teamworkDevice-Ressourcentyp
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Stellt Details zu einem Microsoft Teams-fähigen Gerät dar, das für den Mandanten bereitgestellt wird.
Microsoft Teams-fähige Geräte sind Teams-zertifizierte Geräte für die Zusammenarbeit. Dazu gehören Microsoft Teams-Räume (unter Windows und Android), Microsoft Teams-Telefone, Panels, Surface Hubs und SIP-Geräte. Diese Kategorien sind identisch mit denen, die im Teams Admin Center im Abschnitt Teams-Geräte verfügbar sind.
Weitere Informationen finden Sie unter Verwalten Ihrer Geräte in Microsoft Teams.
Hinweis: Dies schließt keine Mobiltelefone, Laptops, Computer, Registerkarten usw. ein.
Erbt von entity.
Methoden
| Methode | Rückgabetyp | Beschreibung |
|---|---|---|
| TeamworkGeräte auflisten | Sammlung teamworkDevice | Rufen Sie eine Liste aller Für einen Mandanten bereitgestellten Microsoft Teams-fähigen Geräte ab. |
| Get teamworkDevice | teamworkDevice | Ruft die Eigenschaften eines Microsoft Teams-fähigen Geräts ab. |
| Neu starten | teamworkDeviceOperation | Starten Sie das angegebene Microsoft Teams-fähige Gerät neu. |
| runDiagnostics | teamworkDeviceOperation | Führen Sie Diagnoseprotokolle für das angegebene Microsoft Teams-fähige Gerät aus, und generieren Sie sie. |
| updateSoftware | teamworkDeviceOperation | Aktualisieren Sie die Software für ein Microsoft Teams-fähiges Gerät. |
| Vorgänge auflisten | teamworkDeviceOperation-Sammlung | Rufen Sie eine Liste der Vorgänge ab, die auf einem Teams-fähigen Gerät ausgeführt werden. |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| activityState | teamworkDeviceActivityState | Der Aktivitätsstatus des Geräts. Mögliche Werte sind: unknown, busy, idle, unavailable, unknownFutureValue. |
| companyAssetTag | String | Das vom Administrator auf dem Gerät zugewiesene Unternehmensobjekttag. |
| createdBy | identitySet | Identität des Benutzers, der das Gerät beim Mandanten registriert hat. |
| createdDateTime | DateTimeOffset | Das UTC-Datum und die Uhrzeit der Registrierung des Geräts beim Mandanten. |
| Currentuser | teamworkUserIdentity | Der angemeldete Benutzer auf dem Gerät. |
| deviceType | teamworkDeviceType | Der Gerätetyp. Die möglichen Werte sind: unknown, ipPhone, teamsRoom, surfaceHub, collaborationBar, , touchConsoleteamsDisplay, lowCostPhone, teamsPanel, sip, sipAnalog, . unknownFutureValue |
| hardwareDetail | teamworkHardwareDetail | Eine Auflistung hardwarebezogener Eigenschaften. Beispiel: oemSerialNumber und model. |
| healthStatus | teamworkDeviceHealthStatus | Die integritäts-status des Geräts. Mögliche Werte sind: unknown, offline, critical, nonUrgent, healthy, unknownFutureValue. |
| id | String | Gerätebezeichner. Geerbt von entity. |
| lastModifiedBy | identitySet | Identität des Benutzers, der die Gerätedetails zuletzt geändert hat. |
| lastModifiedDateTime | DateTimeOffset | Das UTC-Datum und die Uhrzeit der letzten Änderung des Gerätedetails. |
| notes | String | Die Notizen, die der Administrator dem Gerät hinzugefügt hat. |
teamworkDeviceType-Werte
| Element | Wert | Beschreibung |
|---|---|---|
| unknown | 0 | Unbekanntes Gerät. |
| ipPhone | 1 | IP-Telefongeräte sind die Schreibtischtelefone, mit denen Benutzer Audioanrufe tätigen und empfangen oder an Besprechungen teilnehmen können. |
| teamsRoom | 2 | Microsoft Teams-Räume sind Windows IoT-basierte Geräte, die entwickelt wurden, um die Besprechungserfahrung auf den Konferenzraum zu erweitern. |
| surfaceHub | 3 | Surface Hub-Geräte sind an der Wand montierte Oder Rollenständergeräte mit interaktivem Whiteboard. |
| collaborationBar | 4 | Zusammenarbeitsleisten werden unter Android Microsoft Teams-Räume, die für kleine Besprechungsräume verwendet werden. |
| teamsDisplay | 5 | Teams-Anzeigegeräte sind die Weiterentwicklung von Teams-Telefonen. Diese Geräte sind eine Kategorie von all-in-One-dedizierten Teams-Geräten, die über einen Umgebungs-Touchscreen und eine freihändige Benutzeroberfläche verfügen, die von Cortana unterstützt wird. |
| touchConsole | 6 | Touch-Konsolengeräte sind die optionalen Peripheriegeräte für die Teams-Räume unter Android, um alle Gerätevorgänge auszuführen. |
| lowCostPhone | 7 | Kostengünstige Telefongeräte sind kostengünstige Microsoft Teams-Telefone. |
| teamsPanel | 8 | Microsoft Teams-Bereiche sind die kompakten Touchscreengeräte, auf denen Besprechungsdetails angezeigt werden, die über Teams geplant sind. |
| sip | 9 | SIP-Geräte (Session Initiation Protocol), die Teams-Anrufe mit dem SIP-Gateway von Microsoft unterstützen. |
| sipAnalog | 10 | Ältere analoge Endpunkte wie Aufzugstelefone, Parkplatztelefone oder Geräte im Werksbereich, die über das SIP-Gateway bei Microsoft Teams registriert sind. |
| unknownFutureValue | 11 | Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden. |
teamworkDeviceHealthStatus-Werte
| Element | Wert | Beschreibung |
|---|---|---|
| unknown | 0 | Unbekannte status. |
| Offline | 1 | Das Gerät ist offline und kann nicht verwendet werden. |
| Kritisch | 2 | Der Zustand erfordert dringende Aufmerksamkeit und Maßnahmen, da er erhebliche Auswirkungen auf die Leistung des Geräts haben oder es für Anrufe oder Besprechungen unbrauchbar macht. |
| nonUrgent | 3 | Der Zustand erfordert Aufmerksamkeit aufgrund von Problemen oder Benachrichtigungen, die sich nur minimal auf die Leistung eines Onlinegeräts auswirken können. |
| Gesund | 4 | Das Gerät ist online und in gutem Zustand. |
| unknownFutureValue | 5 | Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden. |
Beziehungen
| Beziehung | Typ | Beschreibung |
|---|---|---|
| Aktivität | teamworkDeviceActivity | Die Aktivitätseigenschaften, die sich basierend auf der Gerätenutzung ändern. |
| Konfiguration | teamworkDeviceConfiguration | Die Konfigurationseigenschaften des Geräts. |
| Gesundheit | teamworkDeviceHealth | Die Integritätseigenschaften des Geräts. |
| operations | teamworkDeviceOperation-Sammlung | Die asynchronen Vorgänge auf dem Gerät. |
JSON-Darstellung
Die folgende JSON-Darstellung zeigt den Ressourcentyp.
{
"@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"
}