Hilfe › Verwalten › G6

Skripte auf Geräten ausführen und freigeben

Ein Skript aus der Bibliothek auf einem oder mehreren Geräten laufen lassen — mit Freigabe je Zugang und Gerät, Rückfrage am Gerät und Ergebnis in der Konsole.

Vorschau diese Anleitung ist noch nicht am Gerät durchgeklickt. Knopfnamen und Abläufe stammen aus dem Programm, können aber in Einzelheiten abweichen.

Für
Techniker · Verwalter eines Zugangs
Gilt für
Cloud · Eigenes Relay
Lizenz
Leistung „Skripte“ (Cloud)
Recht in der Konsole
Techniker (ausführen); Mandant-Administrator (anlegen, freigeben)
Gesteuertes Gerät
Windows · macOS · Linux
Steuern von
Browser

Worum es geht

Skripte erledigen auf vielen Geräten in einem Schritt, was sonst eine Sitzung bräuchte: einen Dienst neu starten, Speicher aufräumen, einen Wert auslesen. Sie liegen in der Bibliothek der Konsole, sind signiert und laufen nur auf Geräten, für die sie freigegeben sind. Diese Seite zeigt den Weg vom Skript bis zum Ergebnis. In der Konsole heißt der Zugang Mandant.

Das brauchen Sie

  • Rolle: Techniker oder höher zum Ausführen; Mandant-Administrator oder höher zum Anlegen und Freigeben.
  • Cloud: die Leistung „Skripte“ (bezahlte Cloud; nicht in Free). Eigenes Relay: immer.
  • Zugang: die Regel Skripte ausführen erlauben darf nicht auf Aus stehen (G3).
  • Gerät: online, und die Skript-Ausführung muss am Gerät erlaubt sein — Geräte-Einstellung Remote-Kommandozeile über Viewer (exec) auf An. Ab Werk ist sie aus; die Konsole bietet die Freigabe beim Ausführen an (siehe Schritt 4).
  • Skriptarten: PowerShell und Batch für Windows, Bash für Linux und macOS. Der Client für Windows XP führt keine Skripte aus.

So geht's

Schritt 1: Skript anlegen oder auswählen

  1. Seitenleiste Skripte & Pakete → Reiter Skripte.
  2. Ein vorhandenes Skript wählen — oder Neues Skript. Im Dialog Skript bearbeiten: unter Stammdaten Name *, Typ (PowerShell, Batch (cmd), Bash), Beschreibung, Kategorie, Timeout (Sek.); unter Skript-Code den Befehl; unter Parameter Werte, die beim Start abgefragt werden.
  3. Speichern. Der Relay signiert das Skript; das Gerät prüft die Signatur vor jedem Lauf.

Schritt 2: Freigeben — für wen darf es laufen?

Ein Skript läuft nur dort, wo es freigegeben ist:

  • Für einen Zugang: In der Liste das Skript per Ziehen und Ablegen auf den Zugang im Baum links ziehen. Rechtsklick auf das Skript entfernt die Zuordnung wieder.
  • Für einzelne Geräte oder Gruppen: im Skript unter Verfügbarkeit & Zuweisung → Auf bestimmte Geräte / Gruppen freigeben → Geräte wählen … oder einen Tag eintragen.
  • Für alle Zugänge: Haken ALLE im selben Abschnitt.

Schritt 3: Rückfrage am Gerät festlegen (wahlweise)

Unter Verhalten den Haken Bestätigung am Endpunkt erforderlich — der Benutzer am Gerät muss die Ausführung freigeben setzen. Dann fragt das Gerät vor jedem Lauf dieses Skripts nach.

Schritt 4: Ausführen

  1. Geräte → Rechtsklick auf das Gerät → Ausführen & Verteilen → Skript ausführen….
  2. Das Skript wählen, Weiter.
  3. Parameter ausfüllen. Vorschau zeigt die fertige Befehlszeile, ohne etwas zu senden.
  4. Steht dort „Skript-Ausführung ist auf dem Zielgerät nicht freigegeben — der Lauf würde abgelehnt.“: auf Jetzt freigeben klicken. Das schaltet die Geräte-Einstellung Remote-Kommandozeile über Viewer (exec) für dieses Gerät ein; das Gerät meldet sich kurz neu an.
  5. Ausführen.

