Travailler avec Intune dans Microsoft Graph
Importante
Les API sous la version /beta
dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Remarque : l’API Microsoft Graph pour Intune requiert une licence Intune active pour le client.
L’API de Microsoft Graph pour Intune autorise l’accès programmatique aux informations Intune relatives à votre client ; l’API effectue les mêmes opérations Intune que celles disponibles via le Portail Azure.
Pour les scénarios de gestion des appareils mobiles, l’API de Microsoft Graph pour Intune prend en charge les déploiements autonomes ; les déploiements hybrides Intune ne sont pas pris en charge.
L’équipe Intune teste et valide toutes les API Microsoft Graph Beta pour Intune avant leur déploiement. Si vous souhaitez en savoir plus sur les dernières modifications apportées à l’API, veuillez consulter le journal des modifications.
Utilisation de l’API Microsoft Graph pour Intune
Intune fournit des données dans l’API Microsoft Graph de la même façon que d’autres services cloud, avec des informations d’identité précieuses et une navigation des relations. Utilisez l’API Microsoft Graph pour combiner les informations provenant d’autres services et d’Intune et créer des applications interservices enrichies pour les professionnels de l’informatique ou des utilisateurs finaux.
Voici un exemple de la façon dont vous pouvez déterminer si une application est installée sur l’appareil d’un utilisateur :
Obtenez une liste des appareils enregistrés pour un utilisateur à partir d’Azure Active Directory:
https://graph.microsoft.com/beta/users/{user}/ownedDevices
Affichez la liste des applications pour votre client :
https://graph.microsoft.com/beta/deviceAppManagement/mobileApps
Prenez l’ID dans l’application et déterminez l’état d’installation pour l’application (et par conséquent pour l’utilisateur) :
https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{id}/deviceStatuses/
Utilisations des autorisations de Microsoft Graph
Microsoft Graph contrôle l’accès aux ressources via les autorisations. En tant que développeur, vous devez spécifier les étendues d’autorisation dont vous avez besoin pour accéder aux ressources Intune. En général, vous spécifiez les autorisations dans le portail Azure Active Directory (Azure AD). Pour plus d’informations, reportez-vous à l’article relatif aux Autorisations Microsoft Graph.
Interaction entre les API Microsoft Graph pour les mises à jour Windows
Microsoft Graph comprend deux ensembles d’API que vous pouvez utiliser pour gérer les mises à jour Windows :
Vous pouvez utiliser l’une ou l’autre API pour gérer les mises à jour Windows ; toutefois, ces deux API ne sont pas compatibles l’une avec l’autre. Chaque API peut remplacer les configurations effectuées par l’autre sans fournir de visibilité sur cette action. L’utilisation des deux API pour gérer les mises à jour peut entraîner des comportements inattendus, notamment des configurations temporaires pour les déploiements de mises à jour qui sont annulées ou modifiées sans cause identifiée.
Étapes suivantes
- En savoir plus comment utiliser Azure AD pour accéder à l’API Graph Microsoft Intune.
- Explorer lesexemples PowerShell Intune, qui montrent comment utiliser l’API Graph Microsoft pour Intune dans le contexte d’exemples d’utilisation.