Skip to content

Scripts ​

Die Script-Verwaltung ermoeglicht das zentrale Erstellen, Verwalten und Ausfuehren von Scripts auf verwalteten Hosts. Scripts koennen einzeln oder als Bulk-Aktion auf mehreren Hosts ausgefuehrt werden.

Script-Bibliothek ​

Die Script-Bibliothek erreichen Sie ueber den Navigationspunkt Scripts. Hier werden alle verfuegbaren Scripts angezeigt.

Liste anpassen ​

  • Spaltenbreite: Am rechten Rand eines Spaltenkopfs ziehen. Doppelklick auf den Rand stellt die Standardbreite wieder her. Der Name bekommt standardmaessig den restlichen Platz.
  • Liste neben dem geoeffneten Script: Die Trennlinie zwischen Liste und Script ziehen (Doppelklick = Standard). Lange Namen brechen auf zwei Zeilen um, der volle Name steht im Tooltip.
  • Die Breiten merkt sich der Browser.

Script erstellen ​

  1. Klicken Sie auf Script erstellen
  2. Konfigurieren Sie das Script:
FeldBeschreibungPflicht
NameEindeutiger Name des ScriptsJa
BeschreibungWas macht das Script?Nein
SpracheInterpreter (siehe unten)Ja
ModuleFuer welche Module ist das Script verfuegbarJa
Script-CodeDer eigentliche Script-InhaltJa
TimeoutMaximale Ausfuehrungszeit in SekundenNein
Pre-HookScript-Code, der VOR dem Hauptscript ausgefuehrt wirdNein
Post-HookScript-Code, der NACH dem Hauptscript ausgefuehrt wirdNein
BenachrichtigungBenachrichtigungstyp bei AusfuehrungNein

Sprachen ​

SpracheInterpreterPlattformen
Bash/bin/bashLinux, PVE, PBS, OPNsense (FreeBSD)
PowerShellpowershell.exeWindows
Pythonpython3 (Linux) / python.exe (Windows)Alle (wenn installiert)
Shell/bin/shLinux, FreeBSD

Module zuweisen ​

Ein Script kann einem oder mehreren Modulen zugewiesen werden:

  • Alle - Verfuegbar in allen Modulen
  • OPNsense - Bash/Shell-Scripts fuer FreeBSD
  • Proxmox VE - Bash-Scripts fuer Debian
  • Proxmox Backup Server - Bash-Scripts fuer Debian
  • Linux - Bash-Scripts fuer alle Distributionen
  • Windows - PowerShell-Scripts

Timeout ​

Jedes Script kann einen individuellen Timeout haben:

  • Standard: 5 Minuten (300 Sekunden) wenn kein Timeout angegeben
  • Wird das Timeout ueberschritten, wird der Script-Prozess abgebrochen
  • Fuer langlaeuige Operationen kann ein hoeherer Wert gesetzt werden

Argumente (ab v3.34.0) ​

Ein Script kann Standard-Argumente haben (Editor, rechte Spalte). Ein Eintrag pro Zeile, getrennt wird wie in der Shell: -Url "https://example.com/a b.exe" ergibt zwei Argumente. Platzhalter wie {{kunde.nummer}} sind erlaubt, siehe Script-Variablen.

WoWirkung
ScriptStandard fuer alle Laeufe
Job (Aktion Script)ersetzt den Standard des Scripts; leer = Standard
Ausfuehren-Dialoggilt nur fuer diesen Lauf; vorbelegt mit dem Standard, leer = ohne Argumente

Control setzt die Argumente beim Abholen in das Script ein, dafuer ist kein neuer Agent noetig: PowerShell bekommt sie wie beim Aufruf mit -Parameter Wert (ein param()-Block funktioniert), sh/bash/zsh ueber set -- ($1, $2, "$@"), Python ueber sys.argv, Perl ueber @ARGV.

Pre-Hook / Post-Hook ​

Hooks sind zusaetzliche Script-Bloecke, die vor oder nach dem Hauptscript ausgefuehrt werden:

Pre-Hook (vor dem Script):

  • Typisch: Dienste stoppen, Backup erstellen, Wartungsmodus aktivieren
  • Wird in der gleichen Sprache wie das Hauptscript ausgefuehrt

Post-Hook (nach dem Script):

  • Typisch: Dienste starten, Aufraeuemarbeiten, Benachrichtigungen
  • Wird auch bei Fehler des Hauptscripts ausgefuehrt

Benachrichtigungen ​

