# Command-Line Launch

COM Agent può essere avviato con configurazione preimpostata dalla riga di comando e iniziare immediatamente l'acquisizione. Questo è
utile per l'automazione — avviandolo da un altro programma, da un collegamento sul desktop o da uno script di avvio
con una configurazione fissa.

La finestra dell'applicazione si apre comunque normalmente; i parametri si limitano a compilare le impostazioni per te e
l'acquisizione si avvia automaticamente.

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

## Opzioni

I nomi delle opzioni corrispondono alle impostazioni della finestra. Qualsiasi opzione omessa mantiene il valore salvato.

| Opzione | Valori / esempio | Significato |
| --- | --- | --- |
| `--mode` | `live` o `demo` | Modalità di acquisizione. `demo` non richiede una porta COM. |
| `--port` | `COM3` | Porta seriale (richiesta per l'acquisizione live). |
| `--baud` | `19200` | Velocità in baud. |
| `--part-marker` | `^` | Marcatore che delimita un set di misurazioni completo. |
| `--part-count` | `4` | Numero di parti che compongono un set completo. |
| `--output` | `"C:\Data"` | Cartella di uscita per i file TXT/CSV. |
| `--file-extension` | `txt`, `csv`, `csv+txt`, `keyboard` | Formato/i di uscita; combinane più di uno con `+`. |
| `--csv-delimiter` | `comma`, `semicolon`, `tab` | Delimitatore di colonne CSV. |
| `--csv-decimal` | `dot`, `comma` | Separatore decimale per i numeri CSV. |
| `--csv-time-format` | `utc`, `local` | Formato della colonna *Timestamp* del CSV. |
| `--csv-encoding` | `utf8`, `utf8-bom` | Codifica del file CSV (con o senza byte-order mark). |
| `--keyboard-value` | `mean`, `min`, `max`, `stddev`, `measurements`, `raw` | Valore/i da digitare; combinane più di uno con `+`. |
| `--keyboard-separator` | `tab`, `enter`, `none` | Tasto premuto tra i valori digitati. |
| `--keyboard-suffix` | `tab`, `enter`, `none` | Tasto premuto dopo l'ultimo valore. |
| `--keyboard-decimal` | `.` o `,` | Separatore decimale per i valori digitati. |
| `--keyboard-delay` | `40` | Pausa in millisecondi dopo ogni pressione di tasto. |
| `--start` | *(nessun valore)* | Avvia con le impostazioni salvate quando non vengono forniti altri parametri. |

L'acquisizione si avvia automaticamente ogni volta che viene fornito un parametro qualsiasi (o `--start` da solo).

## Esempi

Acquisire da COM3 in file CSV e TXT:

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

Digitare la media e il minimo nell'applicazione con il focus, separati da tabulazione:

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

Avviare in modalità demo (nessuno strumento necessario):

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

> [!info] La finestra si apre come al solito, così puoi comunque seguire l'attività in tempo reale e arrestare l'acquisizione in qualsiasi momento. Racchiudi tra virgolette i percorsi che contengono spazi.

> [!warning] L'acquisizione live richiede comunque una [licenza](rhopoint-com-agent-licensing.md) valida. Se la configurazione di avvio è incompleta o non valida (ad esempio, la cartella di uscita non esiste), COM Agent mostra lo stesso messaggio che mostrerebbe per un avvio manuale.

[Avanti: mantenere COM Agent aggiornato](rhopoint-com-agent-updating-com-agent.md)