Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Pour qu’une application disposant d’autorisations déléguées écrive des appareils d’espace de travail, l’utilisateur connecté doit être membre du rôle d’administrateur TenantPlacesManagement Exchange Online.
Dans le corps de la demande, fournissez une représentation JSON de l’objet workplaceSensorDevice .
Vous pouvez spécifier les propriétés suivantes lorsque vous créez un workplaceSensorDevice.
Propriété
Type
Description
description
Chaîne
Description de l’appareil. Optional.
deviceId
Chaîne
Identificateur unique défini par l’utilisateur de l’appareil fourni au moment de la création. Obligatoire.
displayName
Chaîne
Nom complet de l’appareil. Optional.
ipV4Address
Chaîne
Adresse IPv4 de l’appareil. Optional.
ipV6Address
Chaîne
Adresse IPv6 de l’appareil. Optional.
macAddress
Chaîne
Adresse MAC de l’appareil. Optional.
Fabricant
Chaîne
Fabricant de l’appareil. Obligatoire.
placeId
Chaîne
Identificateur unique de l’emplacement où se trouve l’appareil. Si l’appareil est installé dans une salle équipée d’une boîte aux lettres, cette propriété doit correspondre à l’Id d’objet ExternalDirectoryObjectId ou Microsoft Entra de la boîte aux lettres de salle. Optional.
Liste des capteurs associés à l’appareil qui collectent et signalent des données sur les conditions physiques ou environnementales, telles que l’occupation, le nombre de personnes, l’occupation déduite, la température, etc. Obligatoire.
étiquettes
String collection
Liste des balises personnalisées associées à l’appareil. Prend en charge $filter. Facultatif.
Réponse
Si elle réussit, cette méthode renvoie un 201 Created code de réponse et un objet workplaceSensorDevice dans le corps de la réponse.
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models;
var requestBody = new WorkplaceSensorDevice
{
DeviceId = "contoso_9D6816",
DisplayName = "Contoso 9D6816 Device",
Description = "Contoso 9D6816 Device",
MacAddress = "00:0A:95:9D:68:16",
Manufacturer = "Contoso",
IpV4Address = "192.168.1.100",
IpV6Address = "2001:db8::ff00:42:8329",
PlaceId = "acfa3bc0-2b83-425b-8910-84a0250e9671",
Tags = new List<string>
{
"Building A",
"Floor 3",
"Room 301",
"Conference Room",
},
Sensors = new List<WorkplaceSensor>
{
new WorkplaceSensor
{
SensorType = WorkplaceSensorType.Occupancy,
},
new WorkplaceSensor
{
SensorType = WorkplaceSensorType.PeopleCount,
},
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Workplace.SensorDevices.PostAsync(requestBody);
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
WorkplaceSensorDevice workplaceSensorDevice = new WorkplaceSensorDevice();
workplaceSensorDevice.setDeviceId("contoso_9D6816");
workplaceSensorDevice.setDisplayName("Contoso 9D6816 Device");
workplaceSensorDevice.setDescription("Contoso 9D6816 Device");
workplaceSensorDevice.setMacAddress("00:0A:95:9D:68:16");
workplaceSensorDevice.setManufacturer("Contoso");
workplaceSensorDevice.setIpV4Address("192.168.1.100");
workplaceSensorDevice.setIpV6Address("2001:db8::ff00:42:8329");
workplaceSensorDevice.setPlaceId("acfa3bc0-2b83-425b-8910-84a0250e9671");
LinkedList<String> tags = new LinkedList<String>();
tags.add("Building A");
tags.add("Floor 3");
tags.add("Room 301");
tags.add("Conference Room");
workplaceSensorDevice.setTags(tags);
LinkedList<WorkplaceSensor> sensors = new LinkedList<WorkplaceSensor>();
WorkplaceSensor workplaceSensor = new WorkplaceSensor();
workplaceSensor.setSensorType(WorkplaceSensorType.Occupancy);
sensors.add(workplaceSensor);
WorkplaceSensor workplaceSensor1 = new WorkplaceSensor();
workplaceSensor1.setSensorType(WorkplaceSensorType.PeopleCount);
sensors.add(workplaceSensor1);
workplaceSensorDevice.setSensors(sensors);
WorkplaceSensorDevice result = graphClient.workplace().sensorDevices().post(workplaceSensorDevice);