Utiliser des scripts shell sur les appareils macOS dans Intune

Utilisez les scripts shell pour étendre les fonctionnalités de gestion des périphériques dans Intune, au-delà de ce que le système d’exploitation macOS prend en charge.

Remarque

Rosetta 2 est requis pour exécuter la version x64 (Intel) des applications sur des ordinateurs Mac Apple Silicon. Pour installer automatiquement Rosetta 2 sur les Mac Apple Silicon, déployez un script shell dans Intune. Pour afficher un exemple de script, reportez-vous à la section Script d’installation de Rosetta 2.

Configuration requise

Assurez-vous que les prérequis suivants sont satisfaits lors de la composition de scripts shell et de leur affectation à des appareils macOS.

  • Les appareils exécutent macOS 12.0 ou version ultérieure.
  • Intune gère les appareils.
  • Les appareils se connectent directement à Internet. Intune ne prend pas en charge la connexion via un proxy.
  • Les scripts shell commencent par #! et se trouvent dans un emplacement valide tel que #!/bin/sh ou #!/usr/bin/env zsh.
  • Les interpréteurs en ligne de commande pour les interpréteurs de commandes applicables sont installés.

Points importants à prendre en considération avant d’utiliser des scripts shell

  • Les scripts shell nécessitent que l’agent de gestion Microsoft Intune soit correctement installé sur l’appareil macOS. Pour plus d’informations, consultez Agent de gestion Microsoft Intune pour macOS.
  • Les scripts shell s’exécutent en parallèle sur les appareils en tant que processus distincts.
  • Les scripts shell qui s’exécutent en tant qu’utilisateur connecté s’exécutent pour tous les comptes d’utilisateurs actuellement connectés sur l’appareil au moment de l’exécution.
  • Un utilisateur final doit se connecter à l’appareil pour exécuter des scripts s’exécutant en tant qu’utilisateur connecté.
  • Les privilèges d’utilisateur racine sont requis si le script doit apporter des modifications qu’un compte d’utilisateur standard ne peut pas apporter.
  • Les scripts Shell tentent de s’exécuter plus fréquemment que la fréquence de script choisie dans certaines conditions, par exemple si le disque est plein, si l’emplacement de stockage est falsifié, si le cache local est supprimé ou si l’appareil Mac redémarre.
  • Les scripts shell qui s’exécutent pendant plus de 60 minutes sont arrêtés et signalés comme ayant échoué.

Créer et attribuer une stratégie de script shell

  1. Connectez-vous au Centre d’administration Microsoft Intune.

  2. Sélectionner des appareils>par plate-forme>macOS>Gérer les appareils>Ajoutde scripts>.

  3. Dans Informations de base, entrer les propriétés suivantes, puis sélectionner Suivant :

    • Nom : entrez un nom pour le script shell.
    • Description : entrez une description pour le script shell. Nous recommandons ce paramètre facultatif.
  4. Dans Paramètres du script, entrer les propriétés suivantes, puis sélectionner Suivant :

    • Télécharger le script : accédez au script shell. Le fichier de script doit avoir une taille inférieure à 1 Mo.
    • Exécuter le script en tant qu’utilisateur connecté : sélectionnez Oui pour exécuter le script avec les informations d’identification de l’utilisateur sur l’appareil. Choisissez Non (par défaut) pour exécuter le script en tant qu’utilisateur racine.
    • Masquer les notifications de script sur les appareils : Par défaut, des notifications de script s’affichent pour chaque script qui s’exécute. Les utilisateurs finaux voient une notification informatique configure votre ordinateur à partir d’Intune sur les appareils macOS.
    • Fréquence des scripts : Sélectionnez la fréquence d’exécution du script. Choisissez Non configuré (par défaut) pour exécuter un script une seule fois. Les scripts avec une fréquence définie s’exécutent également après le redémarrage d’un appareil.
    • Nombre maximal de réessayer en cas d’échec du script : Sélectionnez le nombre de fois que le script doit s’exécuter s’il retourne un code de sortie différent de zéro (zéro signifie réussite). Choisissez Non configuré (par défaut) pour ne pas réessayer en cas d’échec d’un script.
  5. Dans Balises d’étendue, ajoutez éventuellement des balises d’étendue pour le script, puis sélectionnez Suivant. Utilisez des balises d’étendue pour déterminer qui peut voir les scripts dans Intune. Pour plus d’informations, voir Utiliser le contrôle d’accès en fonction du rôle et les balises d’étendue pour l’informatique distribuée.

  6. Sélectionnez Affectations>Sélectionner les groupes à inclure. Une liste existante de groupes Microsoft Entra s’affiche. Sélectionnez un ou plusieurs groupes d’utilisateurs ou d’appareils pour recevoir le script. Choisir Sélectionner. Les groupes que vous choisissez sont affichés dans la liste. Ils reçoivent votre stratégie de script.

    Remarque

    Les scripts shell affectés aux groupes d’utilisateurs s’appliquent à tout utilisateur se connectant au Mac. La mise à jour des attributions pour les scripts shell met également à jour les affectations pour l’agent GPM de Microsoft Intune pour macOS.

  7. Dans Passer en revue + ajouter, vous voyez un récapitulatif des paramètres que vous avez configurés. Sélectionnez Ajouter pour enregistrer le script. Lorsque vous sélectionnez Ajouter, la stratégie de script est déployée dans les groupes que vous avez choisis.

