rdp-cli · 0.3.1

rdp-cli 명령어 참조

원격 데스크톱, Linux 앱 및 Android를 위한 109개 명령: 연결, 관찰, 입력, 파일 교환과 제어권 인계.

작업별 명령 찾기

처음 사용하나요? 설치와 첫 연결부터 시작하세요. →

connect
지속적인 RDP, VNC 또는 Android ADB 세션에 연결합니다.
screenshot
일관된 PNG 관찰 캡처
click
원격 좌표 클릭
type
클립보드를 바꾸지 않고 입력합니다. Android는 출력 가능한 ASCII, 줄바꿈, 탭을 지원하며 Unicode 붙여넣기는 android text를 사용합니다.
files upload
세션 파일 루트로 업로드하고 완료된 전송을 확인합니다.
files download
RDP 교환 드라이브 또는 안정적인 Android 파일 스냅샷에서 다운로드합니다.
watch
사람을 위한 뷰어 열기
list
접근 가능한 세션 목록

Windows, macOS, Linux 빌드 2026110701에서 확인한 명령 목록입니다. 설치된 파일은 --version과 --help-json으로 확인하세요.

관찰·실행·검증

USER, SESSION, OBSERVATION, X, Y는 실제 값으로 바꿔야 합니다. stdin으로 암호를 전달한 뒤 스트림을 닫으세요. --password-stdin은 대화형 암호 창을 열지 않습니다. data.session을 저장하고 before.png를 읽어 좌표를 고른 다음 after.png를 확인하세요. 입력 전송은 작업 완료를 증명하지 않습니다.

rdp-cli connect --host desktop.example.net --user USER --password-stdin
rdp-cli screenshot --session SESSION --out before.png
rdp-cli click --session SESSION --desktop --x X --y Y --observation OBSERVATION
rdp-cli screenshot --session SESSION --out after.png

--version은 버전과 기능, --help-json은 기계가 읽을 수 있는 목록을 반환합니다. COMMAND --help는 세션을 시작하지 않고 전체 옵션을 설명합니다.

rdp-cli --version
rdp-cli --help-json
rdp-cli connect --help

JSON 및 공통 옵션

일반 명령은 stdout에 UTF-8 JSON 객체 하나를 반환합니다. 성공은 ok: true와 data, 실패는 ok: false와 error입니다. stderr는 진단용입니다. 종료 코드는 성공 0, 실행 실패 1, 잘못된 인수 2입니다.

도움말은 일반 텍스트입니다. events --follow는 NDJSON을 스트리밍하며 일반 events는 data.events와 data.ndjson을 담은 단일 JSON 결과를 반환합니다. PowerShell 5.1에서 비ASCII 텍스트를 처리하려면 [Console]::OutputEncoding과 $OutputEncoding을 UTF-8로 설정하세요.

data.session
connect가 반환한 세션 ID를 다음 명령에 사용합니다.
data.observation
캡처의 관찰 토큰입니다. 재연결, 제어권 또는 화면 배치 변경 후 다시 캡처합니다.
data.capabilities
파일, 오디오, 클립보드, 화면 작업 전에 협상된 기능을 확인합니다.
data.state / data.remote_outcome
queued, sent, partial, unknown, cancelled, failed는 입력 진행 상태입니다. remote_outcome: not_confirmed는 결과 확인이 필요합니다.
data.transfer_id
files status 또는 files cancel에 전달합니다. 최종 상태를 기다리고 완료 파일의 해시를 확인합니다.
error.code / error.message / error.retryable
안정적인 오류 코드로 판단합니다. 메시지와 retryable은 참고 정보이며 무조건 재시도하라는 뜻이 아닙니다.
data.activity
현재 또는 최근 활동, Agent/사람 구분, 경과 시간과 전송 진행률입니다. 입력 내용과 클립보드 내용은 포함하지 않으며 원격 작업 완료를 증명하지 않습니다.

모든 명령은 --request-id와 --timeout-ms를 지원합니다. 보관 기간 안에서 동일한 명령과 인수를 다시 보낼 때만 ID를 재사용하세요. 로컬 시간 초과가 미전송을 뜻하지는 않습니다. 먼저 operations status를 조회하세요.

--request-id ID · --timeout-ms MILLISECONDS

세션

RDP/VNC connect에는 --host, RDP에는 --user도 필요합니다. 기본 포트는 3389와 5900입니다. 인증 시 비밀번호 입력원을 하나 선택하며 --vnc-security none은 비밀번호를 쓰지 않습니다. ADB는 --device와 --transport를 사용하고 Wi-Fi 호스트 및 연결 포트를 지정할 수 있습니다. --domain, --size, --layout은 RDP 전용입니다. reconnect 후에는 일시 정지되며 disconnect는 원격 사용자를 로그오프하지 않습니다.

rdp-cli connect#

지속적인 RDP, VNC 또는 Android ADB 세션에 연결합니다.

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--profile

저장된 연결 프로필

텍스트선택
--host

RDP/VNC 호스트 또는 명시적인 Android Wi-Fi 엔드포인트.

텍스트선택
--protocol

프로토콜: RDP, VNC, ADB 또는 X11. 각각 명시적인 대상과 인증 규칙을 사용합니다.

선택값
rdp | vnc | adb | x11
기본값: rdp
선택
--mode

기존 데스크톱 또는 앱 전달 X11 모드.

선택값
desktop | application
선택
--display

허용된 기존 X11 display. 데스크톱 모드 전용.

텍스트선택
--xauthority

기존 원격 Xauthority 파일의 절대 경로. 데스크톱 모드 전용.

텍스트선택
--ssh-known-hosts

로컬 OpenSSH known_hosts 파일. 외부 SSH 실행 파일은 필요 없습니다.

경로선택
--ssh-key

로컬 SSH 개인 키. 암호 입력으로 키 암호를 제공합니다.

경로선택
--ssh-host-key

별도로 검증한 SSH SHA256 지문.

텍스트선택
--linux-file-root

