Der Abschnitt Befehlsergebnisse in Trio bietet eine zentrale Echtzeit-Schnittstelle zur Überwachung der Ergebnisse von Befehlsausführungen auf registrierten Geräten. Nachdem Befehle gesendet wurden, sei es manuell, planmäßig oder über Automatisierungstrigger, werden ihr Status, ihre Ausgabe und ihre Ausführungsmetadaten erfasst und in dieser Ansicht angezeigt.
Diese Funktion ist entscheidend für IT-Administratoren, die für die Überprüfung des Aufgabenabschlusses, die Diagnose von Befehlsfehlern, die Validierung von Konfigurationen und die Durchführung von Audit-Überprüfungen verantwortlich sind. Sie ermöglicht eine detaillierte Einblick in die Ausführung auf Geräteebene, einschließlich Exit-Codes, Protokolle, Laufzeitfehler und befehlsspezifische Ausgaben.
Voraussetzungen
Nur Benutzer mit Berechtigungen zum Ausführen oder Verwalten von Befehlen, wie z. B. Super Admin, IT Admin oder benutzerdefinierte Rollen mit aktiviertem „Befehlsausführungsprotokollzugriff“, können diesen Abschnitt anzeigen.
Damit Befehlsergebnisse generiert werden können, müssen die folgenden Bedingungen erfüllt sein:
Auf dem Zielgerät muss der Trio-Agent installiert und aktiv sein.
Befehl
Geräte müssen zum Zeitpunkt der Ergebnisübertragung mit dem Server kommunizieren können.
Der Befehl darf nicht durch Netzwerkfehler, Timeouts oder manuelle Abbrüche vor der Protokollierung unterbrochen worden sein.
Zugriffspfad
Flotte → Befehl → Ergebnisse
Überblick über die Ergebnisschnittstelle
Wenn Befehle ausgeführt werden, erfasst und präsentiert Trio Ergebnisdatensätze in einer strukturierten Tabelle. Der obere Teil der Ansicht enthält eine Suchleiste und mehrdimensionale Filter, um die Sichtbarkeit zu verfeinern, basierend auf:
Status – Filtern nach Ergebnis (z. B. Erfolg, Timeout, Fehler)
Betriebssystem/Umgebung – Windows (CMD/PowerShell) oder macOS (bash/zsh)
Exit-Code – Benutzerdefinierte oder Standard-Exit-Codes (z. B. 0 für Erfolg)
Gerät – Gerätename, auf dem die Befehle ausgeführt wurden
Befehle
Jeder Ergebniseintrag enthält Folgendes:
Befehlsname – Der Name, wie er bei der Erstellung definiert wurde
Betriebssystem (Umgebung) – Das Betriebssystem und die Ausführungsumgebung (z. B. PowerShell)
Gerät – Der spezifische Endpunkt, der den Befehl ausgeführt hat
Exit-Code – Numerische Ausgabe, die das Ausführungsergebnis angibt
Status – Erfolg, Timeout oder Fehler
Beendet am – Zeitstempel der Fertigstellung
Anzeigen von Befehlsergebnisdetails
Durch Klicken auf eine beliebige Ergebniszeile wird die Ansicht Befehlsergebnisdetails erweitert. Dieses Modal enthält eine umfassende Aufschlüsselung der Ausführung, einschließlich:
Gerät – Der vollständige Name des Endpunkts
Gruppenname – Organisationsgruppe, zu der das Gerät gehört
Ausführen als – Ausführungsberechtigungen (System/Root)
Exit-Code – Der zurückgegebene Exit-Wert (z. B. 1 = allgemeiner Fehler, 0 = Erfolg)
Server- und Agent-Zeitsynchronisierung – Nützlich für zeitliche Diskrepanzen
Start-/Endzeitstempel – Genaue Start- und Stoppzeiten
Dateien – Falls welche angehängt oder heruntergeladen wurden
Raw-Befehl – Der vollständige Befehlsinhalt, wie er auf dem Gerät ausgeführt wurde
Befehlsprotokollausgabe – Standardausgabe oder Protokolle, die vom Agent zurückgegeben werden, einschließlich Laufzeitmeldungen, Fehlertraces oder Echo-Werte
Exportieren von Befehlsergebnissen
In der Ergebnisdetailansicht ist eine Schaltfläche Exportieren verfügbar. Dies ermöglicht es Administratoren, die Ergebnisdetails (in der Regel in JSON oder CSV) für Compliance, Offline-Überprüfung oder Ticket-Eskalation herunterzuladen.
Dieser Export umfasst den gesamten Ausführungskontext: Gerätemetadaten, Protokolle, Befehlsinhalt und Zeitstempel. Er ist besonders wertvoll bei der Untersuchung von Systemfehlkonfigurationen oder fehlgeschlagenen Bereitstellungen.
Systemverhaltenshinweise
Timeouts treten auf, wenn ein Befehl sein definiertes Laufzeitlimit überschreitet. Diese werden deutlich rot mit dem Status „Timeout“ und dem Exit-Code
1gekennzeichnet.Fehler können aus Syntaxproblemen, ungültigen Pfaden, Berechtigungsproblemen oder fehlenden Abhängigkeiten resultieren. Diese geben den Status „Fehler“ und den Exit-Code
1zurück (sofern nicht durch den Befehl überschrieben).Erfolg wird durch den Exit-Code
0und grüne „Erfolg“-Labels angezeigt.Agentenseitige Verzögerungen oder Fehler bei der Ergebnisübertragung können zu fehlenden oder unvollständigen Protokollen führen.
Gerät zum Zeitpunkt der Fertigstellung offline? Wenn der Befehl ausgeführt wird, die Ergebnissynchronisierung jedoch fehlschlägt, wird er möglicherweise nicht angezeigt. Stellen Sie eine zuverlässige Netzwerkverbindung sicher.
Fehlerbehebung
Fehlende Ergebnisse? Stellen Sie sicher, dass der Befehl ordnungsgemäß zugewiesen wurde und das Gerät während und nach der Ausführung online war.
Unerwarteter Exit-Code? Beachten Sie die Logik Ihres Befehls und stellen Sie sicher, dass die Rückgabewerte korrekt definiert sind.
Protokollausgabe fehlt? Stellen Sie sicher, dass der Befehl die Ausgabe in STDOUT oder STDERR schreibt, die Trio erfasst.
Status zeigt Timeout, aber beendet? Dies kann auf eine Diskrepanz zwischen der Timeout-Konfiguration und der tatsächlichen Ausführungszeit hinweisen. Überprüfen Sie die Einstellung „Timeout“ unter der Befehlsdefinition.