Custom Scripts Overview

Was ist ein benutzerdefiniertes Skript?

Benutzerdefinierte Skripte in Kandji sind eine leistungsstarke Möglichkeit, Aufgaben zu automatisieren und Einstellungen auf Mac-Computern zu konfigurieren. Stellen Sie sie sich als eine Reihe von Anweisungen vor, die auf registrierten Geräten mit dem Kandji Agent bereitgestellt und ausgeführt werden können. Mit benutzerdefinierten Skripts können Sie Geräteeinstellungen konfigurieren, Softwareanwendungen installieren oder aktualisieren, Wartungsaufgaben ausführen und Sicherheitsrichtlinien durchsetzen. Sie können auch benutzerdefinierte Skripts verwenden, um Geräteinformationen wie Hardwareinventur oder Systemprotokolle zu sammeln. Eine Sammlung von vorgefertigten und regelmäßig gewarteten Skripten ist in unserem GitHub-Repository verfügbar.

Kandji Custom Script Library Item können Skripte in verschiedenen Sprachen bereitstellen. Unser Support-Team ist jedoch am besten gerüstet, um bei der Problembehandlung von Skripten zu helfen, die in shell, bash, zshell oder Python geschrieben wurden. Der Support kann auch bei AppleScript hilfreich sein, sofern es von einer der unterstützten Sprachen aufgerufen wird.

Funktionsweise von benutzerdefinierten Skripten

Der Kandji Agent führt benutzerdefinierte Skripts auf registrierten Macintosh-Computern aus. Ihr benutzerdefiniertes Skript kann eine beliebige Shell oder einen Interpreter auf dem Mac-Computer angeben. Wenn keine Shell oder kein Interpreter angegeben ist, wird die Standard-Shell (/bin/sh) verwendet. Benutzerdefinierte Skripte werden immer als Root-Benutzer ausgeführt.

Häufigkeit der Ausführung

Abhängig von dem Skript, das Sie bereitstellen möchten, können Sie angeben, ob es einmal bei jedem Einchecken, einmal pro Tag oder bei Bedarf von Self Service ausgeführt werden soll.

Einmal pro Gerät installieren: Das Skript wird einmal pro Gerät ausgeführt. Wenn das Skript fehlschlägt, wird es bei den folgenden Eincheckvorgängen automatisch erneut versucht, bis es erfolgreich ist.
Alle 15 Minuten ausführen: Das Skript wird bei jedem Check-in (~ alle 15 Minuten) ausgeführt.
Täglich ausführen: Das Skript wird basierend auf der vorherigen Laufzeit alle 24 Stunden ausgeführt.
- Das Custom Script Library Item kann in den oben genannten 3 Szenarien zusätzlich über Self Service angeboten werden
On-Demand-Ausführung von Self Service: Das Skript wird nie automatisch ausgeführt und nur als optionales Element von Self Serviceangeboten. Nach dem Ausführen des Elements wird die Schaltfläche Ausführen erneut in Ausführen umbenannt.

Exit-Codes und -Ausgaben

Wenn ein Skript mit dem Exit-Code 0 beendet wird, wird dies als übergebenes Ergebnis betrachtet. Wenn es mit einem anderen Exit-Code als 0 beendet wird, wird es als Warnung/Fehler betrachtet.
Stdout und Stderr werden in den Überwachungsinformationen des Skripts aufgezeichnet, die auf der Statusseite des Geräts oder auf der Statusseite des benutzerdefinierten Skripts zu finden sind.

Optionen für Standardisierung und Neustart

Ein Wartungsskript ermöglicht es, das Hauptüberwachungsskript als echtes Überwachungsskript zu nutzen, um die Systemkonfiguration oder den Anwendungsstatus zu überprüfen. Wenn dieses Überwachungsskript mit einem anderen Beendigungscode als 0 beendet wird, wird dies als Überwachungsfehler betrachtet, und das Wartungsskript wird dann ausgeführt.
- Wenn das Wartungsskript dann mit dem Beendigungscode 0 beendet wird, lautet der Status des Bibliothekselements für dieses Gerät Behoben. Wenn das Wartungsskript fehlschlägt, lautet der Status des Bibliothekselements für dieses Gerät Warnung.
Mit der Option restart können Sie einen Neustart nach einer erfolgreichen Skriptausführung erzwingen. Wenn Sie diese Option auswählen, erhält der Benutzer einen Neustart-Timer von der Kandji Agent Menüleistenanwendung. Dieser Timer ist ein 5-Minuten-Neustart-Timer, wenn das Element von Self Service aus initiiert wurde, oder ein 30-Minuten-Neustart-Timer, wenn er auf andere Weise initiiert wurde, z. B. während eines Check-ins. Die Neustartoption verhält sich je nach Verwendung eines Wartungsskripts anders.
- Wenn ein Wartungsskript genutzt wird und das Wartungsskript 0 beendet, wird der Neustart-Countdown ausgelöst, wenn das Wartungsskript beendet wird.
- Wenn ein Wartungsskript nicht genutzt wird und das Überwachungsskript 0 beendet, wird der Neustart-Countdown ausgelöst, wenn das Überwachungsskript beendet wird.

Hinzufügen eines benutzerdefinierten Skripts Library Item