Nach der Script-Ausfuehrung kann eine Benachrichtigung gesendet werden:

TypBeschreibung
KeineKeine Benachrichtigung (Standard)
E-MailE-Mail an eine konfigurierte Adresse
RESTHTTP-Request an eine URL (Webhook)

Bei Typ E-Mail geben Sie die Empfaengeradresse ein, bei REST die Webhook-URL.

Script-Editor ​

Der integrierte Script-Editor bietet:

  • Syntax-Highlighting fuer Bash, PowerShell und Python
  • Zeilennummerierung
  • Tab-Einrueckung
  • Scroll-Synchronisierung

Script-Bibliothek (ab v3.43.0) ​

Control bringt knapp 50 geprüfte Windows-Scripts mit (aus der Tactical-Ablösung, bereinigt und auf PowerShell umgestellt). Sie werden bei jedem Update einmal angelegt und sind danach normale Scripts: ändern, kopieren, löschen. Gelöschte kommen nicht wieder, ein Script gleichen Namens wird nicht überschrieben.

BereichBeispiele
WartungDatenträger C: bereinigen, sfc /scannow, Wiederherstellungspunkt, Energiesparplan, Partition C: vergrößern
Terminalserveralle Benutzer abmelden, Sitzungen anzeigen, Teams für alle Benutzer, pascom Client, RDP und RDP-UDP
SicherheitDefender-Scans, ASR-Regeln anzeigen, Sicherheits-Grundeinstellungen, BitLocker-Schlüssel, WDAC-Treibersperrliste
InventarSeriennummer, Lizenzstatus, Akkuzustand, Windows-11-Tauglichkeit, Vertrauensstellung prüfen
Softwarewinget, Chocolatey, DATEV, 2FAST, Quba, Windows-11-Upgrade, Debloat
ChecksAntivirus aktiv, Defender ohne Funde, Datenträgerfehler, Zabbix Agent, Secure Boot 2023

Vor dem ersten Einsatz testen

Sicherheits-Grundeinstellungen (alle ASR-Regeln auf Blockieren), WDAC-Treibersperrliste (wirkt nach Neustart), Partition C: vergrößern (Standard -DryRun) und Debloat (nur für frische Arbeitsplätze) greifen tief ins System. Erst auf einem Testrechner laufen lassen.

PowerShell-Scripts mit Umlauten bekommt der Agent ab v3.43.0 mit UTF-8-Kennung (BOM). Windows PowerShell 5.1 las sie vorher als ANSI, Umlaute und Gedankenstriche konnten dann zu Syntaxfehlern führen.

Script ausfuehren ​

Einzelausfuehrung ​

  1. Rechtsklick auf einen Host → Script ausfuehren
  2. Oder: Detail-Panel → Tab Jobs → Script ausfuehren
  3. Waehlen Sie ein Script aus der Bibliothek
  4. Klicken Sie auf Ausfuehren

Bulk-Ausfuehrung ​

  1. Waehlen Sie mehrere Hosts ueber die Checkboxen
  2. Klicken Sie auf Script ausfuehren in der Bulk-Aktionsleiste
  3. Waehlen Sie das Script
  4. Bestaetigen Sie die Ausfuehrung

Das Script wird parallel auf allen ausgewaehlten Hosts gestartet.

Ergebnisse ​

Einzelergebnis ​

Nach der Ausfuehrung wird das Ergebnis angezeigt:

  • Exit-Code (0 = Erfolg, >0 = Fehler)
  • Stdout - Standardausgabe
  • Stderr - Fehlerausgabe
  • Ausfuehrungsdauer
  • Zeitstempel

Ausfuehrungsverlauf ​

Unter Scripts > Tab Verlauf finden Sie alle bisherigen Script-Ausfuehrungen mit:

  • Host, Script-Name, Zeitpunkt
  • Exit-Code und Status
  • Ausgabe zum Nachschlagen

Ausgabe und komplettes Log (ab v3.75.0) ​

