Mettre à jour un appareil
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 au moins le rôle Administrateur IntuneMicrosoft Entra. Un utilisateur appelant dans le rôle Administrateur d’appareil cloud peut uniquement activer ou désactiver des appareils et un utilisateur disposant du rôle Administrateur Windows 365 peut uniquement mettre à jour les propriétés de base de 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. En savoir plus sur l’authentification et l’autorisation. |
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 disposant au moins du rôle 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 de gestion des appareils mobiles (GPM) ; sinon, false . Il peut uniquement être mis à jour 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 de gestion des appareils mobiles (GPM) ; sinon, false . Il peut uniquement être mis à jour 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
}
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"
}
}
Réponse
HTTP/1.1 204 No Content