Type de ressource managedDevice

Espace de noms: microsoft.graph

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

Appareils gérés ou pré-inscrits via Intune

Méthodes

Méthode Type renvoyé Description
List managedDevices Collection managedDevice Répertorie les propriétés et les relations des objets managedDevice.
Get managedDevice managedDevice Lit les propriétés et les relations de l’objet managedDevice.
Create managedDevice managedDevice Crée un objet managedDevice.
Delete managedDevice Aucun Supprime un objet managedDevice.
Update managedDevice managedDevice Met à jour les propriétés d’un objet managedDevice.
Action createDeviceLogCollectionRequest deviceLogCollectionResponse Pas encore documenté
Action retire Aucun Retirer un appareil
Action wipe Aucun Réinitialiser un appareil
Action resetPasscode Aucun Réinitialiser le code secret
Action remoteLock Aucun Verrouiller à distance
Action requestRemoteAssistance Aucun Demander une assistance à distance
Action disableLostMode Aucun Désactiver le mode Perdu
Action locateDevice Aucun Rechercher un appareil
Action bypassActivationLock Aucun Contourner le verrou d’activation
Action rebootNow Aucun Redémarrer l’appareil
Action shutDown Aucun Arrêter l’appareil
Action recoverPasscode Aucun Récupérer le code secret
Action cleanWindowsDevice Aucun Nettoyer le périphérique Windows
Action logoutSharedAppleDeviceActiveUser Aucun Déconnecter l’utilisateur actif de l’appareil Apple partagé
Action deleteUserFromSharedAppleDevice Aucun Supprime un utilisateur de l’appareil Apple partagé
Action syncDevice Aucun Pas encore documenté
Action windowsDefenderScan Aucun Pas encore documenté
Action windowsDefenderUpdateSignatures Aucun Pas encore documenté
Action updateWindowsDeviceAccount Aucun Pas encore documenté

Propriétés

Propriété Type Description
id Chaîne 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 Chaîne 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 Chaîne 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 Chaîne 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 Chaîne 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 Chaîne 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 Valeur booléenne 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 Valeur booléenne 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 Chaîne Modèle de l’appareil. Cette propriété est en lecture seule.
Fabricant Chaîne Fabricant de l’appareil. Cette propriété est en lecture seule.
imei Chaîne 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 Chaîne SerialNumber. Cette propriété est en lecture seule.
phoneNumber Chaîne Numéro de téléphone de l’appareil. Cette propriété est en lecture seule.
androidSecurityPatchLevel Chaîne 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 Chaîne 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 Chaîne Opérateur de l’abonné. Cette propriété est en lecture seule.
meid Chaîne 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 Valeur booléenne 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 Chaîne 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 Chaîne 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 Chaîne 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.

Relations

Relation Type Description
deviceCategory deviceCategory Catégorie de périphérique
windowsProtectionState windowsProtectionState Le status de protection de l’appareil. Cette propriété est en lecture seule.
utilisateurs Collection d’utilisateurs Utilisateurs principaux associés à l’appareil géré.
logCollectionRequests collection deviceLogCollectionResponse Liste des demandes de collecte de journaux

Représentation JSON

Voici une représentation JSON de la ressource.

{
  "@odata.type": "#microsoft.graph.managedDevice",
  "id": "String (identifier)",
  "userId": "String",
  "deviceName": "String",
  "managedDeviceOwnerType": "String",
  "deviceActionResults": [
    {
      "@odata.type": "microsoft.graph.deviceActionResult",
      "actionName": "String",
      "actionState": "String",
      "startDateTime": "String (timestamp)",
      "lastUpdatedDateTime": "String (timestamp)"
    }
  ],
  "enrolledDateTime": "String (timestamp)",
  "lastSyncDateTime": "String (timestamp)",
  "operatingSystem": "String",
  "complianceState": "String",
  "jailBroken": "String",
  "managementAgent": "String",
  "osVersion": "String",
  "easActivated": true,
  "easDeviceId": "String",
  "easActivationDateTime": "String (timestamp)",
  "azureADRegistered": true,
  "deviceEnrollmentType": "String",
  "activationLockBypassCode": "String",
  "emailAddress": "String",
  "azureADDeviceId": "String",
  "deviceRegistrationState": "String",
  "deviceCategoryDisplayName": "String",
  "isSupervised": true,
  "exchangeLastSuccessfulSyncDateTime": "String (timestamp)",
  "exchangeAccessState": "String",
  "exchangeAccessStateReason": "String",
  "remoteAssistanceSessionUrl": "String",
  "remoteAssistanceSessionErrorDetails": "String",
  "isEncrypted": true,
  "userPrincipalName": "String",
  "model": "String",
  "manufacturer": "String",
  "imei": "String",
  "complianceGracePeriodExpirationDateTime": "String (timestamp)",
  "serialNumber": "String",
  "phoneNumber": "String",
  "androidSecurityPatchLevel": "String",
  "userDisplayName": "String",
  "configurationManagerClientEnabledFeatures": {
    "@odata.type": "microsoft.graph.configurationManagerClientEnabledFeatures",
    "inventory": true,
    "modernApps": true,
    "resourceAccess": true,
    "deviceConfiguration": true,
    "compliancePolicy": true,
    "windowsUpdateForBusiness": true
  },
  "wiFiMacAddress": "String",
  "deviceHealthAttestationState": {
    "@odata.type": "microsoft.graph.deviceHealthAttestationState",
    "lastUpdateDateTime": "String",
    "contentNamespaceUrl": "String",
    "deviceHealthAttestationStatus": "String",
    "contentVersion": "String",
    "issuedDateTime": "String (timestamp)",
    "attestationIdentityKey": "String",
    "resetCount": 1024,
    "restartCount": 1024,
    "dataExcutionPolicy": "String",
    "bitLockerStatus": "String",
    "bootManagerVersion": "String",
    "codeIntegrityCheckVersion": "String",
    "secureBoot": "String",
    "bootDebugging": "String",
    "operatingSystemKernelDebugging": "String",
    "codeIntegrity": "String",
    "testSigning": "String",
    "safeMode": "String",
    "windowsPE": "String",
    "earlyLaunchAntiMalwareDriverProtection": "String",
    "virtualSecureMode": "String",
    "pcrHashAlgorithm": "String",
    "bootAppSecurityVersion": "String",
    "bootManagerSecurityVersion": "String",
    "tpmVersion": "String",
    "pcr0": "String",
    "secureBootConfigurationPolicyFingerPrint": "String",
    "codeIntegrityPolicy": "String",
    "bootRevisionListInfo": "String",
    "operatingSystemRevListInfo": "String",
    "healthStatusMismatchInfo": "String",
    "healthAttestationSupportedStatus": "String"
  },
  "subscriberCarrier": "String",
  "meid": "String",
  "totalStorageSpaceInBytes": 1024,
  "freeStorageSpaceInBytes": 1024,
  "managedDeviceName": "String",
  "partnerReportedThreatState": "String",
  "requireUserEnrollmentApproval": true,
  "managementCertificateExpirationDate": "String (timestamp)",
  "iccid": "String",
  "udid": "String",
  "notes": "String",
  "ethernetMacAddress": "String",
  "physicalMemoryInBytes": 1024
}