# Start über die Befehlszeile

COM Agent kann über die Befehlszeile vorkonfiguriert gestartet werden und beginnt sofort mit der
Erfassung. Das ist praktisch für die Automatisierung — etwa der Start aus einem anderen Programm,
über eine Verknüpfung oder ein Startskript mit fester Konfiguration.

Das Anwendungsfenster öffnet sich weiterhin normal; die Parameter füllen lediglich die Einstellungen
für dich aus, und die Erfassung startet automatisch.

```
RhopointComAgent.exe --mode live --port COM3 --output "C:\Data" --file-extension csv+txt
```

## Optionen

Die Optionsnamen entsprechen den Einstellungen im Fenster. Jede weggelassene Option behält ihren
gespeicherten Wert.

| Option | Werte / Beispiel | Bedeutung |
| --- | --- | --- |
| `--mode` | `live` oder `demo` | Erfassungsmodus. `demo` benötigt keinen COM-Port. |
| `--port` | `COM3` | Serieller Port (für die Live-Erfassung erforderlich). |
| `--baud` | `19200` | Baudrate. |
| `--part-marker` | `^` | Markierung, die einen vollständigen Messsatz abgrenzt. |
| `--part-count` | `4` | Anzahl der Teile, die einen vollständigen Satz bilden. |
| `--output` | `"C:\Data"` | Ausgabeordner für TXT-/CSV-Dateien. |
| `--file-extension` | `txt`, `csv`, `csv+txt`, `keyboard` | Ausgabeformat(e); mehrere mit `+` kombinieren. |
| `--csv-delimiter` | `comma`, `semicolon`, `tab` | CSV-Spaltentrennzeichen. |
| `--csv-decimal` | `dot`, `comma` | Dezimaltrennzeichen für CSV-Zahlen. |
| `--csv-time-format` | `utc`, `local` | Format der CSV-Spalte *Timestamp*. |
| `--csv-encoding` | `utf8`, `utf8-bom` | CSV-Dateikodierung (mit oder ohne Byte-Order-Mark). |
| `--keyboard-value` | `mean`, `min`, `max`, `stddev`, `measurements`, `raw` | Zu tippende(r) Wert(e); mehrere mit `+` kombinieren. |
| `--keyboard-separator` | `tab`, `enter`, `none` | Taste zwischen den getippten Werten. |
| `--keyboard-suffix` | `tab`, `enter`, `none` | Taste nach dem letzten Wert. |
| `--keyboard-decimal` | `.` oder `,` | Dezimaltrennzeichen für getippte Werte. |
| `--keyboard-delay` | `40` | Pause in Millisekunden nach jedem Tastenanschlag. |
| `--start` | *(ohne Wert)* | Mit den gespeicherten Einstellungen starten, wenn keine weiteren Parameter angegeben sind. |

Die Erfassung startet automatisch, sobald ein Parameter angegeben wird (oder `--start` allein).

## Beispiele

Von COM3 in CSV- und TXT-Dateien erfassen:

```
RhopointComAgent.exe --port COM3 --output "C:\QA\Thickness" --file-extension csv+txt
```

Mittelwert und Minimum tab-getrennt in die fokussierte Anwendung tippen:

```
RhopointComAgent.exe --port COM3 --file-extension keyboard --keyboard-value mean+min --keyboard-separator tab
```

Im Demo-Modus starten (kein Instrument nötig):

```
RhopointComAgent.exe --mode demo --output "C:\Data" --file-extension txt
```

> [!info] Das Fenster öffnet sich wie gewohnt, sodass du die Live-Aktivität verfolgen und die Erfassung jederzeit stoppen kannst. Setze Pfade mit Leerzeichen in Anführungszeichen.

> [!warning] Die Live-Erfassung benötigt weiterhin eine gültige [Lizenz](rhopoint-com-agent-licensing.md). Ist die Start-Konfiguration unvollständig oder ungültig (zum Beispiel ein nicht vorhandener Ausgabeordner), zeigt COM Agent dieselbe Meldung wie bei einem manuellen Start.

[Weiter: COM Agent aktuell halten](rhopoint-com-agent-updating-com-agent.md)