# Command-Line Launch

COM Agent는 명령줄에서 미리 구성된 상태로 시작하여 즉시 캡처를 시작할 수 있습니다. 이는 자동화에 유용합니다 — 고정된 구성으로 다른 프로그램, 바탕 화면 바로 가기 또는 시작 스크립트에서 실행하는 경우입니다.

애플리케이션 창은 평소와 같이 열립니다. 매개변수는 단지 설정을 대신 채워주며 캡처가 자동으로 시작됩니다.

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

## 옵션

옵션 이름은 창의 설정과 일치합니다. 생략한 옵션은 저장된 값을 유지합니다.

| 옵션 | 값 / 예시 | 의미 |
| --- | --- | --- |
| `--mode` | `live` 또는 `demo` | 캡처 모드. `demo`는 COM 포트가 필요 없습니다. |
| `--port` | `COM3` | 직렬 포트(실시간 캡처에 필요). |
| `--baud` | `19200` | 보 레이트. |
| `--part-marker` | `^` | 완전한 측정 세트를 구분하는 마커. |
| `--part-count` | `4` | 완전한 세트를 구성하는 파트 수. |
| `--output` | `"C:\Data"` | TXT/CSV 파일의 출력 폴더. |
| `--file-extension` | `txt`, `csv`, `csv+txt`, `keyboard` | 출력 형식. 여러 개를 `+`로 조합합니다. |
| `--csv-delimiter` | `comma`, `semicolon`, `tab` | CSV 열 구분 기호. |
| `--csv-decimal` | `dot`, `comma` | CSV 숫자의 소수점 구분 기호. |
| `--csv-time-format` | `utc`, `local` | CSV *Timestamp* 열의 형식. |
| `--csv-encoding` | `utf8`, `utf8-bom` | CSV 파일 인코딩(바이트 순서 표시 포함 또는 미포함). |
| `--keyboard-value` | `mean`, `min`, `max`, `stddev`, `measurements`, `raw` | 입력할 값. 여러 개를 `+`로 조합합니다. |
| `--keyboard-separator` | `tab`, `enter`, `none` | 입력된 값 사이에 누르는 키. |
| `--keyboard-suffix` | `tab`, `enter`, `none` | 마지막 값 뒤에 누르는 키. |
| `--keyboard-decimal` | `.` 또는 `,` | 입력된 값의 소수점 구분 기호. |
| `--keyboard-delay` | `40` | 각 키 입력 후 일시 정지(밀리초). |
| `--start` | *(값 없음)* | 다른 매개변수가 없을 때 저장된 설정으로 시작. |

매개변수가 하나라도 주어지면(또는 `--start`만 단독으로 주어지면) 캡처가 자동으로 시작됩니다.

## 예시

COM3에서 CSV 및 TXT 파일로 캡처:

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

평균과 최소값을 탭으로 구분하여 포커스가 있는 애플리케이션에 입력:

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

데모 모드로 시작(기기 불필요):

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

> [!info] 창은 평소처럼 열리므로 실시간 활동을 계속 확인하고 언제든지 캡처를 중지할 수 있습니다. 공백이 포함된 경로는 따옴표로 묶으십시오.

> [!warning] 실시간 캡처에는 여전히 유효한 [라이선스](rhopoint-com-agent-licensing.md)가 필요합니다. 실행 구성이 불완전하거나 유효하지 않은 경우(예: 출력 폴더가 존재하지 않는 경우) COM Agent는 수동 시작에서와 동일한 메시지를 표시합니다.

[다음: COM Agent를 최신 상태로 유지하기](rhopoint-com-agent-updating-com-agent.md)