Scripts dürfen viel ausgeben, ohne den Server zu belasten. Mit Agent 3.75.0 gilt:

  • Live-Ansicht: Solange du einen laufenden Task aufgeklappt hast, schickt der Agent jede Sekunde das Neueste. Ohne Zuschauer schickt er nur alle 30 Sekunden die letzten Zeilen (wie die GitLab-Runner) - so belasten auch Tausende gleichzeitige Scripts den Server kaum. Bei sehr viel Ausgabe zeigt die Live-Ansicht das Ende, übersprungene Stellen sind markiert. Das Endergebnis ist trotzdem vollständig.
  • Endergebnis bis 2 MB: steht wie bisher komplett im Task und im Verlauf.
  • Endergebnis über 2 MB: Im Task stehen Anfang und Ende, darunter der Knopf Komplettes Log herunterladen. Das komplette Log wird 90 Tage aufgehoben.
  • Obergrenze 200 MB je Log: Gerät ein Script außer Kontrolle, bleiben die ersten 50 MB und die letzten rund 150 MB erhalten. Im Log steht, wie viel dazwischen fehlt.
  • Abbruch mitten im Lauf (Rechner aus, Agent neu gestartet): Der Agent liefert beim nächsten Verbinden ein Teil-Log bis zu dieser Stelle nach.
  • Passwörter aus Script-Variablen und geheime Custom Fields werden in Live-Ansicht, Ergebnis und komplettem Log maskiert.

Viele Rechner gleichzeitig ​

Rechner mit Agent ab 3.75.0 laufen alle gleichzeitig, auch bei Tausenden Rechnern. Nur Rechner mit älterem Agent starten je Job höchstens 20 Scripts gleichzeitig, die übrigen kommen dran, sobald einer fertig ist (job_max_parallel unter Einstellungen > Parameter, 0 = ohne Grenze). Komplette Logs belegen zusammen höchstens task_log_max_gb (Standard 5 GB gepackt; es bleiben immer mindestens 5 GB frei).

Hinweis im Script-Editor ​

Der Editor warnt, wenn ein Script vermutlich jede Datei einzeln meldet, zum Beispiel Remove-Item ... -Verbose, robocopy ohne /NFL /NDL, set -x oder rm -v. Besser ist eine Zusammenfassung am Ende („1.234 Dateien, 2,3 GB entfernt“).

Notschalter und Alarm ​

  • task_output_live unter Einstellungen > Parameter auf 0 schaltet die Live-Ausgabe aller Scripts ab. Endergebnis und komplettes Log kommen weiter.
  • Fällt innerhalb von 15 Minuten ein großer Teil der Server-Agents weg (Standard 25 %, mindestens 20 Agents; Arbeitsplätze und Macs zählen nicht), geht ein Alarm an alle aktiven Benachrichtigungskanäle. Ebenso, wenn der Echtzeit-Dienst 3 Minuten nicht antwortet. Schwelle: platform_alert_offline_pct (0 = aus).

Ältere Agents ​

Agents vor 3.75.0 schicken bei jeder Zeile die gesamte bisherige Ausgabe. Der Server schützt sich davor: Ab 32 KB Ausgabe eines Scripts bekommt so ein Agent keine Live-Ansicht mehr und wird 2 Minuten lang nicht angenommen. Er bleibt trotzdem online, das Endergebnis kommt am Ende. Große Endergebnisse speichert der Server als komplettes Log. Auf dem Rechner selbst bleibt das Script mit dem alten Agent langsam, das behebt nur das Agent-Update.

Versionierung ​

Scripts werden automatisch versioniert:

  • Jede Aenderung erstellt eine neue Version mit optionaler Aenderungsbeschreibung
  • Aeltere Versionen bleiben erhalten
  • Bei der Ausfuehrung wird die aktuelle Version verwendet

System-Scripts ​

DATAZONE Control enthaelt vordefinierte System-Scripts fuer gaengige Aufgaben:

  • Update-Scripts (pro Modul und OS)
  • Neustart-Scripts
  • Dienste-Pruefungen
  • Informationssammlung
  • Agent-Update-Scripts
  • OPNsense IPsec MSS-Clamping pruefen und aktivieren (siehe OPNsense)

System-Scripts sind mit einem Schloss-Symbol gekennzeichnet und koennen nicht bearbeitet oder geloescht werden. Sie dienen als Vorlage und Referenz fuer eigene Scripts.

Best Practices ​

Empfehlungen

  • Fehlerbehandlung: Verwenden Sie set -e in Bash-Scripts fuer sofortigen Abbruch bei Fehlern
  • Logging: Geben Sie aussagekraeftige Meldungen auf stdout aus
  • Idempotenz: Scripts sollten mehrfach ausfuehrbar sein ohne Seiteneffekte
  • Timeouts: Setzen Sie angemessene Timeouts fuer langlaeuige Scripts
  • Pre-/Post-Hooks: Nutzen Sie Hooks fuer Vor-/Nachbereitung statt alles in einem Script

DATAZONE Control Documentation