TeamworkDevice.ReadWrite.All
Allow the app to read and write the management data for Teams devices, without a signed-in user.
Permission Details
Read and write Teams devices
Allow the app to read and write the management data for Teams devices, without a signed-in user.
79c02f5b-bd4f-4713-bc2c-a8a4a66e127b
Read and write Teams devices
Allow the app to read and write the management data for Teams devices on behalf of the signed-in user.
ddd97ecb-5c31-43db-a235-0ee20e635c40
Properties
Properties is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.
| Property | Type | Description |
|---|---|---|
activityState |
teamworkDeviceActivityState |
The activity state of the device. The possible values are: unknown, busy, idle, unavailable, unknownFutureValue. |
companyAssetTag |
StringNullable |
The company asset tag assigned by the admin on the device. |
createdBy |
identitySet |
Identity of the user who enrolled the device to the tenant. |
createdDateTime |
DateTimeOffsetNullable |
The UTC date and time when the device was enrolled to the tenant. |
currentUser |
teamworkUserIdentity |
The signed-in user on the device. |
deviceType |
teamworkDeviceType |
The type of device. The possible values are: unknown, ipPhone, teamsRoom, surfaceHub, collaborationBar, teamsDisplay, touchConsole, lowCostPhone, teamsPanel, sip, sipAnalog, unknownFutureValue. |
hardwareDetail |
teamworkHardwareDetail |
A collection of hardware-related properties. For example, oemSerialNumber and model. |
healthStatus |
teamworkDeviceHealthStatus |
The health status of the device. The possible values are: unknown, offline, critical, nonUrgent, healthy, unknownFutureValue. |
id |
String |
Device identifier. Inherited from entity. |
lastModifiedBy |
identitySet |
Identity of the user who last modified the device details. |
lastModifiedDateTime |
DateTimeOffsetNullable |
The UTC date and time when the device detail was last modified. |
notes |
StringNullable |
The notes added by the admin to the device. |
activity |
object |
The activity properties that change based on the device usage. |
configuration |
object |
The configuration properties of the device. |
health |
object |
The health properties of the device. |
Showing 15 of 16 properties.
JSON Representation
JSON representation is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.
{
"@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"
}Relationships
Relationships is shown from beta metadata because a stable v1.0 schema is not available for this resource mapping.
| Relationship | Type | Description |
|---|---|---|
activity |
teamworkDeviceActivity |
The activity properties that change based on the device usage. |
configuration |
teamworkDeviceConfiguration |
The configuration properties of the device. |
health |
teamworkDeviceHealth |
The health properties of the device. |
operations |
teamworkDeviceOperation collection |
The async operations on the device. |
deviceType |
teamworkDeviceType |
Related deviceType data exposed by this resource. |
hardwareDetail |
teamworkHardwareDetail |
Related hardwareDetail data exposed by this resource. |
Graph Methods
Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
No API methods available for this version.
Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.
Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
No deterministic PowerShell command map is available for this permission.
Browse PowerShell docsMicrosoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.
Code Examples
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Teamwork.Devices["{teamworkDevice-id}"].Restart.PostAsync();const options = {
authProvider,
};
const client = Client.init(options);
await client.api('/teamwork/devices/0f3ce432-e432-0f3c-32e4-3c0f32e43c0f/restart')
.version('beta')
.post();Import-Module Microsoft.Graph.Beta.Teams
Restart-MgBetaTeamworkDevice -TeamworkDeviceId $teamworkDeviceId# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
await graph_client.teamwork.devices.by_teamwork_device_id('teamworkDevice-id').restart.post()App Registration
Navigate to Azure Portal
Go to App registrations in Microsoft Entra admin center
Add API Permission
Select your app → API permissions → Add a permission → Microsoft Graph
Select Permission Type
Choose Application permissions or delegated permissions and search for TeamworkDevice.ReadWrite.All
Grant Admin Consent
Application permissions always require admin consent.