rdp-cli · 0.3.1

Справочник команд rdp-cli

109 команд для удалённых рабочих столов, приложений Linux и Android: подключение, просмотр, управление, обмен файлами и передача контроля.

Найти команды по задаче

Впервые используете rdp-cli? Начните с установки и первого подключения. →

connect
Подключает постоянный сеанс RDP, VNC или Android ADB.
screenshot
Сделать согласованный PNG-снимок
click
Щёлкнуть по координате
type
Вводит без изменения буфера обмена; Android поддерживает печатный ASCII, LF и TAB. Для вставки Unicode используйте android text.
files upload
Загружает в файловый корень сеанса с проверкой завершения передачи.
files download
Скачивает с обменного диска RDP или стабильного снимка файла Android.
watch
Открыть просмотр для человека
list
Перечислить доступные сеансы

Каталог проверен для сборки 2026110701 на Windows, macOS и Linux. Проверьте установленный файл командами --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 и общие параметры

Обычная команда выводит один JSON-объект UTF-8 в stdout: ok: true с data либо ok: false с error. stderr содержит диагностику. Коды завершения: 0 — успех, 1 — ошибка выполнения, 2 — неверные аргументы.

Справка — обычный текст. events --follow передаёт поток NDJSON; обычный events возвращает один JSON-результат с data.events и data.ndjson. В PowerShell 5.1 задайте UTF-8 для [Console]::OutputEncoding и $OutputEncoding при работе с не-ASCII текстом.

data.session
Сохраните идентификатор, полученный от connect.
data.observation
Используйте токен снимка; обновляйте после переподключения, смены управления или экранов.
data.capabilities
Проверяйте согласованные возможности перед файловыми, звуковыми и экранными операциями или буфером обмена.
data.state / data.remote_outcome
queued, sent, partial, unknown, cancelled и failed описывают ход ввода. remote_outcome: not_confirmed требует проверки результата.
data.transfer_id
Передайте 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 нужен --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

Явный ID из android devices; обязателен для ADB.

ТекстНеобязательный
--transport

Явный транспорт USB или Wi-Fi; обязателен для ADB.

Выбор
usb | wifi
Необязательный
--device-auth-ref

Использует идентификационные данные, явно сохранённые в системном хранилище.

ТекстНеобязательный
--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

Проверенный отпечаток SHA256 конечного сертификата VNC X509Plain.

ТекстНеобязательный
--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, независимая от Web HTTPS

Выбор
ignore | strict
По умолчанию: ignore
Необязательный
--tls-profile

modern требует TLS 1.2 и современную криптографию; legacy разрешает старые подписи/шифры, включая SHA-1 с TLS 1.2, и 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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli connect --help

rdp-cli list#

Перечислить доступные сеансы

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli list --help

rdp-cli status#

Получить состояние сеанса

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli status --help

rdp-cli reconnect#

Переподключиться с сохранением паузы

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli reconnect --help

rdp-cli disconnect#

Закрыть удалённое подключение; RDP не завершает сеанс пользователя Windows.

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli watch --help

rdp-cli presence show#

Показать индикатор рабочего стола

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--floating

Показать также необязательные плавающие элементы управления

ФлагНеобязательный
--panel

Также открыть панель сеансов на macOS или Linux

ФлагНеобязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli presence show --help

rdp-cli presence hide#

Скрыть индикатор без отключения

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli presence hide --help

Управление и передача

pause принимает --session или --all и отбирает управление у человека. resume возвращает сеанс Agent. control take требует ID подключённого просмотра; release может указать его или целевой Agent. Уважайте ручную паузу и делайте новый снимок после возврата.

rdp-cli pause#

Приостановить ввод и отозвать управление

Укажите ровно одно: --session SESSION или --all.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli pause --help

rdp-cli resume#

Вернуть сеанс Agent

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli resume --help

rdp-cli control take#

Передать управление подключённому просмотру

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--viewer-id

ID подключённого средства просмотра; при необходимости владельца управления

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli control release --help

Снимки, ввод и буфер обмена

screenshot сохраняет PNG через --out; --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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli drag --help

rdp-cli type#

Вводит без изменения буфера обмена; Android поддерживает печатный ASCII, LF и TAB. Для вставки Unicode используйте android text.

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--text

