rdp-cli · 0.3.1

Referencia de comandos de rdp-cli

109 comandos para escritorios remotos, aplicaciones Linux y Android: conecta, observa, actúa, intercambia archivos y comparte el control.

Buscar comandos por tarea

¿Es tu primera vez con rdp-cli? Empieza por la instalación y la primera conexión. →

connect
Conecta una sesión persistente RDP, VNC o Android ADB.
screenshot
Capturar un PNG coherente
click
Hacer clic en una coordenada
type
Escribe sin cambiar el portapapeles; Android admite ASCII imprimible, LF y TAB. Use android text para pegar Unicode.
files upload
Sube al directorio raíz de la sesión y verifica la transferencia finalizada.
files download
Descarga desde la unidad RDP o una instantánea estable del archivo Android.
watch
Abrir o activar un visor humano
list
Listar sesiones visibles

Catálogo verificado con la compilación 2026110701 para Windows, macOS y Linux. Comprueba tu ejecutable con --version y --help-json.

Observar, actuar y verificar

USER, SESSION, OBSERVATION, X e Y son marcadores. Envía la contraseña por stdin y cierra el flujo: --password-stdin no abre un diálogo interactivo. Guarda data.session, lee before.png, elige coordenadas de esa imagen y comprueba after.png. Enviar entrada no demuestra que la tarea haya terminado.

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 muestra la versión y las capacidades; --help-json devuelve el catálogo estructurado; COMMAND --help describe todas las opciones sin iniciar una sesión.

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

JSON y opciones comunes

Los comandos normales devuelven un objeto JSON UTF-8 por stdout: ok: true con data, o ok: false con error. stderr contiene diagnósticos. Códigos de salida: 0 éxito, 1 fallo operativo, 2 argumentos no válidos.

La ayuda es texto. events --follow transmite NDJSON; events sin seguimiento devuelve un resultado JSON con data.events y data.ndjson. En PowerShell 5.1 configura [Console]::OutputEncoding y $OutputEncoding como UTF-8 para texto no ASCII.

data.session
Conserva el ID devuelto por connect.
data.observation
Usa el token de la captura; renuévalo tras reconectar o cambiar control o pantallas.
data.capabilities
Consulta las capacidades negociadas antes de usar archivos, sonido, portapapeles o pantallas.
data.state / data.remote_outcome
queued, sent, partial, unknown, cancelled y failed describen el progreso. remote_outcome: not_confirmed exige verificar el efecto.
data.transfer_id
Consulta o cancela con ese ID; espera un estado final y revisa los hashes de archivos completados.
error.code / error.message / error.retryable
Decide según el código estable. El mensaje aporta contexto; retryable no autoriza repetir a ciegas.
data.activity
Actividad actual o reciente, origen humano o Agent, tiempo transcurrido y progreso de transferencia. No incluye texto escrito ni contenido del portapapeles y no demuestra que la tarea remota haya terminado.

Todos los comandos aceptan --request-id y --timeout-ms. Reutiliza un ID solo con idénticos argumentos y dentro de la ventana de retención. Un tiempo agotado no demuestra que no se enviara entrada: consulta operations status.

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

Sesiones

RDP/VNC requiere --host; RDP también requiere --user. Los puertos predeterminados son 3389 y 5900. Elija una fuente de contraseña cuando se requiera autenticación; --vnc-security none no utiliza contraseña. ADB utiliza --device y --transport, con dirección y puerto de conexión Wi-Fi opcionales. --domain, --size y --layout son opciones RDP. reconnect mantiene el control en pausa; disconnect no cierra la sesión del usuario remoto.

rdp-cli connect#

Conecta una sesión persistente RDP, VNC o Android ADB.

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--profile

Perfil de conexión guardado

TextoOpcional
--host

Host RDP/VNC o dirección Wi-Fi Android explícita.

TextoOpcional
--protocol

Protocolo: RDP, VNC, ADB o X11; cada uno usa su destino explícito y sus reglas de autenticación.

Selección
rdp | vnc | adb | x11
Predeterminado: rdp
Opcional
--mode

Modo X11: escritorio existente o aplicación reenviada.

Selección
desktop | application
Opcional
--display

Display X11 existente y autorizado; solo modo escritorio.

TextoOpcional
--xauthority

Ruta absoluta de Xauthority remoto existente; solo escritorio.

TextoOpcional
--ssh-known-hosts

Archivo local known_hosts de OpenSSH; no requiere un ejecutable SSH externo.

RutaOpcional
--ssh-key

Clave SSH privada local; la entrada de contraseña proporciona su frase de acceso.

RutaOpcional
--ssh-host-key

Huella SSH SHA256 verificada por una vía independiente.

TextoOpcional
--linux-file-root

Directorio SFTP absoluto autorizado; por defecto, un directorio privado de sesión dentro del inicio SSH.

TextoOpcional
--application

Ruta absoluta de una aplicación X11 remota ya instalada.

TextoOpcional
--app-args

Matriz JSON de argumentos literales, sin interpretación de shell.

TextoOpcional
--device

ID explícito devuelto por android devices; obligatorio para ADB.

TextoOpcional
--transport

Transporte USB o Wi-Fi explícito; obligatorio para ADB.

Selección
usb | wifi
Opcional
--device-auth-ref