Le script que vous avez créé apparaît désormais dans la liste des scripts. Si nécessaire, vous pouvez afficher le contenu des scripts shell macOS après les avoir téléchargés dans Intune.

Surveiller une stratégie de script shell

Vous pouvez surveiller le status d’exécution de tous les scripts attribués pour les utilisateurs et les appareils en choisissant l’un des rapports suivants :

  • Scripts>Sélectionnez le script à superviser>Device status
  • Scripts>Sélectionnez le script à superviser>Status de l’utilisateur

Importante

Quelle que soit la fréquence de script sélectionnée, le status d’exécution du script n’est signalé que lorsque le status change par rapport au dernier rapport. Par exemple, si un script signale la réussite d’une exécution et l’échec de la suivante, Intune met à jour le status et l’horodatage de la dernière mise à jour avec les informations d’exécution actuelles. Si le status du script ne change pas entre les synchronisations, Intune met à jour le dernier horodatage mis à jour tous les sept jours à compter de l’exécution initiale.

Lorsqu’un script s’exécute, il retourne l’un des états suivants :

  • Le status d’exécution du script Échec indique que le script a renvoyé un code de sortie différent de zéro ou qu’il est incorrect.
  • Le status d’exécution d’un script Réussite indique que le script a renvoyé zéro comme code de sortie.

Résoudre les stratégies de script shell macOS à l’aide de la collecte de journaux

Vous pouvez collecter les journaux d’activité des appareils pour faciliter la résolution des problèmes de script sur les appareils macOS.

Configuration requise pour la collecte des journaux

Pour collecter les journaux sur un appareil macOS, vous devez fournir les informations suivantes :

  • Chemin d’accès absolu complet du fichier journal.
  • Chemins d’accès aux fichiers séparés uniquement par un point-virgule (;).
  • Une taille maximale de collecte de journaux de 60 Mo (compressés) ou 25 fichiers, selon la première éventualité.
  • Les types de fichiers autorisés pour la collecte des journaux incluent les extensions suivantes : .log, .zip, .gz, .tar, .txt, .xml, .crash, .rtf.

Collecter les journaux d’activité de l’appareil

  1. Connectez-vous au Centre d’administration Microsoft Intune.

  2. Accédez à Appareils>Gérer les appareils>Scripts et corrections Scripts> deplateforme et sélectionnez un script shell macOS.

  3. Dans le rapport status d’appareil ou status utilisateur, sélectionnez un appareil.

  4. Sélectionnez Collecter les journaux et entrez les chemins d’accès aux dossiers des fichiers journaux séparés uniquement par un point-virgule (;) sans espaces ni nouvelle ligne entre les chemins.

    Par exemple, écrivez plusieurs chemins d’accès sous la forme /Path/to/logfile1.zip;/Path/to/logfile2.log.

    Importante

    L’utilisation de virgules, de points, de nouvelles lignes ou de guillemets avec ou sans espaces pour séparer plusieurs chemins d’accès au fichier journal provoque une erreur de collection du journal. N’utilisez pas d’espaces comme séparateurs entre les tracés.

  5. Sélectionnez OK. L’agent de gestion Intune sur l’appareil collecte les journaux lors de sa prochaine vérification auprès d’Intune. Cette case activée a généralement lieu toutes les 8 heures.

    Remarque

    • L’appareil chiffre les journaux collectés, les transmet et les stocke dans le stockage Microsoft Azure pendant 30 jours. Le Centre d’administration Microsoft Intune déchiffre et télécharge les journaux stockés à la demande.
    • Outre les journaux spécifiés par l’administrateur, l’agent de gestion d’Intune collecte également des journaux à partir des dossiers suivants : /Library/Logs/Microsoft/Intune et ~/Library/Logs/Microsoft/Intune. Les noms du fichier journal de l’agent sont IntuneMDMDaemon date--time.log et IntuneMDMAgent date--time.log.
    • Si un fichier spécifié par l’administrateur est manquant ou a une extension de fichier incorrecte, recherchez les noms de fichiers suivants dans LogCollectionInfo.txt.