허용된 SFTP 절대 디렉터리. 기본값은 SSH 홈의 비공개 세션 디렉터리입니다.

텍스트선택
--application

이미 설치된 원격 X11 앱의 절대 경로.

텍스트선택
--app-args

JSON 형식의 인수 배열. 셸로 해석하지 않습니다.

텍스트선택
--device

android devices가 반환한 명시적 기기 ID. ADB 필수입니다.

텍스트선택
--transport

USB 또는 Wi-Fi를 명시합니다. ADB 필수입니다.

선택값
usb | wifi
선택
--device-auth-ref

OS 자격 증명 저장소에 명시적으로 저장한 신원을 재사용합니다.

텍스트선택
--save-device-auth

승인된 신원을 이 로컬 참조로 명시적으로 저장합니다.

텍스트선택
--device-file-root

허가된 Android 디렉터리. 기본값은 /sdcard/Download/rdp-cli/<session-id>입니다.

경로선택
--android-display

휴대폰 기본 화면 또는 세션 전용 가상 화면

선택값
main | virtual
선택
--android-virtual-size

가상 화면 크기, 너비x높이

텍스트선택
--android-virtual-dpi

가상 화면 DPI

양의 정수선택
--android-start-app

새 가상 화면에서 시작할 설치된 앱

텍스트선택
--vnc-security

VNC 인증 방식. none은 명시적으로 선택

선택값
vnc-auth | none | x509-plain | ard
선택
--vnc-tls-pin

검증된 VNC X509Plain 리프 인증서의 SHA256 지문.

텍스트선택
--port

TCP 포트: RDP 3389, VNC 5900. android pair는 휴대전화의 페어링 포트, ADB connect는 별도의 연결 포트를 사용합니다.

양의 정수
기본값: RDP 3389 · VNC 5900
선택
--user

로컬 또는 도메인 계정. RDP에서 필수

텍스트선택
--domain

Windows 도메인

텍스트선택
--password

암호. 고전 VNC는 처음 8 UTF-8 바이트 사용

텍스트선택
--password-stdin

표준 입력에서 EOF까지 암호 읽기

플래그선택
--cert-policy

RDP 서버 인증서 정책. 웹 HTTPS와 별개

선택값
ignore | strict
기본값: ignore
선택
--tls-profile

modern은 TLS 1.2와 최신 암호화를 요구합니다. legacy는 현재 세션에서 이전 서명·암호(TLS 1.2의 SHA-1 포함) 및 TLS 1.0을 허용하지만 다운그레이드를 강제하지 않습니다

선택값
modern | legacy
기본값: modern
선택
--credential-ref

기존 플랫폼 자격 증명 저장소 참조

텍스트선택
--audio-mode

RDP 재생 위치: 뷰어(client), 제어 대상 컴퓨터(host) 또는 끔(off)

선택값
client | host | off
기본값: client
선택
--microphone-mode

RDP 마이크 입력: 승인된 뷰어(client), 제어 대상 컴퓨터의 일치하는 도우미(host) 또는 끔(off)

선택값
client | host | off
기본값: client
선택
--save-credential

접속에 성공한 암호를 이 참조로 저장

텍스트선택
--name

읽기 쉬운 세션 이름

텍스트선택
--size

데스크톱 크기 WIDTHxHEIGHT

텍스트선택
--layout

모니터 배치 JSON 또는 @file

텍스트선택
--connect-timeout-ms

연결 기한(밀리초)

양의 정수선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli connect --help

rdp-cli list#

접근 가능한 세션 목록

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli list --help

rdp-cli status#

세션 상태 조회

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli status --help

rdp-cli reconnect#

재연결 후 일시 정지 유지

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli reconnect --help

rdp-cli disconnect#

원격 세션을 닫습니다. RDP는 Windows 사용자를 로그오프하지 않습니다.

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli disconnect --help

뷰어와 데스크톱 상태

watch는 사람을 위한 읽기 전용 뷰어를 엽니다. --viewer는 window 또는 web입니다. Agent 명령에는 뷰어가 필요하지 않습니다. presence show/hide는 로컬 상태 표시, --floating은 떠 있는 제어, --panel은 macOS 또는 Linux 세션 패널용입니다. 관찰 뷰어를 닫아도 연결은 유지됩니다.

rdp-cli watch#

사람을 위한 뷰어 열기

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--viewer

뷰어 구현

선택값
window | web
기본값: window
선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli watch --help

rdp-cli presence show#

데스크톱 상태 표시

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--floating

선택적인 플로팅 세션 컨트롤도 표시

플래그선택
--panel

macOS 또는 Linux 세션 패널도 열기

플래그선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli presence show --help

rdp-cli presence hide#

연결 유지하며 상태 숨기기

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli presence hide --help

제어와 인계

pause는 --session 또는 --all을 지정하고 사람의 제어권도 회수합니다. resume는 Agent에 돌려줍니다. control take는 연결된 viewer ID가 필요하며 release는 뷰어 또는 대상 Agent를 지정할 수 있습니다. 사람의 일시 정지를 존중하고 반환 후 다시 캡처하세요.

rdp-cli pause#

입력 일시 정지 및 사람 제어권 회수

--session SESSION 또는 --all 중 하나만 지정합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli pause --help

rdp-cli resume#

세션을 Agent에 반환

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli resume --help

rdp-cli control take#

연결된 뷰어에 제어권 전달

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--viewer-id

연결된 뷰어 ID. 해당할 때는 제어 권한 소유자

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli control take --help

rdp-cli control release#

제어권을 Agent에 반환

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--viewer-id

연결된 뷰어 ID. 해당할 때는 제어 권한 소유자

텍스트선택
--agent-id

제어를 받을 Agent

텍스트선택
--to-agent

대상 Agent ID

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli control release --help

캡처·입력·클립보드