Reutiliza una identidad guardada explícitamente en el almacén de credenciales del sistema.

TextoOpcional
--save-device-auth

Guarda explícitamente la identidad autorizada con esta referencia local.

TextoOpcional
--device-file-root

Directorio Android autorizado; predeterminado: /sdcard/Download/rdp-cli/<session-id>.

RutaOpcional
--android-display

Pantalla principal o virtual propia de la sesión

Selección
main | virtual
Opcional
--android-virtual-size

Tamaño virtual, ANCHOxALTO

TextoOpcional
--android-virtual-dpi

DPI de pantalla virtual

Entero positivoOpcional
--android-start-app

Aplicación instalada que se abrirá en la pantalla virtual

TextoOpcional
--vnc-security

Autenticación VNC; none debe elegirse explícitamente

Selección
vnc-auth | none | x509-plain | ard
Opcional
--vnc-tls-pin

Huella SHA256 verificada del certificado final para VNC X509Plain.

TextoOpcional
--port

Puerto TCP: RDP 3389 o VNC 5900. android pair usa el puerto de emparejamiento del teléfono; ADB connect usa otro puerto de conexión.

Entero positivo
Predeterminado: RDP 3389 · VNC 5900
Opcional
--user

Cuenta local o de dominio; obligatoria en RDP

TextoOpcional
--domain

Dominio de Windows

TextoOpcional
--password

Contraseña; VNC clásico usa los primeros 8 bytes UTF-8

TextoOpcional
--password-stdin

Leer la contraseña de la entrada estándar hasta EOF

IndicadorOpcional
--cert-policy

Política del certificado RDP, independiente de HTTPS web

Selección
ignore | strict
Predeterminado: ignore
Opcional
--tls-profile

modern exige TLS 1.2 y criptografía moderna; legacy permite firmas/cifrados antiguos, incluido SHA-1 con TLS 1.2, y TLS 1.0 en esta sesión, sin forzar una versión anterior

Selección
modern | legacy
Predeterminado: modern
Opcional
--credential-ref

Referencia existente del almacén de credenciales

TextoOpcional
--audio-mode

Destino del sonido RDP: visor (client), equipo controlado (host) o desactivado (off)

Selección
client | host | off
Predeterminado: client
Opcional
--microphone-mode

Origen del micrófono RDP: visor autorizado (client), auxiliar compatible del equipo controlado (host) o desactivado (off)

Selección
client | host | off
Predeterminado: client
Opcional
--save-credential

Guardar la contraseña válida con esta referencia

TextoOpcional
--name

Nombre legible de la sesión

TextoOpcional
--size

Tamaño del escritorio WIDTHxHEIGHT

TextoOpcional
--layout

Diseño de monitores en JSON o @file

TextoOpcional
--connect-timeout-ms

Plazo de conexión en milisegundos

Entero positivoOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli connect --help

rdp-cli list#

Listar sesiones visibles

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli list --help

rdp-cli status#

Consultar el estado de la sesión

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli status --help

rdp-cli reconnect#

Reconectar y permanecer en pausa

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli reconnect --help

rdp-cli disconnect#

Cierra la sesión remota; RDP no cierra la sesión del usuario de Windows.

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli disconnect --help

Visores y estado

watch abre un visor humano de solo lectura: --viewer window o web. Los comandos del Agent no lo necesitan. presence show/hide controla el estado local; --floating añade controles y --panel abre el panel de sesiones de macOS o Linux. Cerrar el visor de observación mantiene la conexión.

rdp-cli watch#

Abrir o activar un visor humano

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--viewer

Implementación del visor

Selección
window | web
Predeterminado: window
Opcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli watch --help

rdp-cli presence show#

Mostrar el estado de escritorio

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--floating

Mostrar también los controles flotantes opcionales

IndicadorOpcional
--panel

Abrir también el panel de sesiones en macOS o Linux

IndicadorOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli presence show --help

rdp-cli presence hide#

Ocultar el estado sin desconectar

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli presence hide --help

Control y entrega

pause usa --session o --all y revoca el control humano. resume devuelve la sesión al Agent. control take necesita un viewer ID conectado; release puede indicar ese visor o el Agent destino. Respeta la pausa humana y captura de nuevo al recibir el control.

rdp-cli pause#

Pausar entrada y revocar control humano

Elige exactamente uno: --session SESSION o --all.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli pause --help

rdp-cli resume#

Devolver la sesión al Agent

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli resume --help

rdp-cli control take#

Dar control al visor conectado

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--viewer-id

ID del visor conectado; cuando corresponda, titular del control

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli control take --help

rdp-cli control release#

Devolver control al Agent

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--viewer-id

ID del visor conectado; cuando corresponda, titular del control

TextoOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--to-agent

Identidad del agente destino

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli control release --help

Capturas, entrada y portapapeles

screenshot guarda un PNG con --out y selecciona pantalla con --monitor. La entrada requiere observation y coordenadas de pantalla o --desktop, sin mezclarlas. drag usa coordenadas iniciales/finales y pantallas opcionales. type elige --text o --text-stdin; --sensitive cambia el aviso, no oculta la captura. key usa --keys o --key con --state. Escribir en el portapapeles reemplaza el texto remoto.

rdp-cli screenshot#

Capturar un PNG coherente

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--monitor

ID de monitor; screenshot también admite all

Texto
Predeterminado: all
Opcional
--region

