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
- Klicken Sie auf Script erstellen
- Konfigurieren Sie das Script:
| Feld | Beschreibung | Pflicht |
|---|---|---|
| Name | Eindeutiger Name des Scripts | Ja |
| Beschreibung | Was macht das Script? | Nein |
| Sprache | Interpreter (siehe unten) | Ja |
| Module | Fuer welche Module ist das Script verfuegbar | Ja |
| Script-Code | Der eigentliche Script-Inhalt | Ja |
| Timeout | Maximale Ausfuehrungszeit in Sekunden | Nein |
| Pre-Hook | Script-Code, der VOR dem Hauptscript ausgefuehrt wird | Nein |
| Post-Hook | Script-Code, der NACH dem Hauptscript ausgefuehrt wird | Nein |
| Benachrichtigung | Benachrichtigungstyp bei Ausfuehrung | Nein |
Sprachen
| Sprache | Interpreter | Plattformen |
|---|---|---|
| Bash | /bin/bash | Linux, PVE, PBS, OPNsense (FreeBSD) |
| PowerShell | powershell.exe | Windows |
| Python | python3 (Linux) / python.exe (Windows) | Alle (wenn installiert) |
| Shell | /bin/sh | Linux, 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.
| Wo | Wirkung |
|---|---|
| Script | Standard fuer alle Laeufe |
| Job (Aktion Script) | ersetzt den Standard des Scripts; leer = Standard |
| Ausfuehren-Dialog | gilt 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:
| Typ | Beschreibung |
|---|---|
| Keine | Keine Benachrichtigung (Standard) |
| E-Mail an eine konfigurierte Adresse | |
| REST | HTTP-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.
| Bereich | Beispiele |
|---|---|
| Wartung | Datenträger C: bereinigen, sfc /scannow, Wiederherstellungspunkt, Energiesparplan, Partition C: vergrößern |
| Terminalserver | alle Benutzer abmelden, Sitzungen anzeigen, Teams für alle Benutzer, pascom Client, RDP und RDP-UDP |
| Sicherheit | Defender-Scans, ASR-Regeln anzeigen, Sicherheits-Grundeinstellungen, BitLocker-Schlüssel, WDAC-Treibersperrliste |
| Inventar | Seriennummer, Lizenzstatus, Akkuzustand, Windows-11-Tauglichkeit, Vertrauensstellung prüfen |
| Software | winget, Chocolatey, DATEV, 2FAST, Quba, Windows-11-Upgrade, Debloat |
| Checks | Antivirus 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
- Rechtsklick auf einen Host → Script ausfuehren
- Oder: Detail-Panel → Tab Jobs → Script ausfuehren
- Waehlen Sie ein Script aus der Bibliothek
- Klicken Sie auf Ausfuehren
Bulk-Ausfuehrung
- Waehlen Sie mehrere Hosts ueber die Checkboxen
- Klicken Sie auf Script ausfuehren in der Bulk-Aktionsleiste
- Waehlen Sie das Script
- 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_liveunter Einstellungen > Parameter auf0schaltet 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 -ein 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