---
title: Benutzerphasen
slug: neurons/help/de_de/benutzerphasen
createdAt: 2026-09-07T11:44:53.280Z
---

Erstellen Sie Benutzerphasen, um Phasen zur Verwendung bei der Bot-Erstellung anzupassen und zu speichern. Nachdem die Phasen erstellt wurden, können sie im [Bots-Editor](docId\:PorsDaNcKk-Nnsk3WN9bm) unter **Phasen** > **Benutzer** wiederverwendet werden.

## So erstellen Sie eine Benutzerphase:

1. Wechseln Sie zu **Hauptmenü** > **Bots**.
   Die **Bots**-Startseite wird angezeigt.
2. Wählen Sie die Registerkarte **Allgemeine Bots** oder **Umfrage-Bots** aus.
3. Wählen Sie **Bot erstellen** oder **Umfrage erstellen** aus.
   Die Seite **Bot erstellen** oder **Umfrage erstellen** wird angezeigt.
4. Wählen Sie den Bot-Trigger aus: **Zeitplan** oder **Benutzerdefinierte Aktion**.
5. Wählen Sie den Zieltyp aus: **Geräte** oder **Personen**.
6. Geben Sie einen **Namen** für den Bot ein. Geben Sie optional eine kurze Beschreibung ein.
7. Klicken Sie auf **Erstellen**.
   Die Seite "Bot-Editor" wird angezeigt.
   Der neue Bot wird als inaktive Entwurfsversion gespeichert.
8. Wählen Sie auf der Seite **Editor für neue Bots** die Option **Benutzerphasen verwalten** aus, um die Seite **Benutzer-Phasenverwaltung** anzuzeigen.
9. 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
10. Geben Sie auf der Seite **Benutzer-Phaseneditor** den **Phasennamen** ein. Beispiel: Datei/Ordner komprimieren.
11. 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.
12. Geben Sie den Skriptcode ein.
    **Beispiel**:
    `Compress-Archive -path C:\logs\file.txt `
    `-destinationpath C:\logs\file.zip `
    `-compressionlevel Optimal`

:::Paragraph{indent="1"}
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__`
:::

:::Paragraph{indent="1"}
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.

:::Paragraph{indent="1"}
In diesem Beispiel würden die **Phaseneinstellungen** wie folgt aussehen:
:::

::Image[]{src="https://api.archbee.com/api/optimize/9rfvxhrv8FA-8bxcK2IRv/sF6chM1zlcniiyv0wxfXZ_bots-custom-stage.png" alt="Benutzerdefinierte Phaseneinstellungen " position="flex-start" size="35" width="346" height="602" initialPath="Images/bots-custom-stage.png" githubPath="DEU/Images/bots-custom-stage.png" showCaption="false" indent="1"}

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

::::ExpandableHeading
## PowerShell-Abfrage

**Ausführen als**:

- System
- Angemeldeter Benutzer
- Anmeldedaten

**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](docId\:bxUWvJOr3f60JQk6JBdU3)-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.

:::hint{type="info"}
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 "Einzelne" angezeigt werden sollen, und deaktivieren Sie sie, wenn die Ergebnisse bei "Mehrere" angezeigt werden sollen.

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

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

```bash
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.
  Die Objekte innerhalb des Bereichs enthalten die primitiven Typen. Im Feld **Ausgabe** des **Phaseninspktors** müssen Sie das Feld **Beispiel** einbinden und **Name** eingeben.

  ```bash
  [{“Beispielfeld”: “A”}, {“Beispielfeld Field”: “B”}]
  ```

  ```bash
  $processes = Get-Process | Select-Object Name
  ConvertTo-Json $processes
  ```
::::

:::ExpandableHeading
## PowerShell-Aktion

**Ausführen als**:

- System
- Angemeldeter Benutzer
- Anmeldedaten

**Typ**:

- PowerShell
- Core
- Auto

Beispiel für eine PowerShell-Aktion:

Die **PowerShell-Aktion** ähnelt der **PowerShell-Abfrage**, mit der Ausnahme, dass es bei der **PowerShell-Aktion** keine Ausgaben gibt. Weitere Informationen finden Sie unter [Beispiel für eine PowerShell-Abfrage](docId\:SbwpuhrUuY6xPjSLgZRzq).
:::

:::ExpandableHeading
## Bash-Aktion

**Ausführen als**:

- System
- Angemeldeter Benutzer

Beispiel für eine Bash-Aktion:

Um die Größe durch Entfernen der ersten 100 Einträge zu reduzieren, verwenden Sie den folgenden Befehl:

```bash
sed 1,100d your-filename
```
:::

:::ExpandableHeading
## Befehlsaktion

**Ausführen als**:

- System
- Angemeldeter Benutzer

Beispiel für eine Befehlsaktion:

- Scannen und Reparieren beschädigter Dateien:

```bash
sfc /scannow
```

- Prüfen und Beheben des Status der physischen Festplatte:

```bash
chkdsk /offlinescanandfix
```
:::

:::ExpandableHeading
## OSQuery

**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.

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

Beispiel für eine OSQuery-Abfrage

Führen Sie folgendes Skript aus, um die am häufigsten gestarteten Anwendungen pro Gerät zu ermitteln:

```bash
select path,last_execution_time,count,
sid from userassist order by count desc
limit __Number of Apps to return|options:1,5,10__
```
:::

14. 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&#x20;**> **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&#x20;**> **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.**&#x20;Veraltete Phasen** werden durch einen roten Rahmen gekennzeichnet.

### Verwandte Themen

[Bots-Phasen](docId\:bxUWvJOr3f60JQk6JBdU3)
