Benutzerphasen

Erstellen Sie Benutzerphasen, um Phasen zur Verwendung bei der Bot-Erstellung anzupassen und zu speichern. Nachdem die Phasen erstellt wurden, können sie im Neurons Bots-Editor unter Phasen > Benutzer wiederverwendet werden.

So erstellen Sie eine Benutzerphase:

Wechseln Sie zu Hauptmenü > Neurons Bots.
Die Startseite Neurons Bots wird angezeigt.
Wählen Sie die Registerkarte Allgemeine Bots oder Umfrage-Bots aus.
Wählen Sie Bot erstellen oder Umfrage erstellen aus.
Die Seite Bot erstellen oder Umfrage erstellen wird angezeigt.
Wählen Sie den Bot-Trigger aus: Zeitplan oder Benutzerdefinierte Aktion.
Wählen Sie den Zieltyp aus: Geräte oder Personen.
Geben Sie einen Namen für den Bot ein. Geben Sie optional eine kurze Beschreibung ein.
Klicken Sie auf Erstellen.
Die Seite "Bot-Editor" wird angezeigt.
Der neue Bot wird als inaktive Entwurfsversion gespeichert.
Wählen Sie auf der Seite Editor für neue Bots die Option Benutzerphasen verwalten aus, um die Seite Benutzer-Phasenverwaltung anzuzeigen.
Klicken Sie auf der Seite Benutzer-Phasenverwaltung in das Dropdownfeld Erstellen und wählen Sie eine der folgenden Phasen aus:
- PowerShell-Abfrage
- PowerShell-Aktion
- Bash-Aktion
- Befehlsaktion
- OSQuery
Geben Sie auf der Seite Benutzer-Phaseneditor den Phasennamen ein. Beispiel: Datei/Ordner komprimieren.
Geben Sie optional eine Beschreibung ein. Der beschreibende Text wird angezeigt, wenn im Bot-Editor im Bereich Phaseneinstellungen die Option "Phaseninformationen" ausgewählt wird. Beispiel: In dieser Phase werden Quelldateien von einem bestimmten Pfad zu einem Zielpfad auf die angegebene Komprimierungsstufe komprimiert.
Geben Sie den Skriptcode ein.
Beispiel:
Compress-Archive -path C:\logs\file.txt
-destinationpath C:\logs\file.zip
-compressionlevel Optimal

Sie können dieses Skript flexibler gestalten, indem Sie einen Teil des Hardcodes durch Variablen ersetzen. Dadurch könnten Elemente bei der Nutzung der Phase individuell angepasst werden.
Beispiel:
Compress-Archive -path __Path to Source File or Folder__
-destinationpath __Destination Path__
-compressionlevel __Compression level|options:Fastest,Optimal,No Komprimierung__

Wählen Sie STRG + Leertaste, um eine Optionsvariable oder eine Wertvariable einzufügen:

Eine Optionsvariable wird in den Einstellungen als Auswahl-Dropdownmenü angezeigt. Die verfügbaren Optionen sind diejenigen, die Sie in das Skript eingeben. In iesem Beispiel: Compression level options Fastest, Optimal, No Compression.

Eine Wertvariable wird in den Einstellungen als Textfeld mit der Bezeichnung angezeigt, die Sie in das Skript eingeben. In diesem Beispiel: Patch to Source File or Folder, Destination Path, and Compression level.

In diesem Beispiel würden die Phaseneinstellungen wie folgt aussehen:

Vervollständigen Sie die Phaseneinstellungen. Die verfügbaren Einstellungen hängen vom Typ der Benutzerphase ab, die Sie erstellen:

PowerShell-Abfrage

Ausführen als:

System
Angemeldeter Benutzer

Typ:

PowerShell
Core
Auto

Ausgabe: Fügen Sie eine Ausgabe für jeden von der PowerShell-Abfrage zurückgegebenen Spaltennamen hinzu, den Sie in einer nachgeschalteten Filterergebnisphase oder als Variable in einer anderen Phase verwenden möchten.

