Partager via

Mettre à jour managedDevice

  • Article

Espace de noms: microsoft.graph

Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.

Met à jour les propriétés d’un objet managedDevice.

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

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) DeviceManagementManagedDevices.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application DeviceManagementManagedDevices.ReadWrite.All

Requête HTTP

PATCH /deviceManagement/managedDevices/{managedDeviceId}
PATCH /deviceManagement/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}
PATCH /deviceManagement/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}/users/{userId}/managedDevices/{managedDeviceId}

En-têtes de demande

En-tête Valeur
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
Accepter application/json

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON de l’objet managedDevice.

Le tableau suivant indique les propriétés qui sont requises lorsque vous créez l’objet managedDevice.

Propriété Type Description
id String Identificateur unique de l’appareil. Cette propriété est en lecture seule.
userId String Identificateur unique de l’utilisateur associé à l’appareil. Cette propriété est en lecture seule.
deviceName String Nom de l’appareil. Cette propriété est en lecture seule.
managedDeviceOwnerType managedDeviceOwnerType Propriété de l’appareil. Peut être « entreprise » ou « personnel ». Les valeurs possibles sont unknown, company et personal.
deviceActionResults Collection deviceActionResult Liste des objets deviceActionResult ComplexType. Cette propriété est en lecture seule.
enrolledDateTime DateTimeOffset Heure d’inscription de l’appareil. Prend en charge $filter’opérateur 'lt' et 'gt'. Cette propriété est en lecture seule.
lastSyncDateTime DateTimeOffset La date et l’heure de dernière synchronisation de l’appareil avec Intune. Prend en charge $filter’opérateur 'lt' et 'gt'. Cette propriété est en lecture seule.
operatingSystem String Système d’exploitation de l’appareil. Windows, iOS, etc. Cette propriété est en lecture seule.
complianceState complianceState État de conformité de l’appareil. Exemples : Conforme, Conflit, Erreur, etc. La valeur par défaut est inconnue. Prend en charge $filter’opérateur 'eq' et 'or'. Cette propriété est en lecture seule. Les valeurs possibles sont les suivantes : unknown, compliant, noncompliant, conflict, error, inGracePeriod et configManager.
jailBroken String Indique si l’appareil est endommagé ou rooté. Il s'agit par défaut d'une chaîne vide. Prend en charge $filter’opérateur 'eq' et 'or'. Cette propriété est en lecture seule.
managementAgent managementAgentType Canal de gestion de l’appareil. Exemples : Intune, EAS, etc. La valeur par défaut est inconnue. Prend en charge $filter’opérateur 'eq' et 'or'. Cette propriété est en lecture seule. Valeurs possibles : eas, mdm, easMdm, intuneClient, easIntuneClient, configurationManagerClient, configurationManagerClientMdm, configurationManagerClientMdmEas, unknown, jamf, googleCloudDevicePolicyController.
osVersion String Version du système d’exploitation de l’appareil. Cette propriété est en lecture seule.
easActivated Booléen Si Exchange ActiveSync est activé sur l’appareil. Cette propriété est en lecture seule.
easDeviceId String ID Exchange ActiveSync de l’appareil. Cette propriété est en lecture seule.
easActivationDateTime DateTimeOffset Heure de l’activation d’Exchange ActivationSync de l’appareil. Cette propriété est en lecture seule.
azureADRegistered Booléen Si l’appareil est inscrit auprès d’Azure Active Directory. Cette propriété est en lecture seule.
deviceEnrollmentType deviceEnrollmentType Type d’inscription de l’appareil. Cette propriété est en lecture seule. Les valeurs possibles sont unknown, userEnrollment, deviceEnrollmentManager, appleBulkWithUser, appleBulkWithoutUser, windowsAzureADJoin, windowsBulkUserless, windowsAutoEnrollment, windowsBulkAzureDomainJoin, windowsCoManagement, windowsAzureADJoinUsingDeviceAuth, appleUserEnrollment, appleUserEnrollmentWithServiceAccount.
activationLockBypassCode String Code qui permet de contourner le verrou d’activation sur l’appareil géré. La valeur par défaut est Null (propriété non par défaut) pour cette propriété lorsqu’elle est retournée dans le cadre de l’entité managedDevice dans l’appel LIST. Pour récupérer les valeurs réelles, l’appel GET doit être effectué, avec l’ID de l’appareil et inclus dans le paramètre select. Prend en charge : $select. $Search n’est pas pris en charge. En lecture seule. Cette propriété est en lecture seule.
emailAddress String Email pour l’utilisateur associé à l’appareil. Cette propriété est en lecture seule.
azureADDeviceId String Identificateur unique de l’appareil Azure Active Directory. En lecture seule. Cette propriété est en lecture seule.
deviceRegistrationState deviceRegistrationState État de l’inscription de l’appareil Cette propriété est en lecture seule. Les valeurs possibles sont les suivantes : notRegistered, registered, revoked, keyConflict, approvalPending, certificateReset, notRegisteredPendingEnrollment et unknown.
deviceCategoryDisplayName String Nom complet de la catégorie d’appareil. Il s'agit par défaut d'une chaîne vide. Prend en charge $filter’opérateur 'eq' et 'or'. Cette propriété est en lecture seule.
isSupervised Boolean Status supervisé par l’appareil. Cette propriété est en lecture seule.
exchangeLastSuccessfulSyncDateTime DateTimeOffset Dernière fois que l’appareil a contacté Exchange. Cette propriété est en lecture seule.
exchangeAccessState deviceManagementExchangeAccessState État de l’accès de l’appareil dans Exchange. Cette propriété est en lecture seule. Les valeurs possibles sont les suivantes : none, unknown, allowed, blocked, quarantined.
exchangeAccessStateReason deviceManagementExchangeAccessStateReason Motif lié à l’état de l’accès dans Exchange. Cette propriété est en lecture seule. Les valeurs possibles sont les suivantes : none, unknown, exchangeGlobalRule, exchangeIndividualRule, exchangeDeviceRule, exchangeUpgrade, exchangeMailboxPolicy, other, compliant, notCompliant, notEnrolled, unknownLocation, mfaRequired, azureADBlockDueToAccessPolicy, compromisedPassword et deviceNotKnownWithManagedApp.
remoteAssistanceSessionUrl String URL permettant à une session d’assistance à distance d’être établie avec l’appareil. Il s'agit par défaut d'une chaîne vide. Pour récupérer les valeurs réelles, l’appel GET doit être effectué, avec l’ID de l’appareil et inclus dans le paramètre select. Cette propriété est en lecture seule.
remoteAssistanceSessionErrorDetails String Chaîne d’erreur identifiant les problèmes lors de la création d’objets de session d’assistance à distance. Cette propriété est en lecture seule.
isEncrypted Boolean Status de chiffrement de l’appareil. Cette propriété est en lecture seule.
userPrincipalName String Nom d’utilisateur principal de l’appareil. Cette propriété est en lecture seule.
model String Modèle de l’appareil. Cette propriété est en lecture seule.
Fabricant String Fabricant de l’appareil. Cette propriété est en lecture seule.
imei String IMEI. Cette propriété est en lecture seule.
complianceGracePeriodExpirationDateTime DateTimeOffset DateTime à laquelle la période de grâce de conformité de l’appareil expire. Cette propriété est en lecture seule.
serialNumber String SerialNumber. Cette propriété est en lecture seule.
phoneNumber String Numéro de téléphone de l’appareil. Cette propriété est en lecture seule.
androidSecurityPatchLevel String Niveau du correctif de sécurité Android. Cette propriété est en lecture seule.
userDisplayName String Nom d’affichage de l’utilisateur. Cette propriété est en lecture seule.
configurationManagerClientEnabledFeatures configurationManagerClientEnabledFeatures Fonctionnalités compatibles avec le client ConfigrMgr. Cette propriété est en lecture seule.
wiFiMacAddress String Wi-Fi MAC. Cette propriété est en lecture seule.
deviceHealthAttestationState deviceHealthAttestationState État de l’attestation d’intégrité de l’appareil Cette propriété est en lecture seule.
subscriberCarrier String Opérateur de l’abonné. Cette propriété est en lecture seule.
meid String MEID. Cette propriété est en lecture seule.
totalStorageSpaceInBytes Int64 Stockage total en octets. Cette propriété est en lecture seule.
freeStorageSpaceInBytes Int64 Stockage gratuit en octets. La valeur par défaut est 0. En lecture seule. Cette propriété est en lecture seule.
managedDeviceName String Nom généré automatiquement permettant d’identifier un appareil. Peut être remplacé par un nom d’utilisateur convivial.
partnerReportedThreatState managedDevicePartnerReportedHealthState Indique l’état des menaces d’un appareil lorsqu’un partenaire Mobile Threat Defense est utilisé par le compte et l’appareil. En lecture seule. Cette propriété est en lecture seule. Les valeurs possibles sont les suivantes : unknown, activated, deactivated, secured, lowSeverity, mediumSeverity, highSeverity, unresponsive, compromised et misconfigured.
requireUserEnrollmentApproval Boolean Indique si l’appareil iOS géré est l’inscription d’approbation de l’utilisateur. Cette propriété est en lecture seule.
managementCertificateExpirationDate DateTimeOffset Indique la date d’expiration du certificat de gestion des appareils. Cette propriété est en lecture seule.
iccid String Identificateur de carte à circuit intégré, il s’agit du numéro d’identification unique d’une carte SIM carte. Il s'agit par défaut d'une chaîne vide. Pour récupérer les valeurs réelles, l’appel GET doit être effectué, avec l’ID de l’appareil et inclus dans le paramètre select. Prend en charge : $select. $Search n’est pas pris en charge. En lecture seule. Cette propriété est en lecture seule.
udid String Identificateur d’appareil unique pour les appareils iOS et macOS. Il s'agit par défaut d'une chaîne vide. Pour récupérer les valeurs réelles, l’appel GET doit être effectué, avec l’ID de l’appareil et inclus dans le paramètre select. Prend en charge : $select. $Search n’est pas pris en charge. En lecture seule. Cette propriété est en lecture seule.
notes String Remarques sur l’appareil créé par le Administration informatique. La valeur par défaut est null. Pour récupérer les valeurs réelles, l’appel GET doit être effectué, avec l’ID de l’appareil et inclus dans le paramètre select. Prend en charge : $select. $Search n’est pas pris en charge.
ethernetMacAddress String Indique l’adresse MAC Ethernet de l’appareil. La valeur par défaut est Null (propriété non par défaut) pour cette propriété lorsqu’elle est retournée dans le cadre de l’entité managedDevice. Un appel get individuel avec des options de requête sélectionnées est nécessaire pour récupérer les valeurs réelles. Exemple : deviceManagement/managedDevices({managedDeviceId}) ?$select=ethernetMacAddress Prend en charge : $select. $Search n’est pas pris en charge. En lecture seule. Cette propriété est en lecture seule.
physicalMemoryInBytes Int64 Mémoire totale en octets. La valeur par défaut est 0. Pour récupérer les valeurs réelles, l’appel GET doit être effectué, avec l’ID de l’appareil et inclus dans le paramètre select. Prend en charge : $select. En lecture seule. Cette propriété est en lecture seule.
enrollmentProfileName String Nom du profil d’inscription affecté à l’appareil. La valeur par défaut est une chaîne vide, indiquant qu’aucun profil d’inscription n’a été créé. Cette propriété est en lecture seule.