Erreurs de collecte du journal

La collecte des journaux peut échouer pour l’une des raisons suivantes. Pour résoudre ces erreurs, suivez les étapes de correction.

Code d’erreur (hexadécimal) Code d’erreur (dec) Message d’erreur Procédure de correction
0X87D300D1 2016214834 La taille du fichier journal ne doit pas dépasser 60 Mo. Assurez-vous que les journaux compressés sont d’une taille inférieure à 60 Mo.
0X87D300D1 2016214831 Le chemin d’accès au fichier journal fourni doit exister. Le dossier utilisateur système est un emplacement non valide pour les fichiers journaux. Vérifiez que le chemin d’accès au fichier fourni est valide et accessible.
0X87D300D2 2016214830 Le chargement du fichier de collection du journal a échoué en raison de l’expiration de l’URL de chargement. Relancez l’action Collecter les journaux .
0X87D300D3, 0X87D300D5 0X87D300D7 2016214829, 2016214827, 2016214825 Le chargement du fichier de collection du journal a échoué en raison d’un échec de chiffrement. Réessayez le chargement du journal. Relancez l’action Collecter les journaux .
2016214828 Le nombre de fichiers journaux a dépassé la limite autorisée de 25 fichiers. Vous pouvez collecter jusqu’à 25 fichiers journaux à la fois.
0X87D300D6 2016214826 Le chargement du fichier de collection du journal a échoué en raison d’une erreur zip. Réessayez le chargement du journal. Relancez l’action Collecter les journaux .
2016214740 Les journaux n’ont pas pu être chiffrés, car les journaux compressés sont introuvables. Relancez l’action Collecter les journaux .
2016214739 Les journaux ont été collectés mais n’ont pas pu être stockés. Relancez l’action Collecter les journaux .

Attributs personnalisés pour macOS

Vous pouvez créer des profils d’attribut personnalisés qui vous permettent de collecter des propriétés personnalisées à partir d’appareils macOS gérés à l’aide de scripts shell.

Créer et attribuer un attribut personnalisé pour les appareils macOS

  1. Connectez-vous au Centre d’administration Microsoft Intune.

  2. Sélectionner des appareils>par plateforme>macOS>Organiser des appareils>Attributs personnalisés pour macOS>Ajouter

  3. Dans Informations de base, entrer les propriétés suivantes, puis sélectionner Suivant :

    • Nom : entrez un nom pour le script.
    • Description : Entrez une description pour le script. Ce paramètre est facultatif, mais recommandé.
  4. Dans Paramètres d’attribut, entrez les propriétés suivantes, puis sélectionnez Suivant :

    • Type de données de l’attribut : sélectionnez le type de données du résultat retourné par le script. Les valeurs disponibles sont Chaîne, Entier et Date.
    • Script : sélectionnez un fichier script.

    Informations supplémentaires :

    • Le script shell doit faire écho à l’attribut à signaler, et le type de données de la sortie doit correspondre au type de données de l’attribut dans le profil d’attribut personnalisé.
    • Le résultat renvoyé par le script shell doit être inférieur ou égal à 20 Ko.

    Remarque

    Lorsque vous utilisez Date des attributs de type, assurez-vous que le script shell renvoie des dates au format ISO-8601. Reportez-vous aux exemples suivants.

    Pour imprimer une date conforme à la norme ISO-8601 avec le fuseau horaire :

    #!/bin/sh
    var=$(date +"%Y-%m-%dT%H:%M:%S%z")
    echo $var # Prints an ISO-8601 compliant date with time-zone
    

    Pour imprimer une date conforme à la norme ISO-8601 en heure UTC :

    #!/bin/sh
    var=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
    echo $var # Prints an ISO-8601 compliant date in UTC time
    
  5. Dans Devoirs, sélectionnez Sélectionner les groupes à inclure. Lorsque vous choisissez Sélectionner les groupes à inclure, une liste existante de groupes Microsoft Entra s’affiche. Sélectionnez un ou plusieurs groupes d’utilisateurs ou d’appareils pour recevoir le script. Choisir Sélectionner. Les groupes que vous choisissez sont affichés dans la liste. Ils reçoivent votre stratégie de script.

    Vous pouvez également choisir de sélectionner Tous les utilisateurs, Tous les appareils ou Tous les utilisateurs et tous les appareils en sélectionnant l’une de ces options dans la zone de liste déroulante en regard de Attribuer à.

    Remarque

    Les scripts attribués aux groupes d’utilisateurs s’appliquent à tout utilisateur se connectant au Mac.

  6. Dans Passer en revue + ajouter, vous voyez un récapitulatif des paramètres que vous avez configurés. Sélectionnez Ajouter pour enregistrer le script. Lorsque vous sélectionnez Ajouter, la stratégie de script est déployée dans les groupes que vous avez choisis.