Unicode-текст для ввода или буфера обмена

ТекстНеобязательный
--text-stdin

Читать текст для ввода или буфера обмена до EOF

ФлагНеобязательный
--sensitive

Скрыть текст в наблюдаемых событиях; снимки всё ещё показывают рабочий стол

ФлагНеобязательный
--observation

Токен свежего снимка экрана

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli key --help

rdp-cli clipboard get#

Прочитать удалённый буфер обмена

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli clipboard set --help

Файлы

--path задаётся относительно разрешённого диска RDP, каталога Android или корня SFTP X11. --local означает локальный файл или папку. Замена требует --overwrite. Проверяйте состояние и конечные хеши; не повторяйте операции с неизвестным результатом.

rdp-cli files list#

Выводит файлы обменного диска RDP или разрешённого каталога Android.

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--path

Путь относительно обменного диска RDP или разрешённого каталога Android.

ПутьНеобязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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 помощник микрофона управляемого компьютера

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli host-microphone install --help

rdp-cli host-microphone status#

Проверить, установлен ли на этом ПК Windows помощник микрофона управляемого компьютера

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli host-microphone status --help

rdp-cli host-microphone uninstall#

Остановить и удалить с этого ПК Windows помощник микрофона управляемого компьютера

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli host-microphone uninstall --help

rdp-cli audio status#

Проверить звуковые возможности

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli audio poll --help

Экраны

monitors возвращает топологию. monitors set принимает JSON или @file; --allow-reconnect разрешает переподключение, если динамическая смена недоступна. Проверьте топологию и снимок заново. VNC сообщает размер framebuffer, но отклоняет запросы смены компоновки.

rdp-cli monitors#

Получить согласованную топологию

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli monitors set --help

Веб-доступ

web start задаёт адрес, сертификат/ключ TLS или доверенный прокси; --ice-server повторяемый. Вне loopback нужны 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

URL STUN/TURN для WebRTC

ТекстНеобязательный · Повторяемый
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli web start --help

rdp-cli web status#

Получить состояние веб-сервиса

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli web status --help

rdp-cli web stop#

Остановить доступ из браузера, сохранив удалённые подключения.

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli access grant --help

rdp-cli access list#

Перечислить разрешения

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli access list --help

rdp-cli access revoke#

Отозвать разрешение и потоки

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--grant-id

Идентификатор разрешения

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli access revoke --help

Телефоны Android

Явно укажите ID устройства и транспорт usb или wifi. Обнаружение не даёт разрешения на доступ. Порт сопряжения отличается от порта подключения. Передайте код через stdin и закройте поток. Сохраняйте идентификационные данные только явно. Ввод и изменение приложений требуют управления и свежего наблюдения; при неизвестном результате сначала запросите состояние задания.

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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli android devices --help

rdp-cli android pair#

Выполняет беспроводное сопряжение через порт сопряжения и код из stdin.

Нужна текущая версия с поддержкой 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

Читает шестизначный код сопряжения из stdin.

ФлагНеобязательный
--device-auth-ref

Использует идентификационные данные, явно сохранённые в системном хранилище.

ТекстНеобязательный
--save-device-auth

Явно сохраняет разрешённые данные под этой локальной ссылкой.

ТекстНеобязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Использует идентификационные данные, явно сохранённые в системном хранилище.

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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–10000 мс; перетаскивание добавляет удержание 400 мс.

Положительное целоеНеобязательный
--events-stdin

Чтение JSON-массива [{at_ms,contact,phase,x,y}, …] из stdin; только для --kind gesture.

ФлагНеобязательный
--observation

Токен свежего снимка экрана

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli linux text --help

rdp-cli linux apps list#

Показывает экземпляры X11-приложений, перенаправленные в этой сессии.

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli linux apps list --help

rdp-cli linux apps stop#

Останавливает явно выбранный экземпляр приложения.

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--instance

Точный ID экземпляра из linux apps list.

ТекстОбязательный
--observation

Токен свежего снимка экрана

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli operations status --help

rdp-cli events#

Читать события или следить за ними

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--follow

Продолжать получать новые события

ФлагНеобязательный
--after

