Automatiser les configurations de point de terminaison avec des scripts.

Utilisez des Scripts pour exécuter le code PowerShell pour les configurations de point de terminaison sur les terminaux Windows Desktop et Windows Server à l'aide de Workspace ONE UEM.

Description des Scripts

Les Scripts, situés dans la navigation principale sous Ressources, permettent de transférer du code vers des terminaux Windows pour exécuter divers processus. Par exemple, vous pouvez déployer un script PowerShell qui invite les utilisateurs à redémarrer leur terminal.

Utilisez des variables dans vos scripts pour protéger les données statiques sensibles, telles que les mots de passe et les clés d'API, ou utilisez des valeurs de recherche pour les données dynamiques telles que l'ID de terminal et le nom d'utilisateur. Vous pouvez également autoriser vos utilisateurs Windows à accéder à ce code pour qu'ils puissent l'exécuter sur leurs terminaux lorsque cela est nécessaire. Pour rendre le code disponible, intégrez Workspace ONE Intelligent Hub aux Scripts de sorte que les utilisateurs puissent accéder au code dans la zone Applications du catalogue.

Important : Les Scripts ne sont pas autorisés à être attribués à des terminaux personnels pour des raisons de confidentialité.

Comment savoir si vos scripts s'exécutent avec succès

Vous pouvez déterminer si les Scripts s'exécutent avec succès à partir de l'onglet Scripts de la page Détails du terminal. Dans Workspace ONE UEM Console, accédez au groupe organisationnel applicable, sélectionnez Terminaux > Affichage en liste, puis sélectionnez le terminal applicable. Dans l'onglet Scripts, dans la colonne État, recherchez l'état Exécuté ou Échec. Les états dépendent du code de sortie (également appelé code d'erreur ou code de retour).

• Exécuté : Workspace ONE UEM affiche cet état lorsque le code de sortie renvoie 0.
• Échec : Workspace ONE UEM affiche cet état lorsque le code de sortie renvoie une valeur différente de 0.

Créer un script pour les terminaux Windows

Les scripts prennent en charge l'utilisation de PowerShell pour exécuter du code sur les terminaux des utilisateurs finaux. Intégrez des Scripts à Workspace ONE Intelligent Hub pour Windows et activez le libre-service pour les Scripts de vos utilisateurs.

Remarque : Si vous publiez des scripts sur moins de 2000 terminaux (valeur par défaut), les terminaux sont immédiatement invités à extraire la ressource. Cependant, si les Smart Group attribués disposent de plus de 2000 terminaux, les terminaux recevront la ressource la prochaine fois qu'ils se connecteront à Workspace ONE UEM Console.

Procédure

1. Accédez à Ressources > Scripts > Ajouter.

2. Sélectionnez Windows.

3. Configurez les paramètres des scripts dans l'onglet Général.

   | Paramètre | Description | |---------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Nom | Entrez le nom du script. | | Description | Entrez la description du script. | | Personnalisation du catalogue d'applications | Activez l'offre d'accès en libre-service aux Scripts dans le catalogue de Workspace ONE Intelligent Hub.
   
   Nom d'affichage : entrez le nom que les utilisateurs voient dans le catalogue.
   Description de l'affichage : entrez une brève description de l'action du script.
   Icône : téléchargez une icône pour le script.
   Catégorie : sélectionnez une catégorie pour le script. Les catégories aident les utilisateurs à filtrer les applications dans le catalogue.
   
   Bien que vous ayez fini de configurer les paramètres du script dans le catalogue, une autre configuration doit être définie pour afficher votre script dans Workspace ONE Intelligent Hub. Lorsque vous attribuez le script à des terminaux, activez l'élément de menu Afficher dans le Hub pour que ces personnalisations s'affichent dans le catalogue. |

4. Configurez les paramètres du script dans l'onglet Détails.

   Paramètre	Description
   Langue	Workspace ONE UEM prend en charge PowerShell.
   Contexte d'exécution	Ce paramètre contrôle si le script s'exécute dans le contexte utilisateur ou système.
   Architecture d'exécution	Ce paramètre contrôle si le script s'exécute sur un terminal basé sur l'architecture. Vous pouvez limiter l'exécution du script sur les terminaux 32 bits ou 64 bits uniquement ou exécuter le script en fonction de l'architecture du terminal. Vous pouvez également forcer le script à s'exécuter en 32 bits, quel que soit le terminal.
   Délai d'expiration	Si le script s'exécute en boucle ou qu'il ne répond pas pour une raison quelconque, entrez la durée en secondes pendant laquelle le système doit exécuter le script avant de l'arrêter.
   Code	Téléchargez un script ou écrivez-en un dans la zone de texte fournie.

5. Sélectionnez Suivant pour configurer l'onglet Variables.
   
   Ajoutez des valeurs statiques, telles que des clés d'API, des noms de compte de service ou un mot de passe, en indiquant la clé et la valeur de la variable. Vous pouvez aussi ajouter des valeurs dynamiques telles que enrollmentuser en indiquant une clé, puis en sélectionnant l'icône de valeur de recherche. Pour utiliser des variables dans un script, référencez-les à l'aide de $env:key. Par exemple, si la définition de la variable comprend une clé nommée SystemAccount et la valeur admin01, le script peut attribuer la variable à un compte de variable de script nommé via la référence $account = $env:SystemAccount.

6. Pour attribuer des Scripts à des terminaux, sélectionnez le script, choisissez Attribuer, puis sélectionnez Nouvelle attribution.

7. Dans l'onglet Définition, entrez le Nom de l'attribution et utilisez l'élément de menu Sélectionner un Smart Group pour sélectionner le groupe de terminaux auxquels vous souhaitez envoyer les Scripts.

8. Dans l'onglet Déploiement, pour Déclencheurs, sélectionnez le déclencheur qui démarre le script. Vous pouvez sélectionner plusieurs déclencheurs.

9. Activez Afficher dans le Hub pour afficher les paramètres de Personnalisation du catalogue d'applications pour le script dans Workspace ONE Intelligent Hub. Vous pouvez désactiver cette option pour masquer un script aux utilisateurs du catalogue. Cette option n'est valide qu'avec les terminaux Windows Desktop.

Étapes suivantes

Accédez à l'onglet Scripts dans les Détails du terminal d'un terminal pour afficher l'état de vos Scripts.

État d'exécution en temps réel pour les scripts et les workflows à la demande

Sur Windows, les scripts et les workflows à la demande lancés à partir du catalogue d'applications Intelligent Hub fournissent des mises à jour de l'état en temps réel. Au lieu d'attendre la prochaine synchronisation ou d'actualiser manuellement, les utilisateurs peuvent voir immédiatement si un script ou un workflow est lancé, en cours d'exécution, a échoué ou s'est terminé dans la zone du titre ou de l'action du catalogue d'applications. Les mises à jour de l'état sont reflétées en direct à mesure que l'agent Windows signale la progression à l'Intelligent Hub.

Cet affichage de l'état en temps réel offre de la transparence aux utilisateurs finaux exécutant des scripts de dépannage ou de configuration depuis le catalogue d'applications en fournissant une visibilité claire et en temps réel sur l'état d'exécution. Lorsque l'état indique si un script est en cours d'exécution, terminé ou en échec, il réduit la confusion de l'utilisateur et évite les exécutions en double causées par l'incertitude sur la progression de la tâche en cours.

Lorsqu'un script est exécuté ou installé, Intelligent Hub affiche son état d'exécution. Une fois le script terminé, le bouton d'action devient Réexécuter, ce qui permet aux utilisateurs d'exécuter à nouveau le script si nécessaire. Si le script échoue, le bouton reste sur Exécuter et un message Échec de l'installation s'affiche, indiquant que l'opération ne s'est pas terminée correctement.

Lorsqu'un workflow est initié à partir du catalogue d'applications, l'ensemble du workflow s'affiche comme En cours d'exécution tandis que ses étapes, telles que les applications, les profils et les scripts, s'exécutent. Une fois que toutes les étapes sont terminées avec succès, l'état du workflow passe à Réexécuter afin que les utilisateurs puissent relancer le workflow. Si une étape échoue, le workflow est marqué comme Échec, ce qui permet aux utilisateurs de voir facilement que le workflow ne s'est pas terminé comme prévu.