Le script que vous avez créé apparaît désormais dans la liste des attributs personnalisés. Affichez le contenu des attributs personnalisés après les avoir téléchargés dans Intune.

Surveiller une stratégie d’attribut personnalisée

Vous pouvez surveiller l’état d’exécution de tous les profils d’attributs personnalisés attribués aux utilisateurs et aux appareils en choisissant l’un des rapports suivants :

  • Attributs> personnalisésSélectionner le profil attributaire personnalisé à surveiller>État de l’appareil
  • Attributs> personnalisésSélectionner le profil attributaire personnalisé à surveiller>Statut de l’utilisateur

Importante

Les scripts shell fournis dans les profils d’attribut personnalisés s’exécutent toutes les 8 heures sur les Mac gérés et signalent leur état.

Lorsqu’un profil attributaire personnalisé est exécuté, il retourne l’un des états suivants :

  • L’état Échec indique que le script a renvoyé un code de sortie différent de zéro ou qu’il est incorrect. L’erreur est signalée dans la colonne Résultat .
  • Un état de réussite indique que le script a renvoyé zéro comme code de sortie. La sortie répercutée par le script est indiquée dans la colonne Résultat .

Foire aux questions

Pourquoi les scripts shell assignés ne s’exécutent-ils pas sur l’appareil ?

Plusieurs raisons peuvent causer ce problème :

  • L’agent devra peut-être s’enregistrer pour recevoir des scripts nouveaux ou mis à jour. Ce processus d’enregistrement a lieu toutes les 8 heures et est différent de l’enregistrement GPM. Assurez-vous que l’appareil est éveillé et connecté à un réseau pour que l’enregistrement de l’agent réussisse et attendez que l’agent s’enregistre. Vous pouvez également demander à l’utilisateur final d’ouvrir le portail d’entreprise sur le Mac, de sélectionner l’appareil, puis de sélectionner Vérifier les paramètres.
  • L’agent n’est peut-être pas installé. Vérifiez que l’agent est installé /Library/Intune/Microsoft Intune Agent.app sur l’appareil macOS.
  • L’agent n’est peut-être pas dans un état sain. L’agent tente de récupérer pendant 24 heures, de se supprimer et de se réinstaller si les scripts shell sont toujours affectés.

À quelle fréquence l’état d’exécution du script est-il signalé ?

L’état de l’exécution du script est signalé au centre d’administration Microsoft Intune dès que l’exécution du script est terminée. Si un script est planifié pour s’exécuter régulièrement à une fréquence définie, il signale uniquement l’état la première fois qu’il s’exécute.

Quand les scripts shell sont-ils à nouveau exécutés ?

Lorsqu’un script renvoie un code de sortie différent de zéro, Intune le réessaie en fonction du nombre maximal de tentatives en cas d’échec du script . Si ce paramètre n’est pas configuré, Intune ne retente pas l’exécution ayant échoué et signale son status comme ayant échoué. Les scripts avec une fréquence configurée peuvent également s’exécuter à nouveau comme prévu ou après un redémarrage de l’appareil.

Quelles autorisations de rôle Intune sont requises pour les scripts shell ?

Votre rôle Intune affecté a besoin d’autorisations de configuration des appareils pour supprimer, affecter, créer, mettre à jour ou lire les scripts shell.

Problèmes connus

  • Aucun status d’exécution de script : si l’appareil reçoit un script, mais passe hors connexion avant d’avoir signalé le status d’exécution, l’appareil ne signale pas le status d’exécution du script dans le Centre d’administration.

Informations supplémentaires

Lorsque vous déployez des scripts shell ou des attributs personnalisés pour les appareils macOS à partir de Microsoft Intune, vous déployez la nouvelle version universelle de l’application Intune Management Agent qui s’exécute en mode natif sur les machines Mac Apple Silicon. Le même déploiement installe la version x64 de l’application sur les ordinateurs Intel Mac.

Vous avez besoin de Rosetta 2 pour exécuter la version x64 (Intel) des applications sur les Mac Apple Silicon. Pour installer automatiquement Rosetta 2 sur les Mac Apple Silicon, vous pouvez déployer un script shell dans Intune. Pour afficher un exemple de script, reportez-vous à la section Script d’installation de Rosetta 2.

Étape suivante