„Notify“-Skriptbefehle

Jamf Connect Dokumentation

Solution

Application

Jamf Connect

Content Type

Technische Dokumentation

Utilities & Services

ft:locale

de-DE

Allgemeine Befehle

Die folgenden Befehle können benutzt werden, um Mitteilungen auf dem „Notify“-Bildschirm anzuzeigen (Abbildung unten).

Bild der häufig verwendeten Befehle zur Anzeige des „Notify“-Bildschirms.

Image:: Mit diesem Befehl wird das Standardbild für den „Notify“-Mechanismus durch ein Bild ersetzt, das unter dem angegebenen Pfad gespeichert ist. Die Größe des Bildes wird dabei automatisch korrekt angepasst.
Beispiel:
Command: Image: /tmp/logo.png
MainText:: Mit diesem Befehl wird der Haupttext geändert, der dem Benutzer angezeigt wird.
Beispiel:
Command: MainText: Please wait while your new MacBook Pro is set up.
MainTextImage:: Mit diesem Befehl wird der Haupttext durch ein benutzerdefiniertes Symbol ersetzt, das unter dem angegebenen Pfad gespeichert ist. Es werden Bilder mit einer Auflösung von bis zu 660 x 105 Pixel unterstützt. Bilder mit abweichender Auflösung werden unter Beibehaltung des Seitenverhältnisses skaliert..
Beispiel:
Command: MainTextImage: /tmp/logo.png
MainTitle:: Mit diesem Befehl wird der Haupttitel geändert, der dem Benutzer angezeigt wird.
Beispiel:
Command: MainTitle: Welcome to your new MacBook Pro

Interaktive Befehle

Mithilfe interaktiver Befehle kann die Interaktion mit dem Benutzer während der Ausführung des Prozesses für den „Notify“-Mechanismus angepasst werden (Abbildung unten).

Determinate:: Mit diesem Befehl wird statt eines sich drehenden Symbols eine Fortschrittsanzeige aktiviert, bei der der Fortschritt in Schritten „bestimmt“ und angezeigt wird. Sie müssen die Anzahl von Schritten angeben, die die Fortschrittsanzeige des „Notify“-Mechanismus enthalten soll. Mit jeder Statusänderung in Ihrem Skript wird die Fortschrittsanzeige um einem weiteren Schritt vervollständigt.
Beispiel:
Command: Determinate: 5
DeterminateManual:: Mit diesem Befehl wird der Fortschritt bestimmt und die Fortschrittsanzeige manuell anstatt mit Fortschrittsbefehlen vervollständigt. Geben Sie hierfür die gewünschte Anzahl von Schritten ein, die die Fortschrittsanzeige des „Notify“-Mechanismus enthalten soll. Die Fortschrittsanzeige muss anschließend mithilfe des Befehls DeterminateManualStep: manuell vervollständigt werden.
Beispiel:
Command: DeterminateManual: 5
DeterminateManualStep:: Im Modus DeterminateManual: wird die Fortschrittsanzeige mit diesem Befehl um einen Schritt oder ein angegebenes Intervall vervollständigt. Mit dem folgenden Beispielbefehl wird die Fortschrittsanzeige um zwei Schritte ergänzt.
Beispiel:
Command: DeterminateManualStep: 2
DeterminateOff:: Mit diesem Befehl wird die Bestimmung des Fortschritts für die Fortschrittsanzeige deaktiviert. Bereits durchlaufene Schritte erscheinen in der Fortschrittsanzeige weiterhin als abgeschlossen. Auf diese Weise können Sie zwischen einer bestimmten und unbestimmten Fortschrittsanzeige wechseln, ohne dass Ihr Fortschritt verloren geht.
Beispiel:
Command: DeterminateOff:
DeterminateOffReset:: Nachdem Sie die Bestimmung des Fortschritts für die Fortschrittsanzeige deaktiviert haben, müssen Sie die Fortschrittsanzeige auf Anfang zurücksetzen.
Beispiel:
Command: DeterminateOffReset:
Quit: Mit diesem Befehl wird der Prozess des „Notify“-Mechanismus beendet.
Beispiel:
Command: Quit

Sie können den Benutzer mithilfe des Befehls echo Status: über Statusänderungen im Zusammenhang mit der Ausführung des „Notify“-Mechanismus informieren. Nachfolgend finden Sie ein Beispiel für eine solche Statusänderung:

 Status: Installing Jamf

Hinweis:

Bei Verwendung des Befehls Determinate: wird die Fortschrittsanzeige mit jeder Statusänderung vervollständigt.

Wenn Sie Jamf Pro verwenden, können Sie den „Notify“-Bildschirm stattdessen auch zum Auslesen und Anzeigen von Richtlinienprotokollen von Jamf Pro für Benutzer konfigurieren. Legen Sie hierfür die Einstellung Protokollstil für „Notify“-Bildschirm (NotifyLogStyle) auf den Wert jamf fest.