---
title: Aktionen: Schrittweise Anleitungen
slug: neurons/help/de_de/aktionen-schrittweise-anleitungen
createdAt: 2026-09-07T11:44:53.581Z
---

Dieses Thema enthält schrittweise Anleitungen zum Erstellen von Edge Intelligence-Aktionen und zum Verknüpfen dieser Aktionen mit einer Abfrage oder einer Warnung. Außerdem wird die Verwendung von Aktionsvariablen, Platzhaltern und Abfragedaten in Ihrer Aktion erläutert.

## Voraussetzungen

- Der Ivanti Neurons Agent muss auf den Endpunkten installiert sein, die Sie abfragen oder für die Sie Alarme festlegen möchten. Siehe [Ivanti Neurons Agent](https://docs.ivanti.com/neurons/help/de_de/ivanti-neurons-agent).
- Die Endpunkte müssen über eine Richtlinie verfügen, in der die **Funktion** **Edge Intelligence** aktiviert ist. Siehe [Agentenrichtlinien-Funktionen](https://docs.ivanti.com/neurons/help/de_de/agentenrichtlinien-funktionen) in der Richtlinie.
- Es muss eine Rolle mit Berechtigungen zum Konfigurieren und Ausführen von Aktionen sowie zum Festlegen von Alarmen für Edge Intelligence vorhanden sein. Siehe [Rollen](https://docs.ivanti.com/neurons/help/de_de/zugriffskontrolle#Roles).

## Erstellen einer benutzerdefinierten Abfrageaktion über den Edge Intelligence-Konfigurationsbereich

In diesem Beispiel fügen Sie der Abfrage **Servicestatus** eine Aktion hinzu, um einen Dienst neu zu starten. Die Aktion verwendet ein PowerShell-Skript mit einem Platzhalter für die von der Abfrage abgerufenen Informationen. Nachdem der Dienst neu gestartet wurde, wird der Benutzer benachrichtigt.

1. Wechseln Sie zu **Einblicke > Edge Intelligence** und klicken Sie oben rechts auf der Seite auf :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/uW1y-ySy88NnEdQzoj7xh_real-time-icon-settings.png" alt="Symbol für Einstellungen" caption size="10" width="35" height="35"} .
   Der Bereich **Edge Intelligence-Konfiguration** wird angezeigt.
2. Wählen Sie auf der Registerkarte **Aktionen** die Option **Neue Aktion hinzufügen** aus.
   Innerhalb des Bereichs wird die Seite **Neue Aktion** geöffnet.
   1. Geben Sie einen **Namen** für die Aktion an, z. B. *Dienst neustarten*.
   2. Wählen Sie im Abschnitt **Variablen** die Option **Neue Variable hinzufügen** aus.
      Der Bereich **Neue Variable** wird angezeigt.
      1. Geben Sie einen **Namen** für die Variable an, zum Beispiel *Dienstname*.

         :::hint{type="info"}
         Zu Illustrationszwecken sind die angegebenen Namen für die Variablen in diesem Beispiel identisch mit den automatisch generierten Variablen im nächsten Beispiel. Dies ist jedoch keine Voraussetzung.
         :::
      2. Geben Sie keinen **Wert** an. Dieser wird durch die Abfrage bereitgestellt.
      3. Lassen Sie die Option **Öffentliche Variable** aktiviert. Dadurch kann der Wert der Variablen während der Ausführung der Aktion festgelegt werden.
      4. Klicken Sie auf **Speichern**.
         Die Variable wird gespeichert und der Bereich **Neue Variable** wird geschlossen.
   3. Wählen Sie im Bereich **Aufgaben** die Option **Neue Aufgabe hinzufügen** aus.
      Der Bereich **Neue Aufgabe** wird angezeigt.
      1. Geben Sie einen **Namen** für die Aufgabe an, z. B. Dienst neustarten.
      2. Klicken Sie im unteren Bereich auf *Auswählen*, um eine Liste der verfügbaren Aufgaben anzuzeigen. Wählen Sie **PowerShell ausführen** aus.
      3. Fügen Sie in das angezeigte Feld **Skript** Ihr (Entwurfs-)PowerShell-Skript ein.
         In diesem Beispiel:

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

         :::hint{type="success"}
         Wenn Sie die genaue Schreibweise des Textes kennen, der `$(var.placeholder)`ersetzen soll, können Sie die endgültige Version direkt in das Feld **Skript** eingeben oder einfügen. In diesem Fall können Sie direkt mit Schritt vi fortfahren.
         :::
      4. Kopieren Sie im Abschnitt **Verfügbare Platzhalter** (unter dem Feld **Skript**) den Eintrag `$(action.ServiceName)` mithilfe von :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/IiuTXLwNsOMAsfKmYR9Df_real-time-icon-copy.png" alt="In Zwischenablage kopieren" caption="In Zwischenablage kopieren" size="10" width="28" height="32"}. Dies ist die Variable Dienstname, die Sie in Schritt 2b erstellt haben.
      5. Ersetzen Sie im Feld **Skript** den Wert `$(var.placeholder)` durch den Platzhalter, den Sie in Schritt iv kopiert haben.
         Das Skript sollte nun folgendermaßen aussehen:

         ```powershell
         $ServiceName = "$(action.ServiceName)" Restart-Service-Name $ServiceName-Force-ErrorAction Stop
         ```
      6. Klicken Sie auf **Speichern**.
         Die Aufgabe wird gespeichert und der Bereich **Neue Aufgabe** wird geschlossen.
   4. Wählen Sie im Abschnitt **Aufgaben** erneut **Neue Aufgabe hinzufügen** aus.
      Der Bereich **Neue Aufgabe** wird angezeigt.
      1. Geben Sie einen **Namen** für die Aufgabe an, zum Beispiel Endbenutzer benachrichtigen.
      2. Klicken Sie im unteren Bereich auf *Auswählen*, um eine Liste der verfügbaren Aufgaben anzuzeigen. Wählen Sie **Benutzer benachrichtigen** aus.
      3. Geben Sie in das angezeigte Feld **Betreff** zum Beispiel Dienst erfolgreich neugestartet: $(action.ServiceName) ein.

         :::hint{type="success"}
         Die Platzhalter werden wieder unterhalb der aufgabenspezifischen Felder des Bereichs **Neue Aufgabe** aufgelistet, in diesem Fall unterhalb von **Betreff** und **Nachricht**.
         :::
      4. Geben Sie im Feld **Nachricht** den Text der Nachricht ein, die Sie an den Benutzer senden möchten. Zum Beispiel:
         *Lieber Nutzer,*

         *Der folgende Dienst wurde erfolgreich neugestartet:*
         *$(action.ServiceName)*

         *Beste Grüße*
         *Das IT-Team*
      5. Klicken Sie auf **Speichern**.
         Die Aufgabe wird gespeichert und der Bereich **Neue Aufgabe** wird geschlossen.

:::Paragraph{indent="2"}
Das Ergebnis sollte wie im Bild unten aussehen.
:::

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/6f0PzIzaYR0Esd7uY50oJ_real-time-config-action-result.png" alt="Ergebnis der Konfiguration. Im Bereich &#x22;Aufgaben&#x22; sind zwei Aufgaben und im Bereich &#x22;Variablen&#x22; drei Variablen aufgelistet." position="flex-start" size="80" width="1734" height="1479" initialPath="Images/real-time-config-action-result.png" githubPath="DEU/Images/real-time-config-action-result.png" showCaption="false" indent="3"}

:::Paragraph{listStyleType="decimal" listStart="5" indent="2"}
Klicken Sie auf **Speichern**.
Die Aktion wird gespeichert und die Seite **Neue Aktion** wird geschlossen.
:::

3. Machen Sie auf der Registerkarte **Abfragen** des Bereichs **Edge Intelligence-Konfiguration** die Abfrage **Servicestatus** ausfindig und klicken Sie auf den betreffenden Namen.
   Innerhalb des Bereichs wird die Detailseite der Abfrage geöffnet, welche eine Übersicht über die verknüpften Aktionen anzeigt.
   1. Wählen Sie im Abschnitt **Aktionen** die Option **Aktion hinzufügen** aus.
      Der Bereich **Aktion hinzufügen** wird geöffnet.
   2. Wählen Sie aus der Dropdownliste **Dienst neustarten** den Namen der Aktion aus, die Sie in Schritt 2 (a bis e) erstellt haben.
      Der Abschnitt **Aktionsdaten** (mit den in Schritt 2b erstellten Variablen) und der Abschnitt **Verfügbare Platzhalter** (mit den von der Abfrage abgerufenen Daten) werden angezeigt.

      1. Gehen Sie im Abschnitt **Aktion** für Name wie folgt vor:
         - Wählen Sie bei **Typ** die Option **Folgenden Wert verwenden:** aus.
         - Geben Sie bei **Wert** den Platzhalter `$(query.name)` für den Dienstnamen an.

      :::hint{type="success"}
      Sie können den Platzhalter mithilfe des Symbols :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/IiuTXLwNsOMAsfKmYR9Df_real-time-icon-copy.png" alt="Kopieren" caption="Kopieren" size="10" width="28" height="32"} kopieren, das neben der Platzhalterdefinition angezeigt wird.
      :::
   3. Klicken Sie auf **Hinzufügen**, um Ihre Änderungen zu speichern.
      Der Bereich **Aktion hinzufügen** wird geschlossen.
4. Klicken Sie auf **Schließen**.
   Der Bereich **Edge Intelligence-Konfiguration** wird geschlossen.

Die Aktion Dienst neustarten ist jetzt verfügbar:

1. Führen Sie die Abfrage **Servicestatus** aus.
2. Machen Sie in der Listenansicht der Abfrageergebnisse die Zeile mit dem gewünschten **Computernamen** und **Dienstnamen** ausfindig.
   Optional können Sie hierfür Filter und/oder Parameter verwenden.
3. Öffnen Sie das Optionsmenü (:inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/NVtb2_MgfoMHtlqB1iW3Q_general-options-menu.png" alt="Symbol für das Optionsmenü" caption size="10" width="4" height="12"}) für die ausgewählte Zeile und wählen Sie **Dienst neustarten** aus.
   1. Die Aktion startet den Dienst neu und die Abfrageergebnisse für den **Servicestatus** werden aktualisiert.
   2. Die Benachrichtigung, die Sie in Schritt 2d erstellt haben, wird dem Endbenutzer angezeigt.

:::hint{type="danger"}
Wenn Sie das Aktionsmenü Abfrageebene (in der folgenden Abbildung **rot** hervorgehoben) anstelle des Aktionsmenüs Datensatzebene (**grün** hervorgehoben) auswählen, wendet Edge Intelligence die Aktion auf alle Datensätze der Abfrageergebnisse an. Je nach Ihren Abfrageparametern kann dies dazu führen, dass jeder Dienst auf jedem Gerät in Ihrer Umgebung neu gestartet wird. Gehen Sie bei der Verwendung von Aktionen auf *Abfrageebene* vorsichtig vor und validieren Sie neu erstellte benutzerdefinierte Aktionen stets in einer Test- oder Laborumgebung, bevor Sie sie in der Produktion bereitstellen.
:::

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

## Erstellen einer Quick Action über den Bereich "Aktionen für Abfrage verwalten"

In diesem Beispiel fügen Sie eine ähnliche Aktion wie im Beispiel [Erstellen einer benutzerdefinierten Abfrageaktion über den Edge Intelligence-Konfigurationsbereich](https://docs.ivanti.com/neurons/help/de_de/aktionen-schrittweise-anleitungen#CreateFromConfPanel) hinzu, jedoch als so genannte Quick Action. Dadurch werden einige Konfigurationsschritte für Sie automatisiert.

1. Wechseln Sie zu **Einblicke > Edge Intelligence** und öffnen Sie die Abfrage **Servicestatus** (in der Kategorie **Inventar**).
   Das Abfrage-Widget **Servicestatus** wird angezeigt.
2. Verwenden Sie den Umschalter :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/wnaUPmdJfuVKxL-PceBfF_real-time-icon-toggle-view.png" alt="Ansicht umschalten (Symbol)" caption size="10" width="68" height="35"}, um zur Listenansicht zu wechseln.
3. Öffnen Sie das Optionsmenü ( :inlineImage[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/NVtb2_MgfoMHtlqB1iW3Q_general-options-menu.png" alt="Symbol für das Optionsmenü" caption size="10" width="4" height="12"} ) und wählen Sie **Verwalten** aus.
   Der Bereich **Aktionen für Abfrage "Servicestatus" verwalten** wird mit einer Liste der verknüpften Aktionen angezeigt.
4. Wählen Sie **Quick Action erstellen** aus.
   Der Bereich **Quick Action erstellen** wird angezeigt.
   1. Geben Sie einen **Aktionsnamen** an, z. B. *Quick Action Dienst neustarten*.
   2. Wählen Sie die Aufgabe **PowerShell ausführen** aus.
      Die ausgewählte Aufgabe wird unter **Aufgaben**hinzugefügt und zusätzliche Konfigurationsfelder für die Aufgabe werden angezeigt.
      1. Fügen Sie in das angezeigte Feld **Skript** Ihr (Entwurfs-)PowerShell-Skript ein.
         In diesem Beispiel:

         ```powershell
         $ServiceName = "$(var.placeholder)'" Restart-Service-Name $ServiceName-Force-ErrorAction Stop
         ```
      2. Wählen Sie im Feld **Skript** den Eintrag `$(var.placeholder)` aus und klicken Sie unter **Verfügbare Platzhalter** auf den Platzhalter **Programm**.
         Der Platzhalter wird eingefügt und das Skript sollte nun folgendermaßen aussehen:

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

         :::hint{type="success"}
         Sie können beim Eingeben des Skripts Platzhalter einfügen.
         :::
   3. Wählen Sie **Weitere Aufgabe hinzufügen** aus.
      Die Liste der verfügbaren Aufgaben wird angezeigt.
   4. Wählen Sie die Aufgabe **Benutzer benachrichtigen** aus.
      Die ausgewählte Aufgabe wird unter **Aufgaben**hinzugefügt und zusätzliche Konfigurationsfelder für die Aufgabe werden angezeigt.
      1. Geben Sie einen **Betreff** und eine **Nachricht** für die Benachrichtigung an. Sie können in diesen Feldern Platzhalter verwenden.
   5. Klicken Sie auf **Speichern**.
      Der Bereich **Quick Action erstellen** wird geschlossen und der Bereich **Aktionen für Abfrage "Servicestatus" verwalten** wird wieder sichtbar. Ihre neue Aktion wird unter **Verknüpfte Aktionen** aufgeführt.
5. Klicken Sie auf **Schließen**.
   Der Bereich **Aktionen für Abfrage "Servicestatus" verwalten** wird geschlossen.

Die Quick Action *Dienst neustarten* ist jetzt verfügbar.