Einzelnes Ergebnis: Ein-/Ausschalten. Verwenden Sie einzelne/mehrere Ergebnisse, um zu definieren, ob die Abfrage ein oder mehrere Ergebnisse pro Gerät zurückgibt. Dadurch wird bestimmt, ob Variablen direkt als Token-Eingaben in nachgeschalteten Phasen verfügbar sind (einzeln) oder ob sie nur für Phasen in einem Für jede/n/s-Ergebnisblock (mehrfach) verfügbar sind, um diese Phasen für jedes Ergebnis zu durchlaufen.

PowerShell-Abfragebeispiel:

Verwenden Sie PowerShell zur Abfrage Ihrer Umgebung, wenn das gewünschte benutzerdefinierte Verhalten nicht über die Standard-Bot-Phasen erzielt werden kann.

Stellen Sie für eine erfolgreiche Abfrage Folgendes sicher:

Die Skriptausgabe ist JSON (Sie können das Commandlet ConvertTo-JSON verwenden).
Sie können jedes Datenfeld in den Phaseneinstellungen als Ausgabeeintrag benennen.

Standardmäßig beträgt das Skript-Timeout 25 Minuten.

PowerShell-Typen:

Wenn Sie als PowerShell-Typ Core auswählen, wird das PowerShell-Skript auf PowerShell Core ausgeführt. Dazu muss .Net Core 3.1 Desktop Runtime, Version 24.64.28315 oder höher, auf dem betreffenden Computer installiert sein.
Wenn Sie als PowerShell-Typ Auto auswählen, sucht die Abfrage nach Net Core 3.1 Desktop Runtime, Version 24.64.28315 oder höher. Dies bewirkt Folgendes:
- Wenn die Runtime installiert ist, wird das Skript mit PowerShell Core ausgeführt.
- Wenn die Runtime nicht installiert ist, wird das Skript mit PowerShell ausgeführt.

Ausgabetypen:

Aktivieren Sie diese Option, wenn die Ergebnisse bei "Mehrere" angezeigt werden sollen, und deaktivieren Sie sie, wenn die Ergebnisse bei "Einzeln" angezeigt werden sollen.

Einzeln: Wenn der Ausgabetyp als "Einzeln" angegeben ist, kann ein Objekt im JSON-Format zurückgegeben werden.

$name = [System.Net.Dns]::GetHostName()

ConvertTo-Json @([customobject]@{Name = $name;})

Mehrere: Wenn der Ausgabetyp als "Mehrere" angegeben ist, müssen Sie die Daten als Objektbereich im JSON-Format zurückgeben.
[{“Beispielfeld”: “A”}, {“Beispielfeld Field”: “B”}]
Die Objekte innerhalb des Bereichs enthalten die primitiven Typen. Im Feld Ausgabe des Phaseninspktors müssen Sie das Feld Beispiel einbinden und Name eingeben.
$processes = Get-Process | Select-Object Name
ConvertTo-Json $processes

Wählen Sie Anwenden und schließen aus, um die Benutzerphase zu speichern.
Wenn Sie Änderungen an einer vorhandenen Benutzerphase vorgenommen haben, wird eine neue Version erstellt. Beim Speichern wird ein Dialogfeld mit einer Warnung angezeigt. Diese weist darauf hin, dass alle Bots, die diese Benutzerphase verwenden, aktualisiert werden müssen, damit sie die neueste Version verwenden können.

Aktionen

Sie können für jede Benutzerphase die folgenden Aktionen ausführen:

Klonen: Wählen Sie eine Benutzerphase aus und dann Aktionen > Klonen. Das Dialogfeld Phase klonen wird angezeigt. Geben Sie einen eindeutigen Namen ein und wählen Sie Klonen aus. Eine Popup-Meldung informiert Sie darüber, dass die Phasenerstellung erfolgreich war. Die geklonte Phase wird in der Liste angezeigt, sodass Sie sie auswählen und bearbeiten können.

Löschen: Wählen Sie eine oder mehrere Benutzerphasen aus und dann Aktionen > Löschen. Das Dialogfeld Phase löschen wird angezeigt. Wählen Sie Löschen aus, um das Löschen der Phase zu bestätigen. Diese Aktion kann nicht rückgängig gemacht werden und führt dazu, dass die Phase in jedem Bot, der sie verwendet, als veraltet gilt. Veraltete Phasen werden durch einen roten Rahmen gekennzeichnet.

Benutzerphasen

So erstellen Sie eine Benutzerphase:

Aktionen

Verwandte Themen