Возвращает события или отсчёты PCM после этого номера.

ТекстНеобязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli events --help

Доверие, учётные данные и установка

trust связывает точную 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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli trust list --help

rdp-cli trust add#

Доверять определённому отпечатку

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--target

Цель доверия RDP

ТекстОбязательный
--fingerprint

Отпечаток сертификата

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli trust add --help

rdp-cli trust remove#

Удалить запись доверия

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--target

Цель доверия RDP

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli trust remove --help

rdp-cli credentials remove#

Удалить учётные данные продукта

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--reference

Удаляемая ссылка на учётные данные

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli credentials remove --help

rdp-cli install-cli#

Установить CLI-вход на macOS или Linux

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--prefix

Префикс установки под контролем пользователя

ПутьНеобязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli install-cli --help

rdp-cli uninstall-cli#

Удалить созданный CLI-вход

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli uninstall-cli --help

rdp-cli licenses#

Показать сторонние версии и лицензии

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli licenses --help

Задачи и автоматизация агентов

Добавлены снимки областей и сравнение изображений, ожидание условий, пакеты действий, постоянные отчёты задач, совместная работа агентов, MCP с профилями и диагностикой, виртуальные экраны Android.

rdp-cli tasks create#

Создать постоянную задачу

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--title

Название задачи

ТекстОбязательный
--session

Явный ID сеанса

ТекстНеобязательный
--record-frames

Явно сохранять ключевые кадры

ФлагНеобязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli tasks create --help

rdp-cli tasks list#

Показать доступные задачи

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli tasks list --help

rdp-cli tasks status#

Прочитать ход работы и историю

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--task

ID постоянной задачи

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli tasks status --help

rdp-cli tasks attach#

Связать разрешённый сеанс с задачей

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--task

ID постоянной задачи

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli tasks attach --help

rdp-cli tasks checkpoint#

Сохранить контрольную точку без повтора ввода

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--task

ID постоянной задачи

ТекстОбязательный
--note

Заметка о ходе работы без секретов

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli tasks new-run --help

rdp-cli tasks grants list#

Показать права на задачу

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--task

ID постоянной задачи

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli tasks grants list --help

rdp-cli tasks grants grant#

Предоставить права на задачу

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--task

ID постоянной задачи

ТекстОбязательный
--to-agent

Идентификатор целевого агента

ТекстОбязательный
--permission

Разрешение для токена доступа

ТекстОбязательный · Повторяемый
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli tasks grants grant --help

rdp-cli tasks grants revoke#

Отозвать дальнейший доступ к задаче

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--task

ID постоянной задачи

ТекстОбязательный
--to-agent

Идентификатор целевого агента

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli tasks grants revoke --help

rdp-cli tasks evidence#

Сохранить выбранные локальные материалы

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--task

ID постоянной задачи

ТекстОбязательный
--file

Локальный файл доказательства, до 4 MiB

ПутьОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli tasks export --help

rdp-cli tasks purge#

Удалить выбранную локальную историю

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--task

ID постоянной задачи

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli tasks purge --help

rdp-cli agents register#

Зарегистрировать агента

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--name

Понятное имя сеанса

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli agents register --help

rdp-cli agents list#

Показать агентов без секретных данных

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli agents list --help

rdp-cli agents show#

Прочитать сведения и права агента

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--id

Целевой идентификатор

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli agents show --help

rdp-cli agents revoke#

Отозвать регистрацию агента и его управление

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--id

Целевой идентификатор

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli agents revoke --help

rdp-cli agents grant#

Разрешить агенту доступ к сеансу

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--id

Целевой идентификатор

ТекстОбязательный
--permission

Разрешение для токена доступа

ТекстОбязательный · Повторяемый
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli agents grant --help

rdp-cli agents revoke-access#

Отозвать доступ агента к сеансу

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--id

Целевой идентификатор

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli agents revoke-access --help

rdp-cli control claim#

Получить управление приостановленным сеансом от имени агента

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--lease-seconds

Срок управления в секундах

Положительное целое
По умолчанию: 60
Необязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli control renew --help

rdp-cli control unclaim#

Освободить управление и приостановить сеанс

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli control unclaim --help

rdp-cli control claim-status#