screenshot은 --out으로 PNG를 저장하고 --monitor로 화면을 고릅니다. 좌표 입력에는 observation과 화면 내 좌표 또는 --desktop이 필요하며 혼용하지 않습니다. drag는 시작/끝 좌표와 선택적 화면 ID를 사용합니다. type은 --text 또는 --text-stdin을 선택합니다. --sensitive는 안내만 바꾸며 화면을 가리지 않습니다. key는 --keys 또는 --key와 --state를 사용합니다. 클립보드 쓰기는 원격 텍스트를 교체합니다.

rdp-cli screenshot#

일관된 PNG 관찰 캡처

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--monitor

모니터 ID. screenshot은 all도 허용

텍스트
기본값: all
선택
--region

원격 픽셀 영역 x,y,width,height

텍스트선택
--max-width

최대 이미지 너비. 입력 좌표 유지

양의 정수선택
--since

이전 스크린샷 비교 참조

텍스트선택
--out

저장할 PNG 파일

경로선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli screenshot --help

rdp-cli move#

원격 포인터 이동

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--x

원격 x 좌표

정수필수
--y

원격 y 좌표

정수필수
--monitor

모니터 ID. screenshot은 all도 허용

텍스트선택
--desktop

모니터 내부 좌표 대신 데스크톱 좌표 사용

플래그선택
--observation

새 스크린샷의 관찰 토큰

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli move --help

rdp-cli click#

원격 좌표 클릭

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--x

원격 x 좌표

정수필수
--y

원격 y 좌표

정수필수
--button

마우스 버튼

선택값
left | right | middle
기본값: left
선택
--count

클릭 횟수

양의 정수선택
--monitor

모니터 ID. screenshot은 all도 허용

텍스트선택
--desktop

모니터 내부 좌표 대신 데스크톱 좌표 사용

플래그선택
--observation

새 스크린샷의 관찰 토큰

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli click --help

rdp-cli scroll#

좌표에서 스크롤

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--x

원격 x 좌표

정수필수
--y

원격 y 좌표

정수필수
--delta-x

부호 있는 가로 휠 단위

정수선택
--delta-y

부호 있는 세로 휠 단위

정수선택
--monitor

모니터 ID. screenshot은 all도 허용

텍스트선택
--desktop

모니터 내부 좌표 대신 데스크톱 좌표 사용

플래그선택
--observation

새 스크린샷의 관찰 토큰

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli scroll --help

rdp-cli drag#

좌표 사이 드래그

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--from-x

시작 x 좌표

정수필수
--from-y

시작 y 좌표

정수필수
--to-x

끝 x 좌표

정수필수
--to-y

끝 y 좌표

정수필수
--from-monitor

시작 모니터 ID

텍스트선택
--to-monitor

끝 모니터 ID

텍스트선택
--desktop

모니터 내부 좌표 대신 데스크톱 좌표 사용

플래그선택
--observation

새 스크린샷의 관찰 토큰

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli drag --help

rdp-cli type#

클립보드를 바꾸지 않고 입력합니다. Android는 출력 가능한 ASCII, 줄바꿈, 탭을 지원하며 Unicode 붙여넣기는 android text를 사용합니다.

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--text

Unicode 입력 또는 클립보드 텍스트

텍스트선택
--text-stdin

표준 입력에서 EOF까지 입력/클립보드 텍스트 읽기

플래그선택
--sensitive

관찰 이벤트에서 텍스트 숨김. 스크린샷에는 데스크톱이 계속 표시됨

플래그선택
--observation

새 스크린샷의 관찰 토큰

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli type --help

rdp-cli key#

키 조합 또는 상태 전송

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--keys

CTRL+S 같은 키 조합

텍스트선택
--key

키 이름. android key는 나열된 시스템 키를 사용합니다.

텍스트선택
--state

나열된 키 상태 또는 음소거 상태

선택값
down | up
선택
--observation

새 스크린샷의 관찰 토큰

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli key --help

rdp-cli clipboard get#

원격 텍스트 클립보드 읽기

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli clipboard get --help

rdp-cli clipboard set#

원격 텍스트 클립보드 쓰기

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--text

Unicode 입력 또는 클립보드 텍스트

텍스트선택
--text-stdin

표준 입력에서 EOF까지 입력/클립보드 텍스트 읽기

플래그선택
--observation

새 스크린샷의 관찰 토큰

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli clipboard set --help

파일

--path는 허용된 RDP 교환 드라이브, Android 디렉터리 또는 X11 SFTP 루트를 기준으로 합니다. --local은 로컬 파일이나 폴더입니다. 교체하려면 --overwrite가 필요합니다. 전송 상태와 완료 해시를 확인하고 결과가 불명확한 작업을 반복하지 마세요.

rdp-cli files list#

RDP 교환 드라이브 또는 허가된 Android 디렉터리의 파일을 나열합니다.

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--path

RDP 교환 드라이브 또는 허가된 Android 디렉터리 기준 상대 경로.

경로선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli files list --help

rdp-cli files upload#

세션 파일 루트로 업로드하고 완료된 전송을 확인합니다.

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--local

업로드할 로컬 파일/디렉터리 또는 다운로드 대상

경로필수
--path

RDP 교환 드라이브 또는 허가된 Android 디렉터리 기준 상대 경로.

경로필수
--overwrite

기존 대상 교체 허용

플래그선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli files upload --help

rdp-cli files download#

RDP 교환 드라이브 또는 안정적인 Android 파일 스냅샷에서 다운로드합니다.

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--path

RDP 교환 드라이브 또는 허가된 Android 디렉터리 기준 상대 경로.

경로필수
--local

업로드할 로컬 파일/디렉터리 또는 다운로드 대상

경로필수
--overwrite

기존 대상 교체 허용

플래그선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli files download --help

rdp-cli files status#

전송 상태 조회

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--transfer-id

전송 ID. files status에서 생략하면 세션 전송 목록

텍스트선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli files status --help

rdp-cli files cancel#

전송 취소

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--transfer-id

전송 ID. files status에서 생략하면 세션 전송 목록

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli files cancel --help

rdp-cli files cleanup#

교환 내용 삭제

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--path

RDP 교환 드라이브 또는 허가된 Android 디렉터리 기준 상대 경로.

