Mettre à jour un appareil

Article
04/05/2024

Espace de noms: microsoft.graph

Mettre à jour les propriétés d’un périphérique enregistré.

Seules certaines propriétés d’un appareil peuvent être mises à jour via les applications approuvées de gestion des périphériques mobiles (GPM).

Cette API est disponible dans les déploiements de cloud national suivants.

Service global	Gouvernement des États-Unis L4	Us Government L5 (DOD)	Chine gérée par 21Vianet
✅	✅	✅	✅

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation	Autorisations avec privilèges minimum	Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire)	Directory.AccessAsUser.All	Non disponible.
Déléguée (compte Microsoft personnel)	Non prise en charge.	Non prise en charge.
Application	Device.ReadWrite.All	Directory.ReadWrite.All

Dans les scénarios d’application uniquement et pour les appareils non Windows, autrement dit, où la propriété operatingSystem n’est pas Windows, l’application peut mettre à jour uniquement la propriété extensionAttributes .

L’utilisateur appelant doit également avoir l’un des rôles Microsoft Entra suivants : administrateur Intune. Un utilisateur appelant dans le rôle Administrateur d’appareil cloud peut uniquement activer ou désactiver des appareils à l’aide de cette API, et un utilisateur disposant du rôle Administrateur Windows 365 peut uniquement mettre à jour les propriétés de base de l’appareil. Un administrateur général dispose de privilèges de gestion complets sur l’appareil.

Requête HTTP

Vous pouvez traiter l’appareil à l’aide de son id ou de son id deviceId.

PATCH /devices/{id}
PATCH /devices(deviceId='{deviceId}')

En-têtes de demande

Nom	Type	Description
Autorisation	string	Porteur {token}. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez les valeurs de la propriété device qui doivent être mises à jour. Les propriétés existantes qui ne sont pas incluses dans le corps de la demande conserveront leurs valeurs précédentes ou seront recalculées en fonction des modifications apportées à d’autres valeurs des propriétés. Pour de meilleures performances, n’incluez pas de valeurs existantes qui n’ont pas changé.

Propriété	Type	Description
accountEnabled	Boolean	`true` si le compte est activé ; sinon, `false`. Seuls les appelants dans les rôles Administrateur général et Administrateur d’appareil cloud peuvent mettre à jour cette propriété.
operatingSystem	Chaîne	Type de système d’exploitation sur l’appareil.
operatingSystemVersion	Chaîne	Version du système d’exploitation sur l’appareil
displayName	String	Nom d’affichage de l’appareil.
isCompliant	Valeur booléenne	`true`si l’appareil est conforme aux stratégies Gestion des appareils mobiles (MDM) ; sinon, `false`. Il ne peut être mis à jour que par Intune pour n’importe quel type de système d’exploitation d’appareil ou par une application MDM approuvée pour les appareils de système d’exploitation Windows.
isManaged	Valeur booléenne	`true`si l’appareil est géré par une application mobile Gestion des appareils (MDM) ; sinon, `false`. Il ne peut être mis à jour que par Intune pour n’importe quel type de système d’exploitation d’appareil ou par une application MDM approuvée pour les appareils de système d’exploitation Windows.

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 204 No Content.

Exemples

Exemple 1 : Mettre à jour la propriété accountEnabled d’un appareil

Demande

PATCH https://graph.microsoft.com/v1.0/devices/7c06cd31-7c30-4f3b-a5c3-444cd8dd63ac
Content-type: application/json

{
  "accountEnabled": false
}


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new Device
{
	AccountEnabled = false,
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Devices["{device-id}"].PatchAsync(requestBody);


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc devices patch --device-id {device-id} --body '{\
  "accountEnabled": false\
}\
'



import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)


requestBody := graphmodels.NewDevice()
accountEnabled := false
requestBody.SetAccountEnabled(&accountEnabled) 

