Actions : Pas à pas

Cette rubrique contient des instructions pas à pas permettant de créer des actions Edge Intelligence, et de les lier à une requête ou à une alerte. Elle explique aussi comment utiliser des variables d'action, des marques de réservation ou des données de requête dans votre action.

Prérequis

  • Agent Ivanti Neurons installé sur les postes client où exécuter des requêtes ou définir des alertes. Reportez-vous à « Agent Ivanti Neurons ».
  • Les postes client doivent posséder une stratégie où la fonctionnalité Edge Intelligence est activée. Reportez-vous à « Fonctionnalités Agent Policy (Stratégie d'agent) » dans la stratégie.
  • Rôle doté des permissions nécessaires pour configurer des actions, exécuter des actions et définir des alertes pour Edge Intelligence. Reportez-vous à « Rôles ».

Créer une action de requête personnalisée depuis le volet Configuration Edge Intelligence

Dans cet exemple, vous allez ajouter une action à la requête État du service pour redémarrer un service. L'action utilise un script PowerShell, avec une marque de réservation pour les informations récupérées par la requête. Une fois le service redémarré, l'utilisateur est averti.

  1. Accédez à Insights > Edge Intelligence, puis cliquez sur Icône Paramètres dans l'angle supérieur droit de la page.
    Le volet Configuration Ivanti Edge Intelligence apparaît.

  2. Dans l'onglet Actions, sélectionnez Ajouter une nouvelle action.
    La page Nouvelle action s'ouvre dans le volet.

    1. Spécifiez un nom pour l'action, par exemple Redémarrer le service.
    2. Dans la section Variables, sélectionnez Ajouter une nouvelle variable.
      Le volet Nouvelle variable apparaît.
      1. Spécifiez un nom pour la variable, par exemple ServiceName (Nom de service).

        Pour illustrer cela, les noms spécifiés pour les variables dans notre exemple sont identiques à ceux des variables générées automatiquement dans l'exemple suivant. Ce n'est pas une obligation.

      2. Ne spécifiez pas de valeur. Elle sera fournie par la requête.
      3. Gardez l'option Variable publique activée. Cela permet de définir la valeur de la variable pendant l'exécution de l'action.
      4. Cliquez sur Enregistrer.
        La variable est enregistrée et le volet Nouvelle variable se ferme.
    3. Dans la section Tâches, sélectionnez Ajouter une nouvelle tâche.
      Le volet Nouvelle tâche apparaît.
      1. Spécifiez un nom pour la tâche, par exemple Redémarrer le service.
      2. Dans la section inférieure, cliquez sur Sélectionner pour afficher la liste des tâches disponibles. Sélectionnez Exécuter PowerShell.
      3. Dans le champ Script qui apparaît, insérez votre script PowerShell (brouillon).
        Dans notre exemple :
        Copier
        $ServiceName = "$(var.placeholder)" Restart-Service-Name $ServiceName-Force-ErrorAction Stop

        Si vous êtes sûr de connaître l'orthographe exacte du texte qui doit remplacer la marque de réservation $(var.placeholder), vous pouvez entrer ou coller directement la version finale dans le champ Script. Dans ce cas, vous pouvez passer directement à l'étape vi.

      4. Dans la section Marques de réservation disponibles (sous le champ Script), copiez $(action.ServiceName) en cliquant sur Copier vers le Presse-papiers. Il s'agit de la variable ServiceName créée à l'étape 2b.
      5. Dans le champ Script, remplacez $(var.placeholder) par la marque de réservation copiée à l'étape iv.
        Le bot doit maintenant ressembler à ceci :
        Copier
        $ServiceName = "$(action.ServiceName)" Restart-Service-Name $ServiceName-Force-ErrorAction Stop
      6. Cliquez sur Enregistrer.
        La tâche est enregistrée et le volet Nouvelle tâche se ferme.
    4. Dans la section Tâches, sélectionnez de nouveau Ajouter une nouvelle tâche.
      Le volet Nouvelle tâche apparaît.
      1. Spécifiez un nom pour la tâche, par exemple Notifier l'utilisateur final.
      2. Dans la section inférieure, cliquez sur Sélectionner pour afficher la liste des tâches disponibles. Sélectionnez Notifier l'utilisateur.
      3. Dans le champ Objet qui s'affiche, entrez (par exemple) Service redémarré avec succès : $(action.ServiceName).

        Là aussi, les marques de réservation sont répertoriées sous les champs propres à la tâche dans le volet Nouvelle tâche ; ici, ce sont les champs Objet et Message.

      4. Dans le champ Message, entrez le corps du message à envoyer à l'utilisateur. Par exemple :
        Cher utilisateur,

        Le service suivant a été redémarré avec succès :
        $(action.ServiceName)

        Cordialement,
        L'équipe IT
      5. Cliquez sur Enregistrer.
        La tâche est enregistrée et le volet Nouvelle tâche se ferme.

      Le résultat doit ressembler à l'image ci-dessous.
      Résultat de la configuration. Deux tâches figurent dans la section Tâches et trois variables apparaissent dans la section Variables.

    5. Cliquez sur Enregistrer.
      L'action est enregistrée et la page Nouvelle action se ferme.
  3. Dans l'onglet Requêtes du volet Configuration Edge Intelligence, repérez la requête État du service et cliquez sur son nom.
    La page de détails de la requête s'ouvre dans le volet et présente une vue d'ensemble des actions liées.
    1. Dans la section Actions, sélectionnez Ajouter une action.
      Le volet Ajouter une action s'ouvre.
    2. Dans la liste déroulante, sélectionnez Redémarrer le service, c'est-à-dire le nom de l'action créée à l'étape 2a-e.
      La section Données d'action (qui répertorie les variables créées à l'étape 2b) et la section Marques de réservation disponibles (qui répertorie les données récupérées par la requête) apparaissent.
      1. Dans la section Action, sous Nom :
        • Pour Type, sélectionnez Utiliser la valeur suivante.
        • Pour Valeur, spécifiez $(query.name), marque de réservation correspondant à ServiceName.

      Vous pouvez copier une marque de réservation à l'aide de l'icône Copier figurant près de la définition de cette marque de réservation.

    3. Cliquez sur Ajouter pour enregistrer vos modifications.
      Le volet Ajouter une action se ferme.
  4. Cliquez sur Fermer.
    Le volet Configuration Ivanti Edge Intelligence se ferme.

