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

Наблюдать, действовать, проверять

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 дают подсказки, но не разрешают слепой повтор.

Все команды принимают --request-id и --timeout-ms. Повторно используйте ID только с той же командой и аргументами в пределах срока хранения. Локальный тайм-аут не доказывает отсутствие отправки; сначала запросите operations status.

Условия протокола и платформы

• RDP использует --cert-policy ignore и --tls-profile modern. strict проверяет доверие и имя; legacy явно допускает старый TLS. Проверка веб-HTTPS не меняется.
• VNC отклоняет --user, --domain, --size, --layout, --cert-policy и --tls-profile. Классическая проверка использует восемь байтов UTF-8 пароля. Без проверки нужны --vnc-security none и отсутствие пароля. Поддерживаемые VNC-транспорты не зашифрованы.
• VNC не предоставляет файлы, звук, микрофон или активную смену экранов. UTF-8 буфера требует согласования; иначе доступен только Latin-1.
• Файлам RDP нужна переадресация диска. Звук, буфер, микрофон и несколько экранов также зависят от политики сервера.
• Windows/macOS имеют нативный просмотр и индикаторы. Linux требует служб экрана/звука и Secret Service для сохранённых паролей; поддерживаемые CLI-операции работают и без рабочего стола.
• Unicode вводится с задержками совместимости. Выберите тайм-аут для длинного текста и проверьте результат; просмотр не гарантирует любые символы на любом сервере.

Восстановление после ошибки

OBSERVATION_REQUIRED / INVALID_COORDINATES

Сделайте новый снимок, проверьте экраны и координаты.

SESSION_PAUSED / CONTROL_HELD_BY_HUMAN

Остановите ввод и дождитесь явной передачи обратно Agent.

AUTH_FAILED / VNC_AUTH_FAILED

Проверьте аккаунт, источник пароля и политику сервера.

RDP_TLS_HANDSHAKE_FAILED / CERTIFICATE_UNTRUSTED

Проверьте TLS, сертификат и отпечаток; ошибка TLS не означает неверный пароль.

CAPABILITY_UNAVAILABLE / CLIPBOARD_ENCODING_UNSUPPORTED

Проверьте возможности/кодировку и выберите поддерживаемую операцию.

REQUEST_TIMEOUT / REQUEST_ID_CONFLICT / REQUEST_WINDOW_EXPIRED

Перед повтором проверьте операцию и экран; не используйте ID с другими аргументами или после истечения хранения.