---
title: Actions : Pas à pas
slug: neurons/help/fr_fr/actions-pas-a-pas
createdAt: 2026-09-08T03:52:39.316Z
---

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](https://docs.ivanti.com/neurons/help/fr_fr/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)](https://docs.ivanti.com/neurons/help/fr_fr/fonctionnalites-agent-policy-strategie-dagent) » 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](https://docs.ivanti.com/neurons/help/fr_fr/access-control#Roles) ».

## 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 :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/Jw8vLA-Am5XjpMacSlQOV_real-time-icon-settings.png" alt="Icône Paramètres" caption size="10" width="35" height="35"} 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).

         :::hint{type="info"}
         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 :

         ```powershell
         $ServiceName = "$(var.placeholder)" Restart-Service-Name $ServiceName-Force-ErrorAction Stop
         ```

         :::hint{type="success"}
         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 :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/m4-PunoTTGcRK-L3QcX1L_real-time-icon-copy.png" alt="Copier vers le Presse-papiers" caption="Copier vers le Presse-papiers" size="10" width="28" height="32"}. 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 :

         ```powershell
         $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).

         :::hint{type="success"}
         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.

:::Paragraph{indent="2"}
Le résultat doit ressembler à l'image ci-dessous.
:::

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/BDl4ToGeiKxG7LCxLdIdz_real-time-config-action-result.png" alt="Résultat de la configuration. Deux tâches figurent dans la section Tâches et trois variables apparaissent dans la section Variables." position="flex-start" size="80" width="1734" height="1479" initialPath="Images/real-time-config-action-result.png" githubPath="FRA/Images/real-time-config-action-result.png" showCaption="false" indent="3"}

:::Paragraph{listStyleType="decimal" listStart="5" indent="2"}
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.

      :::hint{type="success"}
      Vous pouvez copier une marque de réservation à l'aide de l'icône :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/m4-PunoTTGcRK-L3QcX1L_real-time-icon-copy.png" alt="Copier" caption="Copier" size="10" width="28" height="32"} 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 (:inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/I8DKhRemegW0qF9u6qK1M_general-options-menu.png" alt="Icône de menu d'options" caption size="10" width="4" height="12"}) 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.

:::hint{type="danger"}
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.
:::

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/lGoVgSyfSfmlCu4BMjoV7_service-state-edge-intelligence.png" position="flex-start" size="80" width="1616" height="561" initialPath="Images/Service-state-Edge-Intelligence.png" githubPath="FRA/Images/Service-state-Edge-Intelligence.png" showCaption="false"}

## 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](https://docs.ivanti.com/neurons/help/fr_fr/actions-pas-a-pas#CreateFromConfPanel) », 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 :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/ap3i1LpLK67qz6EwR7Nau_real-time-icon-toggle-view.png" alt="Icône Basculer la vue" caption size="10" width="68" height="35"} pour passer à la vue de liste.
3. Ouvrez le menu d'options ( :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/I8DKhRemegW0qF9u6qK1M_general-options-menu.png" alt="Icône de menu d'options" caption size="10" width="4" height="12"} ) 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 :

         ```powershell
         $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 :

         ```powershell
         $ServiceName ="$(query.name)" Restart-Service-Name $ServiceName-Force-ErrorAction Stop
         ```

         :::hint{type="success"}
         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 :