경로필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli files cleanup --help

소리와 마이크

RDP의 --audio-mode client|host|off 및 --microphone-mode client|host|off는 새 연결의 재생 위치와 마이크 소스를 각각 선택하며 녹음을 시작하지 않습니다. host 방향은 대상 Windows의 해당 서비스가 필요하고 Linux에서는 사용할 수 없습니다. X11/VNC에는 제품 오디오 채널이 없습니다.

rdp-cli host-microphone install#

이 Windows PC에 제어 대상 컴퓨터 마이크 도우미를 설치하고 시작

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli host-microphone install --help

rdp-cli host-microphone status#

이 Windows PC에 제어 대상 컴퓨터 마이크 도우미가 설치되어 있는지 확인

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli host-microphone status --help

rdp-cli host-microphone uninstall#

이 Windows PC의 제어 대상 컴퓨터 마이크 도우미를 중지하고 제거

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli host-microphone uninstall --help

rdp-cli audio status#

오디오 기능과 소스 조회

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli audio status --help

rdp-cli audio mute#

뷰어 음소거 또는 해제

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--viewer-id

연결된 뷰어 ID. 해당할 때는 제어 권한 소유자

텍스트필수
--state

나열된 키 상태 또는 음소거 상태

선택값
on | off
필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli audio mute --help

rdp-cli audio volume#

뷰어 재생 음량 설정

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--viewer-id

연결된 뷰어 ID. 해당할 때는 제어 권한 소유자

텍스트필수
--percent

재생 게인 백분율

양의 정수필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli audio volume --help

rdp-cli audio microphone#

마이크 조회 또는 중지

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--action

마이크 상태 또는 정지. 시작하려면 사람이 뷰어에서 조작해야 함

선택값
status | stop
기본값: status
선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli audio microphone --help

rdp-cli audio android#

휴대전화 재생, 마이크 또는 끄기를 명시적으로 선택합니다.

Android를 지원하는 현재 버전이 필요합니다. Windows(x64 / x86 / ARM64), macOS(Apple silicon / Intel), Linux(x86_64 / ARM64) 중에서 선택하세요.

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--source

휴대전화 음원: off, output(시스템 공유 승인 필요), microphone(제어권과 새 --observation 필요).

선택값
off | output | microphone
필수
--observation

새 스크린샷의 관찰 토큰

텍스트선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli audio android --help

rdp-cli audio poll#

제한된 양의 최근 PCM 오디오 샘플을 읽습니다.

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--after

이 시퀀스 이후의 이벤트 또는 PCM 샘플을 반환합니다.

양의 정수선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli audio poll --help

디스플레이

monitors는 화면 구성을 반환합니다. monitors set은 JSON 또는 @file을 받으며 --allow-reconnect는 동적 변경이 불가능할 때 재연결을 허용합니다. 변경 후 구성을 읽고 다시 캡처하세요. VNC는 프레임버퍼를 보고하지만 요청에 의한 배치 변경은 거부합니다.

rdp-cli monitors#

협상된 화면 구성 조회

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli monitors --help

rdp-cli monitors set#

화면 배치 변경

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--layout

모니터 배치 JSON 또는 @file

텍스트필수
--allow-reconnect

동적 화면 배치가 불가능하면 재연결 허용

플래그선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli monitors set --help

웹 접근

web start는 수신 주소와 TLS 인증서/키 또는 신뢰할 프록시를 설정합니다. --ice-server는 반복할 수 있습니다. 루프백 외 접근에는 LAN/VPN, HTTPS, 권한이 필요합니다. access grant는 --permission과 초 단위 --expires-in을 지정합니다. 권한은 session.observe/control, clipboard.read/write, files.read/write, audio.listen/send입니다. 취소 시 해당 스트림도 종료됩니다.

rdp-cli web start#

인증된 웹 서비스 시작

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--listen

수신 주소

텍스트선택
--tls-cert

HTTPS 인증서 파일

경로선택
--tls-key

HTTPS 개인 키 파일

경로선택
--trust-proxy

설정된 프록시 신뢰

플래그선택
--ice-server

WebRTC용 STUN/TURN URL

텍스트선택 · 반복 가능
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli web start --help

rdp-cli web status#

웹 서비스 상태 조회

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli web status --help

rdp-cli web stop#

원격 세션 연결을 유지하면서 브라우저 접근을 중지합니다.

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli web stop --help

rdp-cli access grant#

범위가 제한된 웹 권한 생성

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--permission

접근 토큰에 부여할 권한

텍스트필수 · 반복 가능
--expires-in

권한 유효 기간(초)

양의 정수필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli access grant --help

rdp-cli access list#

웹 권한 목록

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli access list --help

rdp-cli access revoke#

권한과 스트림 취소

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--grant-id

권한 부여 식별자

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli access revoke --help

Android 휴대전화

기기 ID와 usb 또는 wifi 전송을 명시하세요. 검색만으로 기기가 승인되지는 않습니다. 페어링 포트와 연결 포트는 서로 다릅니다. 코드는 표준 입력으로 보내고 스트림을 종료합니다. 신원 저장은 명시적으로 요청해야 합니다. 입력과 앱 변경에는 제어권과 최신 관찰이 필요합니다. 결과가 불확실하면 작업을 조회하고 무작정 반복하지 마세요.

rdp-cli android devices#

승인하지 않고 USB 및 Wi-Fi 후보 기기를 검색합니다.

Android를 지원하는 현재 버전이 필요합니다. Windows(x64 / x86 / ARM64), macOS(Apple silicon / Intel), Linux(x86_64 / ARM64) 중에서 선택하세요.

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli android devices --help

rdp-cli android pair#

페어링 포트와 표준 입력 코드로 무선 페어링합니다.

Android를 지원하는 현재 버전이 필요합니다. Windows(x64 / x86 / ARM64), macOS(Apple silicon / Intel), Linux(x86_64 / ARM64) 중에서 선택하세요.

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--host

RDP/VNC 호스트 또는 명시적인 Android Wi-Fi 엔드포인트.