Región x,y,width,height en píxeles remotos

TextoOpcional
--max-width

Ancho máximo de imagen; no cambia las coordenadas de entrada

Entero positivoOpcional
--since

Referencia de comparación de una captura anterior

TextoOpcional
--out

Archivo PNG de destino

RutaOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli screenshot --help

rdp-cli move#

Mover el puntero remoto

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--x

Coordenada x remota

EnteroObligatoria
--y

Coordenada y remota

EnteroObligatoria
--monitor

ID de monitor; screenshot también admite all

TextoOpcional
--desktop

Usar coordenadas de escritorio en vez de coordenadas locales del monitor

IndicadorOpcional
--observation

Token de una captura reciente

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli move --help

rdp-cli click#

Hacer clic en una coordenada

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--x

Coordenada x remota

EnteroObligatoria
--y

Coordenada y remota

EnteroObligatoria
--button

Botón del ratón

Selección
left | right | middle
Predeterminado: left
Opcional
--count

Número de clics

Entero positivoOpcional
--monitor

ID de monitor; screenshot también admite all

TextoOpcional
--desktop

Usar coordenadas de escritorio en vez de coordenadas locales del monitor

IndicadorOpcional
--observation

Token de una captura reciente

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli click --help

rdp-cli scroll#

Desplazar en una coordenada

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--x

Coordenada x remota

EnteroObligatoria
--y

Coordenada y remota

EnteroObligatoria
--delta-x

Unidades horizontales de rueda con signo

EnteroOpcional
--delta-y

Unidades verticales de rueda con signo

EnteroOpcional
--monitor

ID de monitor; screenshot también admite all

TextoOpcional
--desktop

Usar coordenadas de escritorio en vez de coordenadas locales del monitor

IndicadorOpcional
--observation

Token de una captura reciente

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli scroll --help

rdp-cli drag#

Arrastrar entre coordenadas

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--from-x

Coordenada x inicial

EnteroObligatoria
--from-y

Coordenada y inicial

EnteroObligatoria
--to-x

Coordenada x final

EnteroObligatoria
--to-y

Coordenada y final

EnteroObligatoria
--from-monitor

ID del monitor inicial

TextoOpcional
--to-monitor

ID del monitor final

TextoOpcional
--desktop

Usar coordenadas de escritorio en vez de coordenadas locales del monitor

IndicadorOpcional
--observation

Token de una captura reciente

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli drag --help

rdp-cli type#

Escribe sin cambiar el portapapeles; Android admite ASCII imprimible, LF y TAB. Use android text para pegar Unicode.

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--text

Texto Unicode de entrada o portapapeles

TextoOpcional
--text-stdin

Leer texto de entrada o portapapeles hasta EOF

IndicadorOpcional
--sensitive

Ocultar texto en eventos observables; las capturas siguen mostrando el escritorio

IndicadorOpcional
--observation

Token de una captura reciente

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli type --help

rdp-cli key#

Enviar teclas o su estado

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--keys

Combinación como CTRL+S

TextoOpcional
--key

Nombre de tecla; android key usa las teclas del sistema indicadas.

TextoOpcional
--state

Estado de tecla o silencio de audio según los valores indicados

Selección
down | up
Opcional
--observation

Token de una captura reciente

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli key --help

rdp-cli clipboard get#

Leer el portapapeles remoto

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli clipboard get --help

rdp-cli clipboard set#

Escribir el portapapeles remoto

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--text

Texto Unicode de entrada o portapapeles

TextoOpcional
--text-stdin

Leer texto de entrada o portapapeles hasta EOF

IndicadorOpcional
--observation

Token de una captura reciente

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli clipboard set --help

Archivos

--path es relativo a la unidad RDP, directorio Android o raíz SFTP X11 autorizados. --local indica un archivo o carpeta local. Para reemplazar usa --overwrite. Comprueba el estado y los hashes finales; no repitas operaciones con resultado desconocido.

rdp-cli files list#

Lista archivos de la unidad RDP o del directorio Android autorizado.

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--path

Ruta relativa a la unidad RDP o al directorio Android autorizado.

RutaOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli files list --help

rdp-cli files upload#

Sube al directorio raíz de la sesión y verifica la transferencia finalizada.

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--local

Archivo/directorio local de carga o destino de descarga

RutaObligatoria
--path

Ruta relativa a la unidad RDP o al directorio Android autorizado.

RutaObligatoria
--overwrite

Permitir sustituir un destino existente

IndicadorOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli files upload --help

rdp-cli files download#

Descarga desde la unidad RDP o una instantánea estable del archivo Android.

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--path

Ruta relativa a la unidad RDP o al directorio Android autorizado.

RutaObligatoria
--local

Archivo/directorio local de carga o destino de descarga

RutaObligatoria
--overwrite

Permitir sustituir un destino existente

IndicadorOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli files download --help

rdp-cli files status#

Consultar transferencias

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--transfer-id

ID de transferencia; si se omite en files status, lista las transferencias

TextoOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli files status --help

rdp-cli files cancel#

Cancelar una transferencia

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--transfer-id

ID de transferencia; si se omite en files status, lista las transferencias

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli files cancel --help

rdp-cli files cleanup#

Eliminar contenido del intercambio

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--path

Ruta relativa a la unidad RDP o al directorio Android autorizado.

RutaObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli files cleanup --help

Audio y micrófono

En RDP, --audio-mode client|host|off y --microphone-mode client|host|off eligen por separado la reproducción y el micrófono para una conexión nueva, sin iniciar grabación. host necesita el servicio correspondiente en el Windows controlado y no está disponible en Linux. X11/VNC no tienen canal de audio del producto.

rdp-cli host-microphone install#

Instalar e iniciar en este PC Windows el auxiliar de micrófono del equipo controlado

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli host-microphone install --help

rdp-cli host-microphone status#

Comprobar si el auxiliar de micrófono del equipo controlado está instalado en este PC Windows

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli host-microphone status --help

rdp-cli host-microphone uninstall#

Detener y eliminar de este PC Windows el auxiliar de micrófono del equipo controlado

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli host-microphone uninstall --help

rdp-cli audio status#

Consultar capacidades de audio

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli audio status --help

rdp-cli audio mute#

Silenciar o reactivar un visor

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--viewer-id

ID del visor conectado; cuando corresponda, titular del control

TextoObligatoria
--state

Estado de tecla o silencio de audio según los valores indicados

Selección
on | off
Obligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli audio mute --help

rdp-cli audio volume#

Ajustar el volumen de un visor

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--viewer-id

ID del visor conectado; cuando corresponda, titular del control

TextoObligatoria
--percent

Ganancia de reproducción en porcentaje

Entero positivoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli audio volume --help

rdp-cli audio microphone#

Consultar o detener el micrófono

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--action

Consultar o detener el micrófono; iniciarlo requiere un visor humano

Selección
status | stop
Predeterminado: status
Opcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli audio microphone --help

rdp-cli audio android#

Selecciona explícitamente reproducción, micrófono del teléfono o desactivado.

Requiere una descarga actual compatible con Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) o Linux (x86_64 / ARM64).

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--source

Audio del teléfono: off, output (permiso de compartir del sistema) o microphone (requiere control y un --observation reciente).

Selección
off | output | microphone
Obligatoria
--observation

Token de una captura reciente

TextoOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli audio android --help

rdp-cli audio poll#

Lee una cantidad limitada de muestras PCM recientes.

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--after

Devuelve eventos o muestras PCM posteriores a esta secuencia.

Entero positivoOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli audio poll --help

Pantallas

monitors consulta la topología. monitors set acepta JSON o @file; --allow-reconnect permite reconectar si no hay cambio dinámico. Lee la nueva topología y captura otra imagen. VNC informa del framebuffer pero rechaza cambios solicitados de disposición.

rdp-cli monitors#

Consultar la topología negociada

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli monitors --help

rdp-cli monitors set#

Cambiar la disposición de pantallas

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--layout

Diseño de monitores en JSON o @file

TextoObligatoria
--allow-reconnect

Permitir reconexión si no hay cambio dinámico de monitores

IndicadorOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli monitors set --help

Acceso web

web start configura escucha, certificado/clave TLS o proxy de confianza; --ice-server se puede repetir. Fuera de loopback se necesitan LAN/VPN, HTTPS y autorización. access grant usa --permission repetible y --expires-in en segundos. Permisos: session.observe/control, clipboard.read/write, files.read/write y audio.listen/send. Revocar cierra sus flujos.

rdp-cli web start#

Iniciar el servicio web autorizado

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--listen

Dirección de escucha

TextoOpcional
--tls-cert

Archivo de certificado HTTPS

RutaOpcional
--tls-key

Archivo de clave privada HTTPS

RutaOpcional
--trust-proxy

Confiar en el proxy configurado

IndicadorOpcional
--ice-server

URL STUN/TURN para WebRTC

TextoOpcional · Repetible
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli web start --help

rdp-cli web status#

Consultar el servicio web

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli web status --help

rdp-cli web stop#

Detiene el acceso del navegador y conserva las sesiones remotas conectadas.

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli web stop --help

rdp-cli access grant#

Crear una autorización web limitada

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--permission

Permiso concedido al token de acceso

TextoObligatoria · Repetible
--expires-in

Duración del permiso en segundos

Entero positivoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli access grant --help

rdp-cli access list#

Listar autorizaciones

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli access list --help

rdp-cli access revoke#

Revocar autorización y flujos

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--grant-id

Identificador del permiso

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli access revoke --help

Teléfonos Android

Indique el ID del dispositivo y el transporte usb o wifi. Detectar un teléfono no lo autoriza. El puerto de emparejamiento es distinto del de conexión. Envíe el código por la entrada estándar y cierre el flujo. Guarde la identidad solo de forma explícita. La entrada y los cambios de aplicaciones requieren control y una observación reciente; consulte el trabajo antes de repetir una operación incierta.

rdp-cli android devices#

Detecta candidatos USB y Wi-Fi sin autorizarlos.

Requiere una descarga actual compatible con Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) o Linux (x86_64 / ARM64).

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli android devices --help

rdp-cli android pair#

Empareja por el puerto de emparejamiento y un código enviado por la entrada estándar.

Requiere una descarga actual compatible con Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) o Linux (x86_64 / ARM64).

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--host

Host RDP/VNC o dirección Wi-Fi Android explícita.

TextoObligatoria
--port

Puerto TCP: RDP 3389 o VNC 5900. android pair usa el puerto de emparejamiento del teléfono; ADB connect usa otro puerto de conexión.

