Flower

← Alle Module · Hilfsmittel

befehl

Führt ein externes Programm oder einen Systembefehl aus und liefert dessen Standardausgabe, Fehlerausgabe und Exit-Code zurück. Weil ein Befehl das System verändern kann, ist die Aktion abgesichert: Im Simulations-Modus wird nichts ausgeführt, nur eine Vorschau angezeigt.

Aktionen

ausführenverändernd

Startet das angegebene Programm mit optionalen Argumenten und gibt das Ergebnis zurück. Im Simulations-Modus wird der Befehl nicht ausgeführt.

Eingaben

FeldTypPflichtBeschreibung
befehlTextjaProgramm bzw. ausführbare Datei (z.B. "git" oder ein Pfad).
argumenteListe—Argumente als Liste (z.B. ["status", "--short"]).
arbeitsverzeichnisText—Verzeichnis, in dem der Befehl ausgeführt wird (Standard: aktuelles).

Ausgaben (über ergebnis:)

ausgabeDie Standardausgabe (stdout) als Text.
fehler-ausgabeDie Fehlerausgabe (stderr) als Text.
codeDer Exit-Code als Zahl (0 = Erfolg).
erfolgWahr, wenn der Exit-Code 0 ist.

Beispiele

Git-Status abfragen

Führt git status im Projektordner aus und legt die Ausgabe in einer Variablen ab.

befehl
ausführen
befehl"git"
argumente["status", "--short"]
arbeitsverzeichnis"C:\\Projekte\\kunde"
ergebnisgit_ausgabe
- befehl:
    aktionen:
      - ausführen:
          befehl: "git"
          argumente: ["status", "--short"]
          arbeitsverzeichnis: "C:\\Projekte\\kunde"
          ergebnis: git_ausgabe

Konvertierungs-Tool aufrufen

Ruft ein Kommandozeilen-Werkzeug auf und prüft anschließend über erfolg, ob es geklappt hat.

befehl
ausführen
befehl"magick"
argumente["bild.png", "bild.jpg"]
ergebniskonv
- befehl:
    aktionen:
      - ausführen:
          befehl: "magick"
          argumente: ["bild.png", "bild.jpg"]
          ergebnis: konv