텍스트필수
--port

TCP 포트: RDP 3389, VNC 5900. android pair는 휴대전화의 페어링 포트, ADB connect는 별도의 연결 포트를 사용합니다.

양의 정수필수
--code-stdin

6자리 페어링 코드를 표준 입력에서 읽습니다.

플래그선택
--device-auth-ref

OS 자격 증명 저장소에 명시적으로 저장한 신원을 재사용합니다.

텍스트선택
--save-device-auth

승인된 신원을 이 로컬 참조로 명시적으로 저장합니다.

텍스트선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli android pair --help

rdp-cli android forget#

저장된 로컬 Android 신원을 삭제합니다. 휴대전화의 승인 취소는 별도입니다.

Android를 지원하는 현재 버전이 필요합니다. Windows(x64 / x86 / ARM64), macOS(Apple silicon / Intel), Linux(x86_64 / ARM64) 중에서 선택하세요.

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--device-auth-ref

OS 자격 증명 저장소에 명시적으로 저장한 신원을 재사용합니다.

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli android forget --help

rdp-cli android apps list#

설치된 Android 패키지를 나열합니다.

Android를 지원하는 현재 버전이 필요합니다. Windows(x64 / x86 / ARM64), macOS(Apple silicon / Intel), Linux(x86_64 / ARM64) 중에서 선택하세요.

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli android apps list --help

rdp-cli android apps info#

패키지의 실제 설치 경로를 조회합니다.

Android를 지원하는 현재 버전이 필요합니다. Windows(x64 / x86 / ARM64), macOS(Apple silicon / Intel), Linux(x86_64 / ARM64) 중에서 선택하세요.

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--package

Android 패키지 이름.

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli android apps info --help

rdp-cli android apps install#

허가된 기기 디렉터리의 단일 APK를 제출하고 작업을 추적합니다.

Android를 지원하는 현재 버전이 필요합니다. Windows(x64 / x86 / ARM64), macOS(Apple silicon / Intel), Linux(x86_64 / ARM64) 중에서 선택하세요.

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--path

RDP 교환 드라이브 또는 허가된 Android 디렉터리 기준 상대 경로.

경로필수
--replace

설치된 앱을 명시적으로 교체합니다.

플래그선택
--observation

새 스크린샷의 관찰 토큰

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli android apps install --help

rdp-cli android apps launch#

지정 앱을 실행하고 화면을 확인합니다.

Android를 지원하는 현재 버전이 필요합니다. Windows(x64 / x86 / ARM64), macOS(Apple silicon / Intel), Linux(x86_64 / ARM64) 중에서 선택하세요.

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--package

Android 패키지 이름.

텍스트필수
--activity

Activity 클래스. 생략하면 실행 진입점을 찾습니다.

텍스트선택
--observation

새 스크린샷의 관찰 토큰

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli android apps launch --help

rdp-cli android apps stop#

명시한 Android 패키지를 강제 종료합니다.

Android를 지원하는 현재 버전이 필요합니다. Windows(x64 / x86 / ARM64), macOS(Apple silicon / Intel), Linux(x86_64 / ARM64) 중에서 선택하세요.

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--package

Android 패키지 이름.

텍스트필수
--observation

새 스크린샷의 관찰 토큰

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli android apps stop --help

rdp-cli android apps status#

동작을 반복하지 않고 앱 작업을 조회합니다.

Android를 지원하는 현재 버전이 필요합니다. Windows(x64 / x86 / ARM64), macOS(Apple silicon / Intel), Linux(x86_64 / ARM64) 중에서 선택하세요.

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--job

설치·실행·종료가 반환한 작업 ID.

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli android apps status --help

rdp-cli android touch#

최신 스크린샷으로 시간 지정 터치 제스처 전체를 보냅니다.

Android를 지원하는 현재 버전이 필요합니다. Windows(x64 / x86 / ARM64), macOS(Apple silicon / Intel), Linux(x86_64 / ARM64) 중에서 선택하세요.

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--kind

터치 제스처 유형.

선택값
tap | double-tap | long-press | swipe | drag | pinch | gesture
필수
--x

원격 x 좌표

정수선택
--y

원격 y 좌표

정수선택
--to-x

끝 x 좌표

정수선택
--to-y

끝 y 좌표

정수선택
--second-x

두 번째 손가락 시작 X 좌표.

정수선택
--second-y

두 번째 손가락 시작 Y 좌표.

정수선택
--second-to-x

두 번째 손가락 종료 X 좌표.

정수선택
--second-to-y

두 번째 손가락 종료 Y 좌표.

정수선택
--duration-ms

제스처 시간 1–10000ms. 드래그에는 400ms 누르기가 추가됩니다.

양의 정수선택
--events-stdin

표준 입력에서 JSON 배열 [{at_ms,contact,phase,x,y}, …]을 읽습니다. --kind gesture 전용입니다.

플래그선택
--observation

새 스크린샷의 관찰 토큰

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli android touch --help

rdp-cli android key#

제어권과 최신 관찰로 Android 시스템 키를 누릅니다.

Android를 지원하는 현재 버전이 필요합니다. Windows(x64 / x86 / ARM64), macOS(Apple silicon / Intel), Linux(x86_64 / ARM64) 중에서 선택하세요.

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--key

키 이름. android key는 나열된 시스템 키를 사용합니다.

선택값
back | home | recent | enter | backspace
필수
--observation

새 스크린샷의 관찰 토큰

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli android key --help

rdp-cli android text#

휴대전화 클립보드를 통해 Unicode를 명시적으로 붙여넣습니다.

Android를 지원하는 현재 버전이 필요합니다. Windows(x64 / x86 / ARM64), macOS(Apple silicon / Intel), Linux(x86_64 / ARM64) 중에서 선택하세요.

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--method

명시적 텍스트 방식: clipboard 붙여넣기.

선택값
clipboard
필수
--text

Unicode 입력 또는 클립보드 텍스트

텍스트선택
--text-stdin