Entero positivoObligatoria
--code-stdin

Lee el código de seis dígitos desde la entrada estándar.

IndicadorOpcional
--device-auth-ref

Reutiliza una identidad guardada explícitamente en el almacén de credenciales del sistema.

TextoOpcional
--save-device-auth

Guarda explícitamente la identidad autorizada con esta referencia local.

TextoOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli android pair --help

rdp-cli android forget#

Elimina una identidad Android local guardada; la revocación en el teléfono es independiente.

Requiere una descarga actual compatible con Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) o Linux (x86_64 / ARM64).

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--device-auth-ref

Reutiliza una identidad guardada explícitamente en el almacén de credenciales del sistema.

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli android forget --help

rdp-cli android apps list#

Lista los paquetes Android instalados.

Requiere una descarga actual compatible con Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) o Linux (x86_64 / ARM64).

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli android apps list --help

rdp-cli android apps info#

Consulta las rutas reales de instalación de un paquete.

Requiere una descarga actual compatible con Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) o Linux (x86_64 / ARM64).

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--package

Nombre del paquete Android.

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli android apps info --help

rdp-cli android apps install#

Envía un único APK del directorio autorizado y sigue su trabajo.

Requiere una descarga actual compatible con Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) o Linux (x86_64 / ARM64).

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--path

Ruta relativa a la unidad RDP o al directorio Android autorizado.

RutaObligatoria
--replace

Reemplaza explícitamente una aplicación instalada.

IndicadorOpcional
--observation

Token de una captura reciente

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli android apps install --help

rdp-cli android apps launch#

Abre un paquete y verifica su pantalla.

Requiere una descarga actual compatible con Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) o Linux (x86_64 / ARM64).

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--package

Nombre del paquete Android.

TextoObligatoria
--activity

Clase Activity; si se omite, resuelve el iniciador.

TextoOpcional
--observation

Token de una captura reciente

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli android apps launch --help

rdp-cli android apps stop#

Fuerza la detención del paquete Android indicado.

Requiere una descarga actual compatible con Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) o Linux (x86_64 / ARM64).

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--package

Nombre del paquete Android.

TextoObligatoria
--observation

Token de una captura reciente

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli android apps stop --help

rdp-cli android apps status#

Consulta un trabajo sin repetir su operación.

Requiere una descarga actual compatible con Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) o Linux (x86_64 / ARM64).

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--job

ID de trabajo devuelto al instalar, abrir o detener.

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli android apps status --help

rdp-cli android touch#

Envía un gesto táctil completo y temporizado usando una captura reciente.

Requiere una descarga actual compatible con Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) o Linux (x86_64 / ARM64).

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--kind

Tipo de gesto táctil.

Selección
tap | double-tap | long-press | swipe | drag | pinch | gesture
Obligatoria
--x

Coordenada x remota

EnteroOpcional
--y

Coordenada y remota

EnteroOpcional
--to-x

Coordenada x final

EnteroOpcional
--to-y

Coordenada y final

EnteroOpcional
--second-x

Coordenada X inicial del segundo dedo.

EnteroOpcional
--second-y

Coordenada Y inicial del segundo dedo.

EnteroOpcional
--second-to-x

Coordenada X final del segundo dedo.

EnteroOpcional
--second-to-y

Coordenada Y final del segundo dedo.

EnteroOpcional
--duration-ms

Duración de 1–10000 ms; arrastrar añade una pulsación de 400 ms.

Entero positivoOpcional
--events-stdin

Lee un array JSON [{at_ms,contact,phase,x,y}, …] de stdin; solo para --kind gesture.

IndicadorOpcional
--observation

Token de una captura reciente

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli android touch --help

rdp-cli android key#

Pulsa una tecla del sistema Android con control y observación reciente.

Requiere una descarga actual compatible con Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) o Linux (x86_64 / ARM64).

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--key

Nombre de tecla; android key usa las teclas del sistema indicadas.

Selección
back | home | recent | enter | backspace
Obligatoria
--observation

Token de una captura reciente

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli android key --help

rdp-cli android text#

Pega Unicode explícitamente mediante el portapapeles del teléfono.

Requiere una descarga actual compatible con Android para Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) o Linux (x86_64 / ARM64).

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--method

Método explícito de texto: pegar con clipboard.

Selección
clipboard
Obligatoria
--text

Texto Unicode de entrada o portapapeles

TextoOpcional
--text-stdin

Leer texto de entrada o portapapeles hasta EOF

IndicadorOpcional
--observation

Token de una captura reciente

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli android text --help

Escritorios y aplicaciones Linux

Usa --protocol x11, elige desktop o application y verifica la identidad SSH. El cliente SSH y la pantalla de la aplicación están integrados. Wayland usa un destino RDP/VNC ya configurado. X11 no tiene canales de audio ni micrófono. SFTP se limita al directorio autorizado; no se instala ningún servicio remoto.

rdp-cli linux targets#

Descubre pantallas Linux y destinos compatibles existentes sin iniciar servicios.

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--host

Host RDP/VNC o dirección Wi-Fi Android explícita.

TextoObligatoria
--user

Cuenta local o de dominio; obligatoria en RDP

TextoObligatoria
--port

Puerto TCP: RDP 3389 o VNC 5900. android pair usa el puerto de emparejamiento del teléfono; ADB connect usa otro puerto de conexión.

