Aktionen: Schrittweise Anleitungen

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.
    • Die Endpunkte müssen über eine Richtlinie verfügen, in der die Funktion Edge Intelligence aktiviert ist. Siehe 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.

Erstellen einer benutzerdefinierten Abfrageaktion über den Edge Intelligence-Konfigurationsbereich

In diesem Beispiel fügen Sie der Abfrage App-Status eine Aktion hinzu, um eine Anwendung zu deinstallieren. Die Aktion verwendet ein PowerShell-Skript mit einem Platzhalter für die von der Abfrage abgerufenen Informationen. Nach der Deinstallation der Anwendung wird der Benutzer benachrichtigt.

  1. Wechseln Sie zu Einblicke > Edge Intelligence und klicken Sie oben rechts auf der Seite auf Symbol für Einstellungen .
    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, zum Beispiel Anwendung deinstallieren.
    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 Name.

        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.
      5. Wiederholen Sie die Schritte i bis iv, um Variablen für Version und Anbieterzu erstellen.
    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, zum Beispiel Anwendung nach Name deinstallieren.
      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:
        Kopieren
        $application = Get-WmiObject -Class Win32_Product -Filter "Name = '$(var placeholder)'" $application.Uninstall()

        Wenn Sie sich über die genaue Schreibweise des Textes sicher sind, 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.Name) mithilfe von In Zwischenablage kopieren. Dies ist die Variable Name, 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:
        Kopieren
        $application = Get-WmiObject -Class Win32_Product -Filter "Name = '$(action.Name)'" $application.Uninstall()
      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 beispielsweise Anwendung erfolgreich deinstalliert: $(action.Name) ein.

        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,

        Die folgende Anwendung wurde erfolgreich deinstalliert:
        $(action.Name)
        $(action.Vendor)
        $(action.Version)

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

      Das Ergebnis sollte wie im Bild unten aussehen.
      Ergebnis der Konfiguration. Im Bereich "Aufgaben" sind zwei Aufgaben und im Bereich "Variablen" drei Variablen aufgelistet.

    5. 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 App-Status 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 Anwendung deinstallieren den Namen der Aktion aus, die Sie in den Schritten 2a bis 2e 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 Eintrag $(query.name) an, den Platzhalter für das Programm.
      2. Gehen Sie im Abschnitt Aktion für Anbieter wie folgt vor:
        • Wählen Sie bei Typ die Option Folgenden Wert verwenden: aus.
        • Geben Sie bei Wert den Eintrag $(query.publisher) an, den Platzhalter für den Herausgeber.
      3. Gehen Sie im Abschnitt Aktion für Version wie folgt vor:
        • Wählen Sie bei Typ die Option Folgenden Wert verwenden: aus.
        • Geben Sie bei Wert den Eintrag $(query.version) an, den Platzhalter für die Version.

      Sie können den Platzhalter mithilfe des Symbols Kopieren 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 Anwendung deinstallieren steht jetzt zur Verwendung zur Verfügung:

  1. Führen Sie die Abfrage App-Status aus.
  2. Machen Sie in der Listenansicht der Abfrageergebnisse die Zeile mit dem gewünschten Computernamen und Programm ausfindig.
    Optional können Sie hierfür Filter und/oder Parameter verwenden.
  3. Öffnen Sie das Optionsmenü ( Symbol für das Optionsmenü ) für die ausgewählte Zeile und wählen Sie Anwendung deinstallieren aus.
    1. Die Aktion deinstalliert das Programm und aktualisiert die Ergebnisse der Abfrage App-Status.
    2. Die Benachrichtigung, die Sie in Schritt 2d erstellt haben, wird dem Endbenutzer angezeigt.