Réponse

Si elle réussit, cette méthode renvoie un code de réponse 200 OK et un objet managedDevice mis à jour dans le corps de la réponse.

Exemple

Demande

Voici un exemple de demande.

PATCH https://graph.microsoft.com/v1.0/deviceManagement/managedDevices/{managedDeviceId}
Content-type: application/json
Content-length: 5058

{
  "@odata.type": "#microsoft.graph.managedDevice",
  "userId": "User Id value",
  "deviceName": "Device Name value",
  "managedDeviceOwnerType": "company",
  "deviceActionResults": [
    {
      "@odata.type": "microsoft.graph.deviceActionResult",
      "actionName": "Action Name value",
      "actionState": "pending",
      "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
      "lastUpdatedDateTime": "2017-01-01T00:00:56.8321556-08:00"
    }
  ],
  "enrolledDateTime": "2016-12-31T23:59:43.797191-08:00",
  "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
  "operatingSystem": "Operating System value",
  "complianceState": "compliant",
  "jailBroken": "Jail Broken value",
  "managementAgent": "mdm",
  "osVersion": "Os Version value",
  "easActivated": true,
  "easDeviceId": "Eas Device Id value",
  "easActivationDateTime": "2016-12-31T23:59:43.4878784-08:00",
  "azureADRegistered": true,
  "deviceEnrollmentType": "userEnrollment",
  "activationLockBypassCode": "Activation Lock Bypass Code value",
  "emailAddress": "Email Address value",
  "azureADDeviceId": "Azure ADDevice Id value",
  "deviceRegistrationState": "registered",
  "deviceCategoryDisplayName": "Device Category Display Name value",
  "isSupervised": true,
  "exchangeLastSuccessfulSyncDateTime": "2017-01-01T00:00:45.8803083-08:00",
  "exchangeAccessState": "unknown",
  "exchangeAccessStateReason": "unknown",
  "remoteAssistanceSessionUrl": "https://example.com/remoteAssistanceSessionUrl/",
  "remoteAssistanceSessionErrorDetails": "Remote Assistance Session Error Details value",
  "isEncrypted": true,
  "userPrincipalName": "User Principal Name value",
  "model": "Model value",
  "manufacturer": "Manufacturer value",
  "imei": "Imei value",
  "complianceGracePeriodExpirationDateTime": "2016-12-31T23:56:44.951111-08:00",
  "serialNumber": "Serial Number value",
  "phoneNumber": "Phone Number value",
  "androidSecurityPatchLevel": "Android Security Patch Level value",
  "userDisplayName": "User Display Name value",
  "configurationManagerClientEnabledFeatures": {
    "@odata.type": "microsoft.graph.configurationManagerClientEnabledFeatures",
    "inventory": true,
    "modernApps": true,
    "resourceAccess": true,
    "deviceConfiguration": true,
    "compliancePolicy": true,
    "windowsUpdateForBusiness": true
  },
  "wiFiMacAddress": "Wi Fi Mac Address value",
  "deviceHealthAttestationState": {
    "@odata.type": "microsoft.graph.deviceHealthAttestationState",
    "lastUpdateDateTime": "Last Update Date Time value",
    "contentNamespaceUrl": "https://example.com/contentNamespaceUrl/",
    "deviceHealthAttestationStatus": "Device Health Attestation Status value",
    "contentVersion": "Content Version value",
    "issuedDateTime": "2016-12-31T23:58:22.1231038-08:00",
    "attestationIdentityKey": "Attestation Identity Key value",
    "resetCount": 10,
    "restartCount": 12,
    "dataExcutionPolicy": "Data Excution Policy value",
    "bitLockerStatus": "Bit Locker Status value",
    "bootManagerVersion": "Boot Manager Version value",
    "codeIntegrityCheckVersion": "Code Integrity Check Version value",
    "secureBoot": "Secure Boot value",
    "bootDebugging": "Boot Debugging value",
    "operatingSystemKernelDebugging": "Operating System Kernel Debugging value",
    "codeIntegrity": "Code Integrity value",
    "testSigning": "Test Signing value",
    "safeMode": "Safe Mode value",
    "windowsPE": "Windows PE value",
    "earlyLaunchAntiMalwareDriverProtection": "Early Launch Anti Malware Driver Protection value",
    "virtualSecureMode": "Virtual Secure Mode value",
    "pcrHashAlgorithm": "Pcr Hash Algorithm value",
    "bootAppSecurityVersion": "Boot App Security Version value",
    "bootManagerSecurityVersion": "Boot Manager Security Version value",
    "tpmVersion": "Tpm Version value",
    "pcr0": "Pcr0 value",
    "secureBootConfigurationPolicyFingerPrint": "Secure Boot Configuration Policy Finger Print value",
    "codeIntegrityPolicy": "Code Integrity Policy value",
    "bootRevisionListInfo": "Boot Revision List Info value",
    "operatingSystemRevListInfo": "Operating System Rev List Info value",
    "healthStatusMismatchInfo": "Health Status Mismatch Info value",
    "healthAttestationSupportedStatus": "Health Attestation Supported Status value"
  },
  "subscriberCarrier": "Subscriber Carrier value",
  "meid": "Meid value",
  "totalStorageSpaceInBytes": 8,
  "freeStorageSpaceInBytes": 7,
  "managedDeviceName": "Managed Device Name value",
  "partnerReportedThreatState": "activated",
  "requireUserEnrollmentApproval": true,
  "managementCertificateExpirationDate": "2016-12-31T23:57:59.9789653-08:00",
  "iccid": "Iccid value",
  "udid": "Udid value",
  "notes": "Notes value",
  "ethernetMacAddress": "Ethernet Mac Address value",
  "physicalMemoryInBytes": 5,
  "enrollmentProfileName": "Enrollment Profile Name value"
}