Entero positivo
Predeterminado: 22
Opcional
--ssh-known-hosts

Archivo local known_hosts de OpenSSH; no requiere un ejecutable SSH externo.

RutaOpcional
--ssh-host-key

Huella SSH SHA256 verificada por una vía independiente.

TextoOpcional
--ssh-key

Clave SSH privada local; la entrada de contraseña proporciona su frase de acceso.

RutaOpcional
--password

Contraseña; VNC clásico usa los primeros 8 bytes UTF-8

TextoOpcional
--password-stdin

Leer la contraseña de la entrada estándar hasta EOF

IndicadorOpcional
--credential-ref

Referencia existente del almacén de credenciales

TextoOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli linux targets --help

rdp-cli linux text#

Escribe texto o pega explícitamente desde el portapapeles remoto.

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--method

Método explícito de texto: pegar con clipboard.

Selección
clipboard
Obligatoria
--keys

Combinación como CTRL+S

Selección
CTRL+V | CTRL+SHIFT+V | SHIFT+INSERT
Predeterminado: CTRL+V
Opcional
--text

Texto Unicode de entrada o portapapeles

TextoOpcional
--text-stdin

Leer texto de entrada o portapapeles hasta EOF

IndicadorOpcional
--observation

Token de una captura reciente

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli linux text --help

rdp-cli linux apps list#

Enumera las instancias X11 reenviadas en esta sesión.

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli linux apps list --help

rdp-cli linux apps stop#

Detiene una instancia de aplicación elegida explícitamente.

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--instance

ID exacto de instancia devuelto por linux apps list.

TextoObligatoria
--observation

Token de una captura reciente

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli linux apps stop --help

Operaciones y eventos

operations status consulta por operation ID o request ID original sin repetir entrada. events lee eventos; --follow continúa y --after usa un cursor. Un resultado sent necesita verificación en la aplicación remota.

rdp-cli operations status#

Consultar un resultado conservado

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--operation-id

Identificador de operación

TextoOpcional
--request-id

ID de correlación/idempotencia; operations status consulta la petición original

TextoOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli operations status --help

rdp-cli events#

Leer o seguir eventos

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--follow

Seguir eventos nuevos

IndicadorOpcional
--after

Devuelve eventos o muestras PCM posteriores a esta secuencia.

TextoOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli events --help

Confianza, credenciales e instalación

trust asocia destino RDP y huella en modo estricto. credentials remove borra la referencia indicada. En macOS y Linux, install-cli/uninstall-cli gestionan la entrada CLI y --prefix elige su ubicación; Windows ejecuta el archivo descargado. presence show --panel abre el panel de sesiones en macOS y Linux. licenses muestra versiones y licencias de terceros.

rdp-cli trust list#

Listar registros de confianza RDP

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli trust list --help

rdp-cli trust add#

Confiar en una huella concreta

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--target

Destino de confianza RDP

TextoObligatoria
--fingerprint

Huella del certificado

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli trust add --help

rdp-cli trust remove#

Eliminar un registro de confianza

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--target

Destino de confianza RDP

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli trust remove --help

rdp-cli credentials remove#

Eliminar una credencial del producto

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--reference

Referencia de credencial que se eliminará

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli credentials remove --help

rdp-cli install-cli#

Instalar la entrada CLI en macOS o Linux

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--prefix

Prefijo de instalación controlado por el usuario

RutaOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli install-cli --help

rdp-cli uninstall-cli#

Eliminar la entrada CLI creada

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli uninstall-cli --help

rdp-cli licenses#

Mostrar versiones y licencias de terceros

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli licenses --help

Tareas y automatización de agentes

Añade capturas por región y comparación de imágenes, esperas condicionales, lotes de acciones, informes persistentes, colaboración entre agentes, MCP con perfiles y diagnósticos, y pantallas virtuales Android.

rdp-cli tasks create#

Crear una tarea persistente

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--title

Título de la tarea

TextoObligatoria
--session

ID explícito de sesión

TextoOpcional
--record-frames

Conservar explícitamente capturas clave

IndicadorOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli tasks create --help

rdp-cli tasks list#

Listar tareas autorizadas

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli tasks list --help

rdp-cli tasks status#

Consultar progreso e historial

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--task

ID de tarea persistente

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli tasks status --help

rdp-cli tasks attach#

Asociar una sesión autorizada a una tarea

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--task

ID de tarea persistente

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli tasks attach --help

rdp-cli tasks checkpoint#

Guardar un punto de control sin repetir entradas

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--task

ID de tarea persistente

TextoObligatoria
--note

Nota de progreso sin secretos

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli tasks checkpoint --help

rdp-cli tasks new-run#

Iniciar una ejecución desde un punto de control

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--task

ID de tarea persistente

TextoObligatoria
--from-checkpoint

ID de punto de control existente

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli tasks new-run --help

rdp-cli tasks grants list#

Listar permisos de la tarea

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--task

ID de tarea persistente

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli tasks grants list --help

rdp-cli tasks grants grant#

Conceder permisos de la tarea

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--task

ID de tarea persistente

TextoObligatoria
--to-agent

Identidad del agente destino

TextoObligatoria
--permission

Permiso concedido al token de acceso

TextoObligatoria · Repetible
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli tasks grants grant --help

