Introduction
Le module Scripts de la plate-forme HP Workforce Experience Platform (WXP) vous permet de déployer des scripts PowerShell 5.1 personnalisés sur des groupes de périphériques gérés. Cette fonctionnalité est actuellement disponible pour Windows 10 et Windows 11 et permet d’automatiser les tâches administratives de routine sur votre parc d’appareils.
Note:
La fonctionnalité Scripts est actuellement en version bêta. Certaines fonctionnalités avancées, telles que l’édition et la suppression de scripts, sont prévues dans les versions futures.
Cet article fournit une étape par étape pour aborder les sujets suivants :
Accès à la bibliothèque de scripts, y compris l’ajout d’un script à une bibliothèque et l’affichage des détails du script dans la bibliothèque.
Accès à la galerie de scripts, y compris l’affichage des détails du script dans la galerie.
Accès aux affectations, y compris la création d’une nouvelle affectation
Accès à la bibliothèque de scripts
Connectez-vous à WXP La page d’accueil s’affiche.
Dans le menu de gauche, cliquez sur Corrections > scripts. La page Scripts s’affiche avec trois onglets :
Bibliothèque (par défaut) : Affiche tous les scripts disponibles créés ou téléchargés par les utilisateurs.
Attributions : lie un script PowerShell à un ou plusieurs groupes d’appareils pour une exécution manuelle ou planifiée.
Galerie : Affiche des scripts sélectionnés fournis par HP.
Dans l’onglet Bibliothèque , les colonnes suivantes s’affichent :
du champ | |
|---|---|
Nom du script | Nom du script. |
Version | Numéro de version du script. |
Créé par | L’utilisateur qui a créé le script. |
Synopsis | Une brève description du scénario. |
Opération | Indique s’il s’agit d’une action ou d’une évaluation. |
Les colonnes facultatives sont les suivantes :
du champ | |
|---|---|
Script ID | Un identifiant unique attribué à chaque script. |
Exécuter en tant que | Indique le contexte ou l’utilisateur qui exécutera le script. Les options sont Système ou Utilisateur . |
Environnement hôte | Spécifie si le script s’exécute dans un environnement 32 bits ou 64 bits. |
Politique d’exécution | Détermine les règles d’exécution de script telles que Bypass ou Client Default. |
Utilisez l’icône d’engrenage (Options de colonne) pour ajouter des colonnes afin de supprimer des colonnes de la vue par défaut. Cliquez sur Rétablir les paramètres par défaut pour restaurer la vue par défaut.
Ajout d’un script à la bibliothèque
Dans le menu de gauche de WXP, cliquez sur Corrections > scripts. L’onglet Bibliothèque s’affiche par défaut.
Cliquez sur Ajouter un script. La boîte de dialogue Ajouter un script s’affiche.
À l’étape 1 de 3, fournissez les éléments suivants :
Téléchargement de fichier .ps1 : chargez le fichier de script PowerShell 5.1.
Type d’opération : choisissez Action pour déclencher une modification ou Évaluation pour évaluer sans apporter de modifications.
À l’étape 2 sur 3, définissez les propriétés d’exécution :
Exécuter en tant que : sélectionnez Système ou Utilisateur connecté pour déterminer le contexte d’exécution.
Environnement hôte : sélectionnez 32 bits ou 64 bits pour correspondre à la plate-forme d’exécution des périphériques cibles.
Stratégie d’exécution : choisissez Ignorer ou Par défaut du client. Le contournement n’est pas pris en charge sur Tous les signés.
Note: Utilisez Client Default pour exécuter des scripts signés à l’aide d’un éditeur approuvé.
À l’étape 3 sur 3, entrez les métadonnées du script :
Nom du script : nom unique et descriptif du script.
Version du script : numéro de version.
Synopsis : Un bref résumé de ce que fait le script.
Description : Explication détaillée de l’objectif du script.
Cliquez sur Ajouter pour enregistrer le script. Une fenêtre contextuelle affiche le succès ou l’échec.
Note: Les scripts doivent être attribués via l’onglet Affectations . L’édition de script n’est actuellement pas prise en charge.
Prise en charge des paramètres dans les scripts
Les scripts WXP prennent en charge l’ajout de paramètres d’entrée aux scripts PowerShell. Cette fonctionnalité aide les clients et les partenaires à créer des scripts personnalisables et réutilisables sur l’ensemble de leur parc.
Pour attribuer des paramètres à un script :
Dans Scripts Overview, accédez à Parameters et cliquez sur Add Parameter.
Saisissez le nom, le type et la valeur du paramètre. Notez que :
Jusqu’à cinq paramètres sont pris en charge.
Les types pris en charge sont String, Integer, Boolean et Switch.
Cliquez sur Save.
La vue Scripts affiche tous les paramètres définis dans le script. Les paramètres doivent être spécifiés ici avant de créer une affectation. Une fois créée, l’assistant d’affectation affiche une page supplémentaire vous invitant à confirmer ou à remplacer toute valeur par défaut spécifiée pour vos paramètres.
Afficher les détails du script dans la bibliothèque
Dans le menu de gauche de WXP, cliquez sur Corrections > Scripts > Bibliothèque.
Cliquez sur le nom d’un script pour ouvrir ses détails. Trois onglets s’affichent : Vue d’ensemble (par défaut), Affectations et Activité.
Onglet Vue d’ensemble
Section | Champs de section |
|---|---|
Informations sur le script | Synopsis, description, création par, date de dernière modification et version |
Propriétés d’exécution | Type d’opération, environnement hôte, Exécuter en tant que, Stratégie d’exécution |
Contenu du script | Affiche le code PowerShell brut. |
Onglet Affectations
Champ | Description |
|---|---|
Statut | État actuel de l’affectation (p. ex., non prévu). |
Synopsis | Objectif du script dans ce contexte. |
Opération | Action ou évaluation. |
Nom de l’attribution | Nom de l’instance de déploiement. |
Groupe | Groupes de périphériques affectés au script. |
Onglet Activité
Champ | Description |
|---|---|
Initié le | Horodatage de l’exécution du script. |
Nom de la correction | Nom de l’instance d’exécution. |
Opération | Indique si l’exécution était une action ou une évaluation. |
Initié par | Utilisateur qui a déclenché le script. |
Statut | État actuel (p. ex., terminé, en cours). |
Utilisez l’icône d’engrenage (Options de colonne) pour ajouter ou supprimer des colonnes de la vue par défaut.
Filtres et tri
Utilisez la zone de recherche de chaque colonne pour rechercher des scripts par nom de conversion, opération, initié par ou état.
Triez les résultats par Initié le.
Accès à la galerie de scripts
Dans le menu de gauche de WXP, cliquez sur Corrections > Scripts > Galerie. L’onglet Galerie s’affiche et affiche des modèles de script sélectionnés par HP. Les colonnes suivantes s’affichent :
Champ | Description |
|---|---|
Statut | Indique la disponibilité ou l’état du script. |
Dernière mise à jour | Date de la dernière modification. |
Nom du script | Nom du script prédéfini. |
Version | Numéro de version du script. |
Créé par | Auteur (HP ou interne). |
Type d’opération | Indique le type d’action ou d’évaluation. |
Utilisez l’icône d’engrenage (Options de colonne) pour ajouter ou supprimer des colonnes.
Affichage des détails du script dans la galerie
Dans le menu de gauche de WXP, cliquez sur Corrections > Scripts > galerie. L’onglet Galerie s’affiche.
Dans l’onglet Galerie, cliquez sur un nom de script. La page de détails du script s’affiche et affiche les détails suivants :
Section | Champs de section |
|---|---|
Informations sur le script | Synopsis, Description, Créé par, Dernière modification, Version |
Propriétés d’exécution | Type d’opération, environnement hôte, architecture, exécution en tant que, politique d’exécution |
Contenu du script | Code source PowerShell complet |
Note:
Pour utiliser un script Galerie, créez une attribution et définissez des groupes cibles dans le workflow.
Accès aux devoirs
Dans le menu de gauche de WXP, cliquez sur Corrections > Scripts > Affectations. L’onglet Attributions s’affiche et affiche les détails suivants
Champ | Description |
|---|---|
Nom de l’attribution | Nom de l’attribution de script. |
Script attribué | Nom du script associé. |
Groupes cibles | Groupes de périphériques affectés au script. |
Auteur | Créateur de la mission. |
Statut | Statut actuel de l’affectation. Par exemple, Programmé, Non programmé. |
Des devoirs sont nécessaires pour appliquer des scripts de la bibliothèque aux appareils.
Création d’un nouveau devoir
Dans le menu de gauche de WXP, cliquez sur Corrections > Scripts > Affectations. L’onglet Affectations s’affiche .
Dans l’onglet Attributions , cliquez sur Ajouter. La boîte de dialogue Ajouter une affectation de script s’affiche, indiquant l’étape 1 sur 4 pour saisir les détails de base :
Auteur : Rempli automatiquement avec le nom d’utilisateur connecté.
Nom de l’affectation : Entrez un nom significatif pour l’affectation.
Description : expliquez l’objectif du déploiement du script.
Cliquez sur Suivant. L’étape 2 sur 4 s’affiche pour sélectionner un script.
Choisissez un script dans la liste. Vous pouvez également utiliser la barre de recherche pour trouver le bon script.
Cliquez sur Suivant. L’étape 3 sur 4 s’affiche pour sélectionner les groupes cibles.
Utilisez les cases à cocher pour sélectionner un ou plusieurs groupes.
Cliquez sur Suivant. L’étape 4 sur 4 s’affiche pour examen.
Examinez le script et les groupes cibles sélectionnés.
Cliquez sur Terminer. Une fenêtre contextuelle s’affiche pour indiquer la réussite ou l’échec.
La nouvelle attribution peut être affichée dans l’onglet Affectations avec le statut Non planifié.
Exécution d’une affectation
Dans le menu de gauche de WXP, cliquez sur Remediations > Scripts > Assignments. L’onglet Assignments s’affiche.
Dans l’onglet Assignments, cliquez sur un Assignment Name pour accéder à la page Assignment Details.
Depuis la page Assignment Details, vous pouvez exécuter une affectation immédiatement en cliquant sur le bouton Run dans le coin supérieur droit, ou faire défiler jusqu’en bas de la page et cliquer sur Add Schedule pour planifier l’exécution de l’affectation, soit une seule fois, soit de manière récurrente.
Contactez-nous
Si vous rencontrez des problèmes, créez une demande d’assistance ou envoyez un e-mail support@wxp.hp.comà .