devices, err := graphClient.Devices().ByDeviceId("device-id").Patch(context.Background(), requestBody, nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

Device device = new Device();
device.setAccountEnabled(false);
Device result = graphClient.devices().byDeviceId("{device-id}").patch(device);


const options = {
	authProvider,
};

const client = Client.init(options);

const device = {
  accountEnabled: false
};

await client.api('/devices/7c06cd31-7c30-4f3b-a5c3-444cd8dd63ac')
	.update(device);


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\Device;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new Device();
$requestBody->setAccountEnabled(false);

$result = $graphServiceClient->devices()->byDeviceId('device-id')->patch($requestBody)->wait();


Import-Module Microsoft.Graph.Identity.DirectoryManagement

$params = @{
	accountEnabled = $false
}

Update-MgDevice -DeviceId $deviceId -BodyParameter $params


from msgraph import GraphServiceClient
from msgraph.generated.models.device import Device

graph_client = GraphServiceClient(credentials, scopes)

request_body = Device(
	account_enabled = False,
)

result = await graph_client.devices.by_device_id('device-id').patch(request_body)

Réponse

HTTP/1.1 204 No Content

Exemple 2 : Écrire des extensionsAttributes sur un appareil

Demande

PATCH https://graph.microsoft.com/v1.0/devices/7c06cd31-7c30-4f3b-a5c3-444cd8dd63ac
Content-type: application/json

{
    "extensionAttributes": {
        "extensionAttribute1": "BYOD-Device"
    }
}


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new Device
{
	AdditionalData = new Dictionary<string, object>
	{
		{
			"extensionAttributes" , new 
			{
				ExtensionAttribute1 = "BYOD-Device",
			}
		},
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Devices["{device-id}"].PatchAsync(requestBody);


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc devices patch --device-id {device-id} --body '{\
    "extensionAttributes": {\
        "extensionAttribute1": "BYOD-Device"\
    }\
}\
'



import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)


requestBody := graphmodels.NewDevice()
additionalData := map[string]interface{}{
extensionAttributes := graphmodels.New()
extensionAttribute1 := "BYOD-Device"
extensionAttributes.SetExtensionAttribute1(&extensionAttribute1) 
	requestBody.SetExtensionAttributes(extensionAttributes)
}
requestBody.SetAdditionalData(additionalData)

devices, err := graphClient.Devices().ByDeviceId("device-id").Patch(context.Background(), requestBody, nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

Device device = new Device();
HashMap<String, Object> additionalData = new HashMap<String, Object>();
 extensionAttributes = new ();
extensionAttributes.setExtensionAttribute1("BYOD-Device");
additionalData.put("extensionAttributes", extensionAttributes);
device.setAdditionalData(additionalData);
Device result = graphClient.devices().byDeviceId("{device-id}").patch(device);


const options = {
	authProvider,
};

const client = Client.init(options);

const device = {
    extensionAttributes: {
        extensionAttribute1: 'BYOD-Device'
    }
};

await client.api('/devices/7c06cd31-7c30-4f3b-a5c3-444cd8dd63ac')
	.update(device);


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\Device;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new Device();
$additionalData = [
	'extensionAttributes' => [
		'extensionAttribute1' => 'BYOD-Device',
	],
];
$requestBody->setAdditionalData($additionalData);

$result = $graphServiceClient->devices()->byDeviceId('device-id')->patch($requestBody)->wait();


Import-Module Microsoft.Graph.Identity.DirectoryManagement

$params = @{
	extensionAttributes = @{
		extensionAttribute1 = "BYOD-Device"
	}
}

Update-MgDevice -DeviceId $deviceId -BodyParameter $params


from msgraph import GraphServiceClient
from msgraph.generated.models.device import Device

graph_client = GraphServiceClient(credentials, scopes)

request_body = Device(
	additional_data = {
			"extension_attributes" : {
					"extension_attribute1" : "BYOD-Device",
			},
	}
)

result = await graph_client.devices.by_device_id('device-id').patch(request_body)

Réponse

HTTP/1.1 204 No Content

Mettre à jour un appareil

Autorisations

Requête HTTP

En-têtes de demande

Corps de la demande

Réponse

Exemples

Exemple 1 : Mettre à jour la propriété accountEnabled d’un appareil

Demande

Réponse

Exemple 2 : Écrire des extensionsAttributes sur un appareil

Demande

Réponse

Commentaires

Commentaires

Ressources supplémentaires