rdp-cli tasks grants revoke#

Revocar el acceso futuro a la tarea

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--task

ID de tarea persistente

TextoObligatoria
--to-agent

Identidad del agente destino

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli tasks grants revoke --help

rdp-cli tasks evidence#

Guardar pruebas locales seleccionadas

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--task

ID de tarea persistente

TextoObligatoria
--file

Archivo local de prueba, hasta 4 MiB

RutaObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli tasks evidence --help

rdp-cli tasks export#

Exportar un informe JSON o HTML sin conexión

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--task

ID de tarea persistente

TextoObligatoria
--out

Archivo PNG de destino

RutaObligatoria
--format

Formato de salida; consulta los valores de este comando

Selección
json | html
Predeterminado: json
Opcional
--include-evidence

Incluir pruebas guardadas explícitamente

IndicadorOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli tasks export --help

rdp-cli tasks purge#

Borrar el historial local seleccionado

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--task

ID de tarea persistente

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli tasks purge --help

rdp-cli agents register#

Registrar la identidad de un agente

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--name

Nombre legible de la sesión

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli agents register --help

rdp-cli agents list#

Listar agentes sin revelar secretos

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli agents list --help

rdp-cli agents show#

Consultar identidad y permisos de un agente

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--id

Identidad destino

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli agents show --help

rdp-cli agents revoke#

Revocar un agente y sus permisos de control

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--id

Identidad destino

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli agents revoke --help

rdp-cli agents grant#

Autorizar un agente para la sesión

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--id

Identidad destino

TextoObligatoria
--permission

Permiso concedido al token de acceso

TextoObligatoria · Repetible
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli agents grant --help

rdp-cli agents revoke-access#

Revocar el acceso del agente a la sesión

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--id

Identidad destino

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli agents revoke-access --help

rdp-cli control claim#

Tomar una sesión pausada como agente identificado

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--lease-seconds

Duración del control en segundos

Entero positivo
Predeterminado: 60
Opcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli control claim --help

rdp-cli control renew#

Renovar un permiso de control vigente

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--lease-seconds

Duración del control en segundos

Entero positivo
Predeterminado: 60
Opcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli control renew --help

rdp-cli control unclaim#

Liberar el control y pausar la sesión

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli control unclaim --help

rdp-cli control claim-status#

Consultar quién tiene el control

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli control claim-status --help

rdp-cli control handoff#

Transferir el control a un agente autorizado

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--to-agent

Identidad del agente destino

TextoObligatoria
--lease-seconds

Duración del control en segundos

Entero positivo
Predeterminado: 60
Opcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli control handoff --help

rdp-cli profiles list#

Listar perfiles de conexión

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli profiles list --help

rdp-cli profiles show#

Consultar un perfil y el origen de sus parámetros

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--name

Nombre legible de la sesión

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli profiles show --help

rdp-cli profiles save#

Guardar un perfil con referencias a credenciales

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--json

JSON con versión para este comando

TextoObligatoria
--replace

Reemplaza explícitamente una aplicación instalada.

IndicadorOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli profiles save --help

rdp-cli profiles remove#

Borrar un perfil conservando las credenciales

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--name

Nombre legible de la sesión

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli profiles remove --help

rdp-cli profiles export#

Exportar un perfil sin secretos

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--name

Nombre legible de la sesión

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli profiles export --help

rdp-cli profiles import#

Importar un perfil sin conectar

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--json

JSON con versión para este comando

TextoObligatoria
--replace

Reemplaza explícitamente una aplicación instalada.

IndicadorOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli profiles import --help

rdp-cli doctor#

Diagnosticar capacidades; la prueba de conexión es explícita

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--session

ID explícito de sesión

TextoOpcional
--profile

Perfil de conexión guardado

TextoOpcional
--probe

Crear explícitamente una conexión temporal del perfil

IndicadorOpcional
--redact

Omitir nombres, direcciones e ID de sesión

IndicadorOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli doctor --help

rdp-cli doctor status#

Consultar un diagnóstico

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--diagnostic-id

ID de solicitud de diagnóstico original

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli doctor status --help

rdp-cli doctor cancel#

Cancelar el trabajo de diagnóstico pendiente

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--diagnostic-id

ID de solicitud de diagnóstico original

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli doctor cancel --help

rdp-cli wait#

Esperar una condición de imagen o estado

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--condition

Condición de espera

Selección
changed | stable | connection | transfer | operation
Obligatoria
--region

Región x,y,width,height en píxeles remotos

TextoOpcional
--state

Estado de tecla o silencio de audio según los valores indicados

TextoOpcional
--transfer-id

ID de transferencia; si se omite en files status, lista las transferencias

TextoOpcional
--operation-id

Identificador de operación

TextoOpcional
--sample-ms

Intervalo de muestreo en milisegundos

Entero positivo
Predeterminado: 100
Opcional
--stable-ms

Duración estable continua en milisegundos

Entero positivo
Predeterminado: 1000
Opcional
--threshold-permille

Proporción de píxeles cambiados en milésimas

Entero
Predeterminado: 10
Opcional
--pixel-delta

Diferencia de canal RGB que se ignora

Entero
Predeterminado: 8
Opcional
--max-frame-age-ms

Antigüedad máxima de imagen en milisegundos

Entero positivo
Predeterminado: 5000
Opcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli wait --help

