ComPortBinder-CLI: Grundlagen, Befehle und Exit-Codes Pro

Alle Kernfunktionen von ComPortBinder stehen als Kommandozeilen-Befehle bereit – für PowerShell-, Batch- und Python-Skripte, Deployment und CI/CD. Diese Anleitung erklärt den korrekten Aufruf, die wichtigsten Befehle und die Auswertung der Exit-Codes (Pro-Lizenz erforderlich).

Der richtige Aufruf: Konsole, Batch, PowerShell

ComPortBinder ist eine Windows-Anwendung (WinExe). In einer interaktiven Konsole kehrt der Prompt deshalb sofort zurück – dort start /wait voranstellen, damit die Ausgabe und der Exit-Code ankommen. In Batch-Dateien wartet der Aufruf automatisch korrekt und %ERRORLEVEL% stimmt.

:: Interaktive Eingabeaufforderung:
start /wait ComPortBinder.exe list

:: In Batch-Dateien genuegt:
ComPortBinder.exe list

:: PowerShell:
$p = Start-Process ComPortBinder.exe -ArgumentList "scan" -Wait -PassThru
$p.ExitCode

Die wichtigsten Befehle

ComPortBinder.exe list          :: Geraete mit Status und COM-Nummer auflisten
ComPortBinder.exe list-rules    :: Regeln anzeigen
ComPortBinder.exe scan          :: Ist-Zustand pruefen (Exit 3 bei Abweichungen)
ComPortBinder.exe correct all   :: Alle Abweichungen korrigieren (ueber den Dienst)
ComPortBinder.exe help          :: Vollstaendige Befehlsreferenz

Darüber hinaus gibt es Befehle für Regel-Verwaltung (rule), Profile (profile, export-config/import-config), Berichte (report), Einstellungen (config), Lizenz (license) und den Windows-Dienst (service).

Exit-Codes auswerten

0 = Erfolg · 1 = Fehler · 2 = Lizenz oder Adminrechte fehlen · 3 = Zustandsabweichung ohne Fehler – etwa scan mit ausstehenden Korrekturen oder service status bei gestopptem Dienst.

Exit-Code 3 macht scan zum Monitoring-Werkzeug: Ein Skript erkennt daran, dass Korrekturen anstehen, ohne etwas zu verändern. Beispiele dazu in CLI-Automatisierung.

Häufige Fragen

Brauche ich für die CLI eine Pro-Lizenz?

Ja – mit zwei Ausnahmen: die license-Befehle (Aktivierung muss ohne Lizenz möglich sein) und die service-Befehle funktionieren auch ohne Pro. Die 14-tägige Testphase schaltet die komplette CLI frei.

Warum sehe ich CLI-Änderungen nicht sofort in der geöffneten GUI?

GUI und CLI halten eigene Caches auf den gemeinsamen Konfigurationsdateien. Änderungen per CLI werden in einer bereits laufenden GUI erst nach deren Neustart sichtbar.

Welche Befehle brauchen Administrator-Rechte?

Im Normalfall keine – Korrekturen führt der bei der Installation eingerichtete Windows-Dienst aus (Adminbrücke). Nur wenn der Dienst nicht läuft, braucht correct erhöhte Rechte; service ensure startet ihn nach einmaliger UAC-Bestätigung. Lese-Befehle wie list, list-rules und scan laufen immer ohne erhöhte Rechte.

ComPortBinder 1.37.0 für Windows

MSI-Installer, 1,7 MB. Jede Installation startet mit einer 14-tägigen Pro-Testphase – ohne Registrierung.

Zum Download