protectctl Befehlszeilentool

Leitfaden zur Evaluierung von Jamf Protect

Solution
Application
Content Type
Technische Dokumentation
Utilities & Services
ft:locale
de-DE

Der Jamf Protect Agent beinhaltet das Tool protectctl, das es Ihnen ermöglicht, einige Terminal Befehle auf Computern auszuführen. Es sind die folgenden Befehle verfügbar:

Befehl

Beschreibung

repair

Findet und behebt Probleme, die während der Installation des Jamf Protect Agent auftreten können.

version

Gibt die auf Computern installierte Jamf Protect Agent-Version aus

info

Gibt die folgenden Informationen zu Computern aus:

  • Agenten-Betriebszeit und Version
  • Installationstyp (Systemerweiterung oder Launch Daemon)
  • Agent-Status (z. B. „Protected [Geschützt]“, „Enrolling [Registrierung]“, „Missing Plan [Fehlender Plan]“)
  • Mandantenname
  • Plan-ID
  • Plan-Hash
  • Planprotokollstufe
  • Datum und Uhrzeit des letzten Agent-Check-Ins
  • Datum und Uhrzeit des letzten Konformitäts-Check-Ins

Sie können auch die folgenden Flags verwenden:

  • Das Flag -v gibt ausführliche Informationen zum Agent aus:
    • Agent-Verbindungsinformationen (Status, Protokoll, Kennung und Protokolle in der Warteschlange zum Senden an einen Datenendpunkt)
    • Planinformationen (ID, Protokollebene, Status für erweiterte Bedrohungskontrolle, Telemetrie und Manipulationsschutz)
    • Informationen zur Bedrohungsvermeidung (aktuelle Version, Ereignis, Trefferanzahl pro Sensor)
  • Das Flag --json gibt die Informationen im JSON-Format aus.
  • Das Flag --plist gibt die Informationen im PLIST-Format aus.
  • Das Flag --plain gibt die Informationen als reinen Text ohne Tabellen aus.

checkin

Erzwingt einen Jamf Protect Agent-Check-In auf Computern. Sie können auch das Flag --insights verwenden, um einen Konformitäts-Check-In zu erzwingen.

help

Gibt Hilfeinformationen zu protectctl-Befehlen aus.

diagnostics

Ändert vorübergehend die Protokollstufe zu Diagnosezwecken.

Sie können auch die folgenden Flags verwenden:
  • Das Flag -d (--duration) ändert die vorübergehende Dauer für die Festlegung der ausgewählten Protokollstufe für eine bestimmte Zeitspanne. Die Standarddauer beträgt fünf Minuten.
  • Das Flag -e (--enable) aktiviert den Diagnosemodus. Die Standardeinstellung ist „true“ (wahr).

  • Das Flag -m (--mode) wird in Verbindung mit -l (--loglevel) verwendet und ändert die Darstellung der Protokolle.
    • Der Standardmodus stream bietet Live-Protokollstreaming und Protokollerfassung während der festgelegten Dauer der angegebenen Protokollstufe. Dieses Flag überschreibt die Standard-Protokollstufe und legt sie auf „Verbose (ausführlich)“ fest. Die Höchstdauer beträgt 60 Minuten.

    • Der Modus loglevel überschreibt die Standard-Protokollstufe und legt sie auf die angegebene Protokollstufe für die festgelegte Dauer ohne Protokollerfassung fest. Die Höchstdauer beträgt acht Stunden.

  • Das Flag -l (--loglevel) ändert die Protokollstufe auf eine ausgewählte Stufe für die mit dem Flag -d festgelegte vorübergehende Dauer. Die Standardprotokollstufe ist „verbose“ (ausführlich).
  • Das Flag -v (--verbose) gibt ausführliche Informationen zur Ausgabe des Diagnosebefehls aus.
  • Das Flag -o (--output-directory) ermöglicht das Angeben eines Speicherorts für die Diagnoseausgabeinformationen. Der standardmäßige Speicherort ist der Schreibtisch.

Von protectctl Befehlen zurückgegebene Informationen können auch mit Jamf Pro über Erweiterungsattribute für zusätzliche Verwaltungsaktionen geteilt werden. Beispiele für Erweiterungsattribute finden Sie in den Jamf Protect Erweiterungsattribut-Vorlagen in Jamf Pro oder im Jamf Protect Open Source GitHub Repository von Jamf: jamf / jamfprotect (GitHub).