exemples PowerShell Intune
Intune Graph Samples
| type_page | produits | langues | extensions | aucune dépendance | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
échantillon |
|
|
| vrai |
L'année dernière, nous avons annoncé ici un nouveau référentiel Microsoft Intune GitHub basé sur le module PowerShell basé sur le SDK Microsoft Graph. Cet ancien référentiel GitHub d’exemples de scripts Microsoft Intune PowerShell est désormais en lecture seule. De plus, à compter du 1er avril 2024, en raison de la mise à jour des méthodes d'authentification dans le module PowerShell basé sur le SDK Graph, la méthode d'authentification globale basée sur l'ID de l'application (client) Microsoft Intune PowerShell est supprimée.
Si vous utilisez l'ID d'application Intune PowerShell (d1ddf0e4-d672-4dae-b554-9d5bdfd93547), vous devrez mettre à jour vos scripts avec un ID d'application enregistré Microsoft Entra ID pour éviter que vos scripts ne se cassent.
Avant le 6 mai 2024, mettez à jour vos scripts PowerShell :
Consultez le fichier « Mise à jour de l'enregistrement de l'application » pour obtenir des instructions détaillées. (https://github.com/microsoftgraph/powershell-intune-samples/blob/master/Updating%20App%20Registration)
Ce référentiel d’exemples de scripts PowerShell montre comment accéder aux ressources du service Intune. Ils le démontrent en effectuant des requêtes API HTTPS RESTful à l'API Microsoft Graph à partir de PowerShell.
La documentation pour Intune et Microsoft Graph est disponible ici Documentation Intune Graph.
Ces exemples illustrent les actions typiques d’un administrateur Intune ou d’un partenaire Microsoft pour la gestion des ressources Intune.
Les exemples suivants sont inclus dans ce référentiel :
Les scripts sont sous licence « tels quels ». sous licence MIT.
Certains exemples de script récupèrent des informations de votre locataire Intune, tandis que d'autres créent, suppriment ou mettent à jour des données dans votre locataire Intune. Comprendre l'impact de chaque exemple de script avant de l'exécuter ; les exemples doivent être exécutés à l’aide d’un compte locataire hors production ou « test ».
L’API Intune Graph permet à votre locataire d’accéder par programmation aux informations Intune, et l’API effectue les mêmes opérations Intune que celles disponibles via le portail Azure.
Intune fournit des données dans Microsoft Graph de la même manière que les autres services cloud, avec des informations riches sur les entités et une navigation dans les relations. Utilisez Microsoft Graph pour combiner les informations d'autres services et Intune pour créer des applications interservices riches pour les professionnels de l'informatique ou les utilisateurs finaux.
L’utilisation de ces exemples Intune PowerShell de l’API Microsoft Graph nécessite les éléments suivants :
Une fois les conditions préalables installées ou remplies, effectuez les étapes suivantes pour utiliser ces scripts :
La première fois que vous exécuterez ces scripts, il vous sera demandé de fournir un compte pour vous authentifier auprès du service :
Please specify your user principal name for Azure Authentication:
Une fois que vous avez fourni un nom d'utilisateur principal, une fenêtre contextuelle s'ouvrira vous demandant votre mot de passe. Après une authentification réussie avec Azure Active Directory, le jeton utilisateur durera une heure. Une fois l'heure expirée au cours de la session PowerShell, il vous sera demandé de vous réauthentifier.
Si vous exécutez le script pour la première fois sur votre locataire, une fenêtre contextuelle s'affichera indiquant :
Microsoft Intune PowerShell needs permission to:
* Sign you in and read your profile
* Read all groups
* Read directory data
* Read and write Microsoft Intune Device Configuration and Policies (preview)
* Read and write Microsoft Intune RBAC settings (preview)
* Perform user-impacting remote actions on Microsoft Intune devices (preview)
* Sign in as you
* Read and write Microsoft Intune devices (preview)
* Read and write all groups
* Read and write Microsoft Intune configuration (preview)
* Read and write Microsoft Intune apps (preview)
Remarque : Si votre compte utilisateur est destiné à un accès conditionnel basé sur l'appareil, votre appareil doit être inscrit ou conforme pour réussir l'authentification.
Si vous souhaitez contribuer à cet exemple, consultez CONTRIBUTING.MD.
Ce projet a adopté le code de conduite Microsoft Open Source. Pour plus d’informations, consultez la FAQ sur le code de conduite ou contactez [email protected] pour toute question ou commentaire supplémentaire.
Nous aimerions recevoir vos commentaires sur l’exemple Intune PowerShell. Vous pouvez nous envoyer vos questions et suggestions dans la section Problèmes de ce référentiel.
Vos commentaires sont importants pour nous. Connectez-vous avec nous sur Stack Overflow. Marquez vos questions avec [MicrosoftGraph] et [intune].
Copyright (c) 2017 Microsoft. Tous droits réservés.
Ce projet a adopté le code de conduite Microsoft Open Source. Pour plus d’informations, consultez la FAQ sur le code de conduite ou contactez [email protected] pour toute question ou commentaire supplémentaire.