rdp-cli wait status#

Consultar el resultado de una espera

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--wait-id

ID de solicitud de espera original

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli wait status --help

rdp-cli wait cancel#

Cancelar la espera, no la operación observada

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--wait-id

ID de solicitud de espera original

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli wait cancel --help

rdp-cli batch#

Ejecutar hasta 64 pasos tras validarlos

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--json

JSON con versión para este comando

TextoOpcional
--steps-stdin

Leer JSON del lote desde stdin

IndicadorOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli batch --help

rdp-cli batch status#

Consultar un lote sin repetirlo

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--batch-id

ID de solicitud de lote original

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli batch status --help

rdp-cli batch cancel#

Cancelar pasos pendientes del lote

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--batch-id

ID de solicitud de lote original

TextoObligatoria
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli batch cancel --help

rdp-cli operations cancel#

Cancelar entradas pendientes; las enviadas no se deshacen

Requiere --session SESSION.

Opciones del comando
OpciónFormato y valoresRequisito
--operation-id

Identificador de operación

TextoOpcional
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli operations cancel --help

rdp-cli mcp stdio#

Ofrecer MCP por entrada y salida estándar

No requiere sesión. Si admite una sesión opcional, la opción aparece abajo.

Opciones del comando
OpciónFormato y valoresRequisito
--agent-id

Agent que recibirá el control

TextoOpcional
--agent-ref

Referencia de credencial del agente solicitante

TextoOpcional
--claim-ref

Referencia del permiso de control actual

TextoOpcional
--task

ID de tarea persistente

TextoOpcional
--run

ID de ejecución de tarea

TextoOpcional

rdp-cli mcp stdio --help

Condiciones de protocolo y plataforma

  • RDP usa --cert-policy ignore y --tls-profile modern por defecto. Un servidor TLS 1.2 también puede requerir firmas o cifrados antiguos. Para un destino antiguo conocido, reintenta una vez con --tls-profile legacy, las mismas credenciales y política de certificados, y un nuevo ID de solicitud. reconnect conserva el perfil; no hay degradación automática. strict valida la confianza y el nombre del certificado. Web HTTPS no cambia.
  • La seguridad de VNC depende del modo elegido. VNC clásico no cifra la conexión: usa una red de confianza o VPN. VeNCrypt X509Plain usa TLS y exige verificar el certificado. VNC cifrado: --vnc-security x509-plain requiere --user, una fuente de contraseña y --vnc-tls-pin verificado por otra vía. VNC clásico no admite --user. Las opciones RDP --domain, --size y --layout no se aplican.
  • VNC no ofrece archivos, audio, micrófono ni cambios activos de pantallas. El portapapeles UTF-8 requiere negociación; de otro modo solo acepta Latin-1.
  • Los archivos RDP requieren redirección de unidades. Audio, portapapeles, micrófono y varias pantallas dependen también del servidor.
  • Windows/macOS tienen visor y estado nativos. Linux necesita servicios de pantalla para ventanas, audio para sonido y Secret Service para credenciales guardadas; sin escritorio siguen disponibles las operaciones CLI admitidas.
  • La escritura Unicode se envía con pausas de compatibilidad. Ajusta el tiempo de espera para textos largos y verifica el resultado; ningún visor garantiza todos los caracteres en todos los servidores.
  • Se requiere Android 12 o posterior; el teléfono probado es Pixel 3 con Android 12. Pegar texto modifica explícitamente el portapapeles del teléfono. El sonido de reproducción requiere consentimiento del sistema y respeta las restricciones de captura de cada aplicación; el micrófono es otra fuente. Conectar o reconectar no inicia la grabación automáticamente.
  • Para Compartir pantalla de macOS, indica la cuenta del Mac con --user y su contraseña. Se selecciona ARD automáticamente, o con --vnc-security ard. Una contraseña VNC independiente requiere --vnc-security vnc-auth sin --user. ARD no cifra el flujo del escritorio; utiliza una red de confianza o una VPN.

Recuperación de errores

OBSERVATION_REQUIRED / INVALID_COORDINATES
Captura de nuevo y comprueba pantallas y coordenadas.
SESSION_PAUSED / CONTROL_HELD_BY_HUMAN
Detén la entrada y espera a que una persona devuelva el control al Agent.
AUTH_FAILED / VNC_AUTH_FAILED
Comprueba cuenta, fuente de contraseña y política remota.
RDP_TLS_HANDSHAKE_FAILED / CERTIFICATE_UNTRUSTED
RDP_TLS_HANDSHAKE_FAILED: revisa el perfil y la criptografía del servidor; no demuestra una versión TLS antigua ni una contraseña incorrecta. Para un destino antiguo conocido, repite connect una vez con --tls-profile legacy y un nuevo ID. CERTIFICATE_UNTRUSTED: verifica confianza, nombre y huella real del certificado; cambiar el perfil TLS no resuelve la confianza.
CAPABILITY_UNAVAILABLE / CLIPBOARD_ENCODING_UNSUPPORTED
Consulta capacidades o codificación y elige una operación compatible.
REQUEST_TIMEOUT / REQUEST_ID_CONFLICT / REQUEST_WINDOW_EXPIRED
Consulta operación y pantalla antes de reintentar; no reutilices IDs con otros argumentos ni tras expirar su retención.