L'action Redémarrer le service est désormais disponible pour utilisation :

  1. Exécutez la requête État du service.
  2. Dans la liste des résultats de requête, repérez la ligne contenant les valeurs Nom d'ordinateur et Nom de service voulues.
    (Facultatif) Vous pouvez utiliser pour ce faire des filtres et/ou des paramètres.
  3. Ouvrez le menu d'options (Icône de menu d'options) de la ligne sélectionnée et choisissez Redémarrer le service.
    1. L'action redémarre le service et les résultats de la requête État du service sont mis à jour.
    2. La notification créée à l'étape 2d est affichée pour l'utilisateur final.

Si vous sélectionnez le menu d'actions au niveau de la requête (surligné en rouge dans l'image suivante) au lieu du menu de niveau enregistrement (surligné en vert), Edge Intelligence applique l'action à tous les enregistrements figurant dans les résultats de requête. Selon vos paramètres de requête, cela peut provoquer le redémarrage de tous les services de chaque périphérique de votre environnement. Soyez prudent lorsque vous utilisez des actions de niveau requête (query-level) et vérifiez toujours les actions personnalisées nouvellement créées dans un environnement de test ou de laboratoire, avant de les déployer en production.

Créer une action rapide avec le volet « Gérer les actions de la requête »

Dans cet exemple, vous allez ajouter une action similaire à celle de l'exemple « Créer une action de requête personnalisée depuis le volet Configuration Edge Intelligence », mais sous forme d'action rapide. Cela automatise une partie des étapes de configuration.

  1. Accédez à Insights > Edge Intelligence, et ouvrez la requête État du service (dans la catégorie Inventaire).
    Le widget de requête État du service s'affiche.
  2. Utilisez la bascule Icône Basculer la vue pour passer à la vue de liste.
  3. Ouvrez le menu d'options ( Icône de menu d'options ) et sélectionnez Gérer.
    Le volet Gérer les actions pour la requête État du service s'affiche. Il contient la liste des actions liées.
  4. Sélectionnez Créer une action rapide.
    Le volet Créer une action rapide s'affiche.
    1. Spécifiez un nom d'action, comme Action rapide Redémarrer le service.
    2. Sélectionnez la tâche Exécuter PowerShell.
      La tâche sélectionnée est ajoutée sous Tâches et des champs de configuration supplémentaires pour cette tâche apparaissent.
      1. Dans le champ Script, insérez votre script PowerShell (brouillon).
        Dans notre exemple :
        Copier
        $ServiceName = "$(var.placeholder)'" Restart-Service-Name $ServiceName-Force-ErrorAction Stop
      2. Dans le champ Script, sélectionnez $(var.placeholder) et cliquez sur la marque de réservation Programme, sous Marques de réservation disponibles.
        La marque de réservation est insérée et le script doit maintenant ressembler à ceci :
        Copier
        $ServiceName ="$(query.name)" Restart-Service-Name $ServiceName-Force-ErrorAction Stop

        Vous pouvez insérer des marques de réservation à mesure que vous saisissez le script.

    3. Sélectionnez Ajouter une autre tâche.
      La liste des tâches disponibles s'affiche.
    4. Sélectionnez la tâche Notifier l'utilisateur.
      La tâche sélectionnée est ajoutée sous Tâches et des champs de configuration supplémentaires pour cette tâche apparaissent.
      1. Spécifiez un objet et un message pour la notification. Vous pouvez utiliser des marques de réservation dans ces champs.
    5. Cliquez sur Enregistrer.
      Le volet Créer une action rapide se ferme et le volet Gérer les actions pour la requête État du service redevient visible. Votre nouvelle action apparaît sous Actions liées.
  5. Cliquez sur Fermer.
    Le volet Gérer les actions pour la requête État du service se ferme.

L'action rapide Redémarrer le service est désormais disponible pour utilisation :