Für mehrere Geräte: im Dialog weitere Geräte wählen. Alle Läufe stehen danach unter Ausführungen.

Daran sehen Sie, dass es geklappt hat

  • Bei einem Gerät zeigt der Dialog unter Ergebnis Exit-Code, Dauer und die Ausgabe.
  • Seitenleiste Ausführungen → Liste: jeder Lauf mit Gerät, Zeit und Ergebnis; ein Klick öffnet Ausführungs-Details. Auswertung zeigt die Ergebniswerte eines Skripts je Gerät als Tabelle.
  • In den Einzelheiten des Geräts unter Skripte & Pakete steht, was dort gelaufen ist.

Was die andere Seite sieht

Verlangt das Skript oder das Gerät eine Rückfrage, sieht die Person am Gerät Name und Inhalt des Skripts und muss zulassen. Am Gerät heißt der Schalter dafür Skript-Ausführung bestätigen (unter EinstellungenSicherheit, ab Werk an). Er wirkt nur, wenn das Programm am Gerät mit Fenster läuft; der Hintergrunddienst fragt nur bei Skripten mit dem Haken aus Schritt 3.

Gut zu wissen

  • Vier-Augen gibt es für Skripte nicht. Die Vier-Augen-Freigaben gelten nur für Sitzungen zu Geräten, die als kritisch markiert sind (G3). Ein Skript braucht keine zweite Person — die Freigabe hier heißt: für welche Geräte es laufen darf, und ob das Gerät die Ausführung erlaubt.
  • Was „Remote-Kommandozeile über Viewer (exec)“ alles öffnet: Dieselbe Einstellung erlaubt am Gerät Skripte aus der Konsole, Startknöpfe mit Skripten, das Beenden von Prozessen (G10) und die Kommandozeile in einer Sitzung (E29). Schalten Sie sie nur für Geräte ein, auf denen Sie das wollen.
  • Ein Skript, das zwischen Speichern und Ausführen verändert wurde, läuft nicht — das Gerät prüft Inhalt und Signatur.
  • Fertige Skripte für Startknöpfe (USB sperren, Drucker reparieren …) bringt die Bibliothek mit; am Gerät sind sie ungemessen (G13).
  • Mehrere Schritte nacheinander, mit Warten und Bedingungen: Workflows (G8).

Wenn es nicht klappt

Sie sehenBedeutung und Abhilfe
„Nicht ausgeführt: capability scriptExec not granted“ mit Freigeben & erneut ausführenDie Skript-Ausführung ist am Gerät nicht erlaubt. Auf den Knopf klicken — er schaltet sie für dieses Gerät ein und startet den Lauf neu.
„Für „…“ ist kein Skript zugeordnet — erst in der Bibliothek zuweisen.“Dem Zugang ist kein Skript freigegeben. Schritt 2.
„Das Skript ist keinem Mandanten zugeordnet und nicht für alle Mandanten freigegeben, …“Wie oben: Skript freigeben.
„Kein verbundenes Gerät verfügbar, Skripte laufen nur auf verbundenen Geräten. …“Skripte laufen nur auf Geräten, die gerade online sind. Später erneut.
„Nicht ausgeführt: Ausführung am Endpunkt abgelehnt“Die Person am Gerät hat die Rückfrage abgelehnt.
„Zeitüberschreitung — kein Ergebnis vom Gerät.“Das Skript lief länger als erwartet oder das Gerät antwortet nicht. Timeout (Sek.) im Skript prüfen und unter Ausführungen nachsehen.
„script execution disabled by tenant policy“Die Regel Skripte ausführen erlauben steht im Zugang auf Aus (G3).
„Skripte ist in BrowserDesk Free nicht enthalten, mit einer Cloud-Lizenz schon.“Die Leistung „Skripte“ fehlt — G4, Preise.
„Dieses Skript ist diesem Gerät nicht zugeordnet.“Das Skript ist für dieses Gerät nicht freigegeben. Schritt 2.