Wenn Sie in das Optionsmenü auf Abfrageebene statt in das Optionsmenü auf Datensatzebene wechseln, wendet Edge Intelligence die Aktion auf alle Datensätze im Abfrageergebnis an. Je nach Ihren Abfrageparametern kann dies jede Anwendung auf jedem Computer Ihrer Umgebung sein.

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 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 App-Status (in der Kategorie Inventar).
    Das Abfrage-Widget App-Status wird angezeigt.
  2. Verwenden Sie den Umschalter Ansicht umschalten (Symbol), um zur Listenansicht zu wechseln.
  3. Öffnen Sie das Optionsmenü ( Symbol für das Optionsmenü ) und wählen Sie Verwalten aus.
    Der Bereich Aktionen für Abfrage "App-Status" verwalten wird angezeigt und zeigt eine Liste verknüpfter Aktionen an.
  4. Wählen Sie Quick Action erstellen aus.
    Der Bereich Quick Action erstellen wird angezeigt.
    1. Geben Sie einen Aktionsnamen an, zum Beispiel Anwendung nach Name deinstallieren Quick Action.
    2. Wählen Sie die Aufgabe PowerShell ausführen aus.
      Die ausgewählte Aufgabe wird unter Aufgabenhinzugefü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:
        Kopieren
        $application = Get-WmiObject -Class Win32_Product -Filter "Name = '$(var placeholder)'" $application.Uninstall()
      2. Wählen Sie im Feld Skript die Option $(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:
        Kopieren
        $application = Get-WmiObject -Class Win32_Product -Filter "Name = '$(query.name)'" $application.Uninstall()

        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 Aufgabenhinzugefü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 "Sitzungen" 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 "Sitzung" verwalten wird geschlossen.

Die Quick Action Anwendung nach Name deinstallieren steht jetzt zur Verfügung.

Verknüpfen einer vorhandenen Aktion mit einer Abfrage oder einem Alarm

  1. Wechseln Sie zu Insights > Edge Intelligence und klicken Sie oben rechts auf der Seite auf Symbol für Einstellungen.
    Der Bereich Edge Intelligence-Konfiguration wird angezeigt.

  2. Wählen Sie auf der Registerkarte Abfragen die Abfrage aus, mit der Sie eine Aktion verknüpfen möchten. Beispiel: Active Directory-Benutzer.
    Innerhalb des Bereichs wird die Liste der verknüpften Aktionen für die Abfrage Active Directory-Benutzer geöffnet.

    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 Aus lokalen Administratoren entfernen eine Standardaktion aus, die von Ivanti bereitgestellt wird.
      Der Abschnitt Aktionsdaten (mit einer Liste der Variablen für die Aktion) und der Abschnitt Verfügbare Platzhalter (mit einer Liste der von der Abfrage Active Directory-Benutzer abgerufenen Daten) werden angezeigt.
      1. Gehen Sie im Abschnitt Aktionsdaten für Kontoname wie folgt vor:
        • Wählen Sie bei Typ die Option Folgenden Wert verwenden: aus.
        • Geben Sie bei Wert den Eintrag $(query.accountName) an, den Platzhalter für den Kontonamen.

        Nicht für alle Abfragen sind relevante oder nützliche Platzhalter für die Verwendung mit einer Aktion verfügbar, die für eine andere Abfrage erstellt wurde.

        Sie können den Platzhalter mithilfe des Symbols Kopieren 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 und Aus lokalen Administratoren entfernen wird im Abschnitt Aktionen für die Abfrage Active Directory-Benutzer aufgeführt.
  3. Klicken Sie auf Schließen.
    Der Bereich Edge Intelligence-Konfiguration wird geschlossen.

Die Aktion steht nun im Optionsmenü ( Optionsmenü ) der Abfrage Active Directory-Benutzer zur Auswahl zur Verfügung.

Die Vorgehensweise beim Hinzufügen einer Aktion zu einem Alarm ist dieselbe, außer dass in Schritt 2 der Alarm auf der Registerkarte Alarme ausgewählt werden muss.
Nachdem Sie über den Bereich Edge Intelligence-Konfiguration eine Aktion hinzugefügt haben, steht diese beim Einrichten des Alarms zur Auswahl zur Verfügung.