Réponse

Voici un exemple de réponse. Remarque : l’objet de réponse illustré ici peut être tronqué à des fins de concision. Toutes les propriétés sont renvoyées à partir d’un appel réel.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 5107

{
  "@odata.type": "#microsoft.graph.managedDevice",
  "id": "705c034c-034c-705c-4c03-5c704c035c70",
  "userId": "User Id value",
  "deviceName": "Device Name value",
  "managedDeviceOwnerType": "company",
  "deviceActionResults": [
    {
      "@odata.type": "microsoft.graph.deviceActionResult",
      "actionName": "Action Name value",
      "actionState": "pending",
      "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
      "lastUpdatedDateTime": "2017-01-01T00:00:56.8321556-08:00"
    }
  ],
  "enrolledDateTime": "2016-12-31T23:59:43.797191-08:00",
  "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
  "operatingSystem": "Operating System value",
  "complianceState": "compliant",
  "jailBroken": "Jail Broken value",
  "managementAgent": "mdm",
  "osVersion": "Os Version value",
  "easActivated": true,
  "easDeviceId": "Eas Device Id value",
  "easActivationDateTime": "2016-12-31T23:59:43.4878784-08:00",
  "azureADRegistered": true,
  "deviceEnrollmentType": "userEnrollment",
  "activationLockBypassCode": "Activation Lock Bypass Code value",
  "emailAddress": "Email Address value",
  "azureADDeviceId": "Azure ADDevice Id value",
  "deviceRegistrationState": "registered",
  "deviceCategoryDisplayName": "Device Category Display Name value",
  "isSupervised": true,
  "exchangeLastSuccessfulSyncDateTime": "2017-01-01T00:00:45.8803083-08:00",
  "exchangeAccessState": "unknown",
  "exchangeAccessStateReason": "unknown",
  "remoteAssistanceSessionUrl": "https://example.com/remoteAssistanceSessionUrl/",
  "remoteAssistanceSessionErrorDetails": "Remote Assistance Session Error Details value",
  "isEncrypted": true,
  "userPrincipalName": "User Principal Name value",
  "model": "Model value",
  "manufacturer": "Manufacturer value",
  "imei": "Imei value",
  "complianceGracePeriodExpirationDateTime": "2016-12-31T23:56:44.951111-08:00",
  "serialNumber": "Serial Number value",
  "phoneNumber": "Phone Number value",
  "androidSecurityPatchLevel": "Android Security Patch Level value",
  "userDisplayName": "User Display Name value",
  "configurationManagerClientEnabledFeatures": {
    "@odata.type": "microsoft.graph.configurationManagerClientEnabledFeatures",
    "inventory": true,
    "modernApps": true,
    "resourceAccess": true,
    "deviceConfiguration": true,
    "compliancePolicy": true,
    "windowsUpdateForBusiness": true
  },
  "wiFiMacAddress": "Wi Fi Mac Address value",
  "deviceHealthAttestationState": {
    "@odata.type": "microsoft.graph.deviceHealthAttestationState",
    "lastUpdateDateTime": "Last Update Date Time value",
    "contentNamespaceUrl": "https://example.com/contentNamespaceUrl/",
    "deviceHealthAttestationStatus": "Device Health Attestation Status value",
    "contentVersion": "Content Version value",
    "issuedDateTime": "2016-12-31T23:58:22.1231038-08:00",
    "attestationIdentityKey": "Attestation Identity Key value",
    "resetCount": 10,
    "restartCount": 12,
    "dataExcutionPolicy": "Data Excution Policy value",
    "bitLockerStatus": "Bit Locker Status value",
    "bootManagerVersion": "Boot Manager Version value",
    "codeIntegrityCheckVersion": "Code Integrity Check Version value",
    "secureBoot": "Secure Boot value",
    "bootDebugging": "Boot Debugging value",
    "operatingSystemKernelDebugging": "Operating System Kernel Debugging value",
    "codeIntegrity": "Code Integrity value",
    "testSigning": "Test Signing value",
    "safeMode": "Safe Mode value",
    "windowsPE": "Windows PE value",
    "earlyLaunchAntiMalwareDriverProtection": "Early Launch Anti Malware Driver Protection value",
    "virtualSecureMode": "Virtual Secure Mode value",
    "pcrHashAlgorithm": "Pcr Hash Algorithm value",
    "bootAppSecurityVersion": "Boot App Security Version value",
    "bootManagerSecurityVersion": "Boot Manager Security Version value",
    "tpmVersion": "Tpm Version value",
    "pcr0": "Pcr0 value",
    "secureBootConfigurationPolicyFingerPrint": "Secure Boot Configuration Policy Finger Print value",
    "codeIntegrityPolicy": "Code Integrity Policy value",
    "bootRevisionListInfo": "Boot Revision List Info value",
    "operatingSystemRevListInfo": "Operating System Rev List Info value",
    "healthStatusMismatchInfo": "Health Status Mismatch Info value",
    "healthAttestationSupportedStatus": "Health Attestation Supported Status value"
  },
  "subscriberCarrier": "Subscriber Carrier value",
  "meid": "Meid value",
  "totalStorageSpaceInBytes": 8,
  "freeStorageSpaceInBytes": 7,
  "managedDeviceName": "Managed Device Name value",
  "partnerReportedThreatState": "activated",
  "requireUserEnrollmentApproval": true,
  "managementCertificateExpirationDate": "2016-12-31T23:57:59.9789653-08:00",
  "iccid": "Iccid value",
  "udid": "Udid value",
  "notes": "Notes value",
  "ethernetMacAddress": "Ethernet Mac Address value",
  "physicalMemoryInBytes": 5,
  "enrollmentProfileName": "Enrollment Profile Name value"
}