Antes de conectar
Necesitas un Windows con RDP habilitado, una cuenta con permiso de inicio de sesión remoto y una ruta de red desde el Mac. Instalar el cliente no activa el servicio de Windows. Usa tu red local o VPN si el servidor no es público.
Elige el paquete para tu Mac en la página de descargas: Apple silicon requiere macOS 13 o posterior e Intel, macOS 12 o posterior. Consulta allí la disponibilidad. Descarga el DMG correspondiente, ábrelo y arrastra rdp-cli a Aplicaciones. Habilita la CLI con este comando. Si el terminal no encuentra rdp-cli, abre otro terminal o usa la ruta completa del ejecutable. El DMG también incluye un ejecutable independiente.
/Applications/rdp-cli.app/Contents/MacOS/rdp-cli install-cli
rdp-cli --help
Crea una sesión
Sustituye la dirección de ejemplo y USER por tu servidor y cuenta autorizados. Pega este bloque en Terminal de macOS (zsh), escribe la contraseña cuando se solicite y pulsa Intro. La contraseña no se muestra; el bloque la pasa a rdp-cli y finaliza la entrada automáticamente.
Para una cuenta de dominio, añade --domain DOMAIN. Si ya guardaste una credencial, puedes usar --credential-ref CREDENTIAL; no combines fuentes de contraseña. Consulta connect --help para configurar certificados: la política RDP actual es ignore por compatibilidad. Lee el JSON, comprueba su estado y guarda data.session. Una conexión establecida aún puede mostrar la pantalla de bienvenida.
read -r -s "rdp_password?Contraseña: "
printf '\n'
printf '%s' "$rdp_password" | rdp-cli connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
Mira el escritorio real
Sustituye SESSION por el valor devuelto y abre first-screen.png. Guarda también data.observation de esta respuesta. Este token se usa para las entradas basadas en esa imagen: no es una contraseña permanente ni un ID de sesión. Reconectar, cambiar el controlador o modificar las pantallas puede invalidarlo.
rdp-cli screenshot --session SESSION --out first-screen.png
Abre una ventana solo si quieres observar
La conexión no necesita una ventana local. Abre la sesión existente para seguir el trabajo del agente. El visor empieza en modo de solo lectura y ofrece pausa y toma de control. Cerrar una ventana de observación conserva la conexión; cerrar el visor que controla deja la entrada pausada.
rdp-cli watch --session SESSION --viewer window
Si no conecta
Revisa dirección, red, servicio RDP y permisos de la cuenta. Lee el error estructurado en lugar de enviar repetidamente la contraseña. Un servidor antiguo puede necesitar una opción de compatibilidad explícita; no la apliques a otras sesiones. Si la sesión ya existe, consulta rdp-cli status --session SESSION antes de repetir acciones.
Continúa con estas guías
- Completa una tarea remota con comandos del agente
- Observa, pausa y controla la misma sesión
- Primeros pasos