Проверить текущее право управления

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli control claim-status --help

rdp-cli control handoff#

Передать управление разрешённому агенту

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--to-agent

Идентификатор целевого агента

ТекстОбязательный
--lease-seconds

Срок управления в секундах

Положительное целое
По умолчанию: 60
Необязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli control handoff --help

rdp-cli profiles list#

Показать профили подключения

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli profiles list --help

rdp-cli profiles show#

Прочитать профиль и источники параметров

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--name

Понятное имя сеанса

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli profiles show --help

rdp-cli profiles save#

Сохранить профиль со ссылками на учётные данные

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--json

Версионированный JSON для этой команды

ТекстОбязательный
--replace

Явно заменяет установленное приложение.

ФлагНеобязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli profiles save --help

rdp-cli profiles remove#

Удалить профиль, сохранив учётные данные

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--name

Понятное имя сеанса

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli profiles remove --help

rdp-cli profiles export#

Экспортировать профиль без секретов

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--name

Понятное имя сеанса

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli profiles export --help

rdp-cli profiles import#

Импортировать профиль без подключения

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--json

Версионированный JSON для этой команды

ТекстОбязательный
--replace

Явно заменяет установленное приложение.

ФлагНеобязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli doctor --help

rdp-cli doctor status#

Прочитать результат диагностики

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--diagnostic-id

ID исходного запроса диагностики

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli doctor status --help

rdp-cli doctor cancel#

Отменить оставшуюся диагностику

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--diagnostic-id

ID исходного запроса диагностики

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli wait --help

rdp-cli wait status#

Прочитать результат ожидания

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--wait-id

ID исходного запроса ожидания

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli wait cancel --help

rdp-cli batch#

Выполнить до 64 шагов после предварительной проверки

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--json

Версионированный JSON для этой команды

ТекстНеобязательный
--steps-stdin

Читать JSON пакета из stdin

ФлагНеобязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli batch --help

rdp-cli batch status#

Прочитать результат пакета без повторного выполнения

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--batch-id

ID исходного запроса пакета

ТекстОбязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--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

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli batch cancel --help

rdp-cli operations cancel#

Отменить оставшийся ввод; отправленный ввод не отменяется

Требуется --session SESSION.

Параметры команды
ПараметрФормат и значенияТребование
--operation-id

Идентификатор операции

ТекстНеобязательный
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli operations cancel --help

rdp-cli mcp stdio#

Предоставить MCP через стандартные ввод и вывод

Сеанс не обязателен. Возможность указать его дополнительно показана ниже, если поддерживается.

Параметры команды
ПараметрФормат и значенияТребование
--agent-id

Agent, получающий управление

ТекстНеобязательный
--agent-ref

Ссылка на учётные данные вызывающего агента

ТекстНеобязательный
--claim-ref

Ссылка на текущее право управления

ТекстНеобязательный
--task

ID постоянной задачи

ТекстНеобязательный
--run

ID запуска задачи

ТекстНеобязательный

rdp-cli mcp stdio --help

Условия протокола и платформы

  • По умолчанию RDP использует --cert-policy ignore и --tls-profile modern. Сервер TLS 1.2 тоже может требовать старые подписи или шифры. Для известного устаревшего узла повторите попытку один раз с --tls-profile legacy, сохранив учётные данные и политику сертификатов и задав новый ID запроса. 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 укажите учётную запись Mac через --user и её пароль. ARD выбирается автоматически или через --vnc-security ard. Для отдельного пароля VNC используйте --vnc-security vnc-auth без --user. 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 или неверный пароль. Для известного устаревшего узла повторите connect один раз с --tls-profile legacy и новым ID. CERTIFICATE_UNTRUSTED: проверьте доверие, имя и фактический отпечаток сертификата; смена TLS-профиля не решает проблему доверия.
CAPABILITY_UNAVAILABLE / CLIPBOARD_ENCODING_UNSUPPORTED
Проверьте возможности/кодировку и выберите поддерживаемую операцию.
REQUEST_TIMEOUT / REQUEST_ID_CONFLICT / REQUEST_WINDOW_EXPIRED
Перед повтором проверьте операцию и экран; не используйте ID с другими аргументами или после истечения хранения.