표준 입력에서 EOF까지 입력/클립보드 텍스트 읽기

플래그선택
--observation

새 스크린샷의 관찰 토큰

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli android text --help

Linux 데스크톱과 앱

--protocol x11 및 desktop 또는 application 모드를 명시하고 SSH 대상을 검증하세요. SSH 클라이언트와 앱 표시 기능은 내장되어 있습니다. 기존 Wayland 데스크톱은 설정된 RDP/VNC 연결 대상을 사용합니다. X11에는 오디오 및 마이크 채널이 없습니다. SFTP는 허용된 디렉터리로 제한되며 원격 서비스를 설치하지 않습니다.

rdp-cli linux targets#

서비스를 시작하지 않고 기존 Linux 디스플레이와 호환 연결 대상을 찾습니다.

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--host

RDP/VNC 호스트 또는 명시적인 Android Wi-Fi 엔드포인트.

텍스트필수
--user

로컬 또는 도메인 계정. RDP에서 필수

텍스트필수
--port

TCP 포트: RDP 3389, VNC 5900. android pair는 휴대전화의 페어링 포트, ADB connect는 별도의 연결 포트를 사용합니다.

양의 정수
기본값: 22
선택
--ssh-known-hosts

로컬 OpenSSH known_hosts 파일. 외부 SSH 실행 파일은 필요 없습니다.

경로선택
--ssh-host-key

별도로 검증한 SSH SHA256 지문.

텍스트선택
--ssh-key

로컬 SSH 개인 키. 암호 입력으로 키 암호를 제공합니다.

경로선택
--password

암호. 고전 VNC는 처음 8 UTF-8 바이트 사용

텍스트선택
--password-stdin

표준 입력에서 EOF까지 암호 읽기

플래그선택
--credential-ref

기존 플랫폼 자격 증명 저장소 참조

텍스트선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli linux targets --help

rdp-cli linux text#

텍스트를 입력하거나 명시적으로 원격 클립보드에서 붙여넣습니다.

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--method

명시적 텍스트 방식: clipboard 붙여넣기.

선택값
clipboard
필수
--keys

CTRL+S 같은 키 조합

선택값
CTRL+V | CTRL+SHIFT+V | SHIFT+INSERT
기본값: CTRL+V
선택
--text

Unicode 입력 또는 클립보드 텍스트

텍스트선택
--text-stdin

표준 입력에서 EOF까지 입력/클립보드 텍스트 읽기

플래그선택
--observation

새 스크린샷의 관찰 토큰

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli linux text --help

rdp-cli linux apps list#

이 세션에서 전달한 X11 앱 인스턴스를 나열합니다.

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli linux apps list --help

rdp-cli linux apps stop#

명시적으로 선택한 앱 인스턴스를 중지합니다.

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--instance

linux apps list가 반환한 정확한 인스턴스 ID.

텍스트필수
--observation

새 스크린샷의 관찰 토큰

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli linux apps stop --help

작업과 이벤트

operations status는 operation ID 또는 원래 request ID로 조회하며 입력을 다시 보내지 않습니다. events는 이벤트를 읽고 --follow는 계속 구독, --after는 커서부터 재개합니다. sent 이후에도 원격 앱의 결과를 확인하세요.

rdp-cli operations status#

보관된 작업 결과 조회

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--operation-id

작업 식별자

텍스트선택
--request-id

요청 연계/멱등성 ID. operations status에서는 원래 요청 조회

텍스트선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli operations status --help

rdp-cli events#

이벤트 읽기 또는 구독

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--follow

새 이벤트를 계속 읽기

플래그선택
--after

이 시퀀스 이후의 이벤트 또는 PCM 샘플을 반환합니다.

텍스트선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli events --help

신뢰·자격 증명·설치

trust는 strict 모드에서 정확한 RDP 대상과 지문을 연결합니다. credentials remove는 지정한 제품 자격 증명만 삭제합니다. macOS와 Linux의 install-cli/uninstall-cli는 CLI 진입점을 관리하며 --prefix로 위치를 고릅니다. Windows는 내려받은 실행 파일을 사용합니다. presence show --panel은 macOS와 Linux에서 세션 패널을 엽니다. licenses는 타사 버전과 라이선스를 표시합니다.

rdp-cli trust list#

RDP 인증서 신뢰 기록 목록

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli trust list --help

rdp-cli trust add#

특정 대상 지문 신뢰

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--target

RDP 신뢰 대상

텍스트필수
--fingerprint

인증서 지문

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli trust add --help

rdp-cli trust remove#

신뢰 기록 삭제

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--target

RDP 신뢰 대상

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli trust remove --help

rdp-cli credentials remove#

제품 자격 증명 삭제

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--reference

제거할 자격 증명 저장소 참조

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli credentials remove --help

rdp-cli install-cli#

macOS 또는 Linux CLI 진입점 설치

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--prefix

사용자가 제어하는 설치 경로 접두사

경로선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli install-cli --help

rdp-cli uninstall-cli#

생성된 CLI 진입점 제거

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli uninstall-cli --help

rdp-cli licenses#

타사 버전과 라이선스 표시

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli licenses --help

Agent 작업과 자동화

영역 캡처와 이미지 비교, 조건 대기, 배치 작업, 영구 작업 보고서, 여러 Agent 협업, MCP·연결 프로필·진단, Android 가상 화면을 추가했습니다.

rdp-cli tasks create#

영구 작업 만들기

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--title

작업 제목

텍스트필수
--session

명시적인 세션 ID

텍스트선택
--record-frames

스크린샷의 주요 프레임 명시적 저장

플래그선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli tasks create --help

rdp-cli tasks list#

접근 가능한 작업 나열

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli tasks list --help

rdp-cli tasks status#

작업 진행 상황과 기록 확인

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--task

영구 작업 ID

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli tasks status --help

rdp-cli tasks attach#

승인된 세션을 작업에 연결

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--task

영구 작업 ID

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli tasks attach --help

rdp-cli tasks checkpoint#

입력을 재실행하지 않고 체크포인트 저장

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--task

영구 작업 ID

텍스트필수
--note

비밀 값 없는 진행 메모

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli tasks checkpoint --help

rdp-cli tasks new-run#

체크포인트에서 새 실행 시작

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--task

영구 작업 ID

텍스트필수
--from-checkpoint

기존 체크포인트 ID

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli tasks new-run --help

rdp-cli tasks grants list#

작업 권한 나열

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--task

영구 작업 ID

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli tasks grants list --help

rdp-cli tasks grants grant#

작업 권한 부여

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--task

영구 작업 ID

텍스트필수
--to-agent

대상 Agent ID

텍스트필수
--permission

접근 토큰에 부여할 권한

텍스트필수 · 반복 가능
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli tasks grants grant --help

rdp-cli tasks grants revoke#

이후 작업 접근 권한 취소

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--task

영구 작업 ID

텍스트필수
--to-agent

대상 Agent ID

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli tasks grants revoke --help

rdp-cli tasks evidence#

선택한 로컬 증거 저장

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--task

영구 작업 ID

텍스트필수
--file

로컬 증거 파일, 최대 4 MiB

경로필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli tasks evidence --help

rdp-cli tasks export#

오프라인 JSON 또는 HTML 보고서 내보내기

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--task

영구 작업 ID

텍스트필수
--out

저장할 PNG 파일

경로필수
--format

출력 형식. 이 명령의 허용 값 참조

선택값
json | html
기본값: json
선택
--include-evidence

명시적으로 저장한 증거 포함

플래그선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli tasks export --help

rdp-cli tasks purge#

선택한 로컬 작업 기록 삭제

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--task

영구 작업 ID

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli tasks purge --help

rdp-cli agents register#

Agent ID 등록

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--name

읽기 쉬운 세션 이름

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli agents register --help

rdp-cli agents list#

비밀 값 없이 Agent 목록 표시

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli agents list --help

rdp-cli agents show#

Agent ID와 권한 확인

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--id

대상 ID

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli agents show --help

rdp-cli agents revoke#

Agent ID와 제어권 취소

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--id

대상 ID

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli agents revoke --help

rdp-cli agents grant#

Agent에 세션 접근 허용

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--id

대상 ID

텍스트필수
--permission

접근 토큰에 부여할 권한

텍스트필수 · 반복 가능
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli agents grant --help

rdp-cli agents revoke-access#

Agent의 세션 접근 권한 취소

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--id

대상 ID

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli agents revoke-access --help

rdp-cli control claim#

지정 Agent가 일시 중지된 세션 제어권 획득

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--lease-seconds

제어권 유효 기간, 초

양의 정수
기본값: 60
선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli control claim --help

rdp-cli control renew#

유효한 제어권 갱신

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--lease-seconds

제어권 유효 기간, 초

양의 정수
기본값: 60
선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli control renew --help

rdp-cli control unclaim#

제어권을 해제하고 세션 일시 중지

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli control unclaim --help

rdp-cli control claim-status#

현재 제어권 확인

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli control claim-status --help

rdp-cli control handoff#

승인된 Agent에 제어권 전달

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--to-agent

대상 Agent ID

텍스트필수
--lease-seconds

제어권 유효 기간, 초

양의 정수
기본값: 60
선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli control handoff --help

rdp-cli profiles list#

저장된 연결 프로필 나열

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli profiles list --help

rdp-cli profiles show#

프로필과 매개변수 출처 확인

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--name

읽기 쉬운 세션 이름

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli profiles show --help

rdp-cli profiles save#

자격 증명 참조로 프로필 저장

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--json

이 명령의 버전 지정 JSON 입력

텍스트필수
--replace

설치된 앱을 명시적으로 교체합니다.

플래그선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli profiles save --help

rdp-cli profiles remove#

자격 증명은 유지하고 프로필 삭제

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--name

읽기 쉬운 세션 이름

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli profiles remove --help

rdp-cli profiles export#

비밀 값 없이 프로필 내보내기

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--name

읽기 쉬운 세션 이름

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli profiles export --help

rdp-cli profiles import#

연결하지 않고 프로필 가져오기

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--json

이 명령의 버전 지정 JSON 입력

텍스트필수
--replace

설치된 앱을 명시적으로 교체합니다.

플래그선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli profiles import --help

rdp-cli doctor#

기능 진단. 연결 검사는 명시적으로 선택

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--session

명시적인 세션 ID

텍스트선택
--profile

저장된 연결 프로필

텍스트선택
--probe

프로필로 임시 연결 명시적 생성

플래그선택
--redact

대상 이름, 주소 및 세션 ID 생략

플래그선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli doctor --help

rdp-cli doctor status#

진단 결과 확인

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--diagnostic-id

원래 진단 요청 ID

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli doctor status --help

rdp-cli doctor cancel#

후속 진단 취소

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--diagnostic-id

원래 진단 요청 ID

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli doctor cancel --help

rdp-cli wait#

화면 또는 상태 조건 대기

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--condition

대기 조건

선택값
changed | stable | connection | transfer | operation
필수
--region

원격 픽셀 영역 x,y,width,height

텍스트선택
--state

나열된 키 상태 또는 음소거 상태

텍스트선택
--transfer-id

전송 ID. files status에서 생략하면 세션 전송 목록

텍스트선택
--operation-id

작업 식별자

텍스트선택
--sample-ms

샘플 간격, 밀리초

양의 정수
기본값: 100
선택
--stable-ms

필요한 연속 안정 시간, 밀리초

양의 정수
기본값: 1000
선택
--threshold-permille

변경 픽셀 비율, 천분율

정수
기본값: 10
선택
--pixel-delta

무시할 RGB 채널 차이

정수
기본값: 8
선택
--max-frame-age-ms

허용할 최대 프레임 경과 시간, 밀리초

양의 정수
기본값: 5000
선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli wait --help

rdp-cli wait status#

대기 결과 확인

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--wait-id

원래 대기 요청 ID

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli wait status --help

rdp-cli wait cancel#

대상 작업은 유지하고 대기 취소

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--wait-id

원래 대기 요청 ID

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli wait cancel --help

rdp-cli batch#

사전 검사 후 최대 64단계 순차 실행

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--json

이 명령의 버전 지정 JSON 입력

텍스트선택
--steps-stdin

표준 입력에서 배치 JSON 읽기

플래그선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli batch --help

rdp-cli batch status#

재실행 없이 배치 결과 확인

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--batch-id

원래 배치 요청 ID

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli batch status --help

rdp-cli batch cancel#

대기 중인 배치 단계 취소

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--batch-id

원래 배치 요청 ID

텍스트필수
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli batch cancel --help

rdp-cli operations cancel#

남은 입력 취소. 보낸 입력은 되돌리지 않음

--session SESSION이 필요합니다.

명령 옵션
옵션형식과 값요구 사항
--operation-id

작업 식별자

텍스트선택
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli operations cancel --help

rdp-cli mcp stdio#

표준 입력과 출력으로 MCP 제공

세션은 필수가 아닙니다. 선택할 수 있는 명령은 아래 표에 표시합니다.

명령 옵션
옵션형식과 값요구 사항
--agent-id

제어를 받을 Agent

텍스트선택
--agent-ref

호출 Agent의 자격 증명 참조

텍스트선택
--claim-ref

현재 제어권 참조

텍스트선택
--task

영구 작업 ID

텍스트선택
--run

작업 실행 ID

텍스트선택

rdp-cli mcp stdio --help

프로토콜과 플랫폼 조건

  • RDP 기본값은 --cert-policy ignore와 --tls-profile modern입니다. TLS 1.2 서버에도 이전 서명이나 암호가 필요할 수 있습니다. 알려진 구형 대상에서는 자격 증명과 인증서 정책을 유지하고 새 요청 ID로 --tls-profile legacy를 명시하여 한 번 재시도하세요. reconnect는 선택한 설정을 유지하며 자동 다운그레이드는 없습니다. strict는 인증서 신뢰와 이름을 검증합니다. Web HTTPS에는 영향이 없습니다.
  • VNC 보안은 선택한 모드에 따라 달라집니다. 기존 VNC는 암호화되지 않으므로 신뢰할 수 있는 네트워크나 VPN을 사용하세요. VeNCrypt X509Plain은 TLS와 인증서 검증을 사용합니다. 암호화 VNC: --vnc-security x509-plain에는 --user, 암호 입력과 별도로 확인한 --vnc-tls-pin이 필요합니다. 기존 VNC는 --user를 받지 않습니다. RDP의 --domain, --size, --layout은 적용되지 않습니다.
  • VNC는 파일, 소리, 마이크, 능동적 화면 배치 변경을 제공하지 않습니다. UTF-8 클립보드는 협상이 필요하며 그렇지 않으면 Latin-1만 허용합니다.
  • RDP 파일에는 드라이브 리디렉션이 필요합니다. 오디오, 클립보드, 마이크, 다중 화면도 서버 정책에 따라 달라집니다.
  • Windows/macOS는 기본 뷰어와 상태 표시를 제공합니다. Linux는 화면/오디오 서비스, 자격 증명 저장에는 Secret Service가 필요합니다. 데스크톱 없는 호스트에서도 지원 CLI 작업은 가능합니다.
  • Unicode 입력은 호환성을 위해 간격을 두고 전송합니다. 긴 텍스트는 제한 시간을 조정하고 결과를 확인하세요. 뷰어를 열어도 모든 서버의 모든 문자를 보장하지 않습니다.
  • Android 12 이상이 필요하며 실기기 검증은 Pixel 3 / Android 12에서 수행했습니다. 붙여넣기는 휴대전화 클립보드를 명시적으로 변경합니다. 재생 소리에는 시스템 공유 동의가 필요하며 앱의 캡처 제한을 준수합니다. 마이크는 별도 소스입니다. 연결이나 재연결로 녹음이 자동 시작되지 않습니다.
  • macOS 화면 공유에는 --user로 Mac 계정 이름을 지정하고 계정 암호를 제공합니다. ARD 인증이 자동으로 선택되며 --vnc-security ard로 직접 지정할 수도 있습니다. 별도로 설정한 VNC 암호는 --user 없이 --vnc-security vnc-auth로 사용합니다. ARD는 화면 데이터를 암호화하지 않으므로 신뢰할 수 있는 네트워크나 VPN에서 사용하세요.

오류 복구

OBSERVATION_REQUIRED / INVALID_COORDINATES
다시 캡처하고 화면 구성과 좌표를 확인하세요.
SESSION_PAUSED / CONTROL_HELD_BY_HUMAN
입력을 멈추고 사람이 Agent에 명시적으로 돌려줄 때까지 기다리세요.
AUTH_FAILED / VNC_AUTH_FAILED
계정, 암호 전달 방식과 서버 인증 정책을 확인하세요.
RDP_TLS_HANDSHAKE_FAILED / CERTIFICATE_UNTRUSTED
RDP_TLS_HANDSHAKE_FAILED: 선택한 설정과 서버 암호화를 확인하세요. 이 오류만으로 이전 TLS 버전이나 잘못된 암호라고 판단할 수 없습니다. 알려진 구형 대상이면 --tls-profile legacy와 새 요청 ID로 connect를 한 번 재시도하세요. CERTIFICATE_UNTRUSTED: 인증서 신뢰, 이름, 실제 지문을 검증하세요. TLS 설정 변경은 인증서 신뢰 문제를 해결하지 않습니다.
CAPABILITY_UNAVAILABLE / CLIPBOARD_ENCODING_UNSUPPORTED
협상 기능 또는 인코딩을 확인하고 지원 작업을 선택하세요.
REQUEST_TIMEOUT / REQUEST_ID_CONFLICT / REQUEST_WINDOW_EXPIRED
재시도 전에 작업과 화면을 조회하세요. 다른 인수나 보관 만료 후 같은 ID의 중복 방지를 기대하지 마세요.