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 de mise hors service|Aucun|Mettre hors service un appareil | |action de réinitialisation |Aucun|Réinitialiser un appareil | |action resetPasscode |Aucun|Réinitialiser le code secret | |remoteLock, action |Aucun|Verrouillage à distance| |Action requestRemoteAssistance |Aucun|Demander une assistance à distance | |action disableLostMode |Aucun|Désactiver le mode perdu | |action locateDevice |Aucun|Localiser 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 | |cleanWindowsAction de l’appareil |Aucun|Nettoyer un appareil Windows | |logoutSharedAppleDeviceActiveUser, action |Aucun|Déconnecter l’utilisateur actif de l’appareil Apple partagé | |Action deleteUserFromSharedAppleDevice |Aucun|Supprimer un utilisateur d’un appareil Apple partagé | |syncDevice, action |Aucun|| |Action windowsDefenderScan |Aucun|| |WindowsDefenderUpdateSignatures, action |Aucun|| |action updateWindowsDeviceAccount |Aucun||
Propriétés
| 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. |
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,
"enrollmentProfileName": "String"
}