rdp-cli

Premiers pas avec RDP en ligne de commande sur Windows, Mac et Linux

Connectez une fois, observez, agissez et vérifiez. Le visualiseur local est facultatif.

DEPUIS VOTRE ORDINATEUR

Choisissez votre plateforme.
Lancez votre prochaine tâche.

Choisissez le poste qui exécutera rdp-cli.
Préparez les outils distants de votre agent.

01 / INSTALLER ET VÉRIFIER

Préparez l’EXE et ouvrez PowerShell.

Choisissez x64 (64 bits) ou x86 (32 bits). Placez rdp-cli.exe dans un dossier et ouvrez PowerShell à cet endroit.

EXE signés pour x64 et x86, chacun en un seul fichier. Aucun environnement d’exécution supplémentaire requis.

PowerShell
.\rdp-cli.exe --help
2. Connecter le bureau

Activez RDP sur la cible. Remplacez 192.0.2.20 et USER. La saisie masquée transmet le mot de passe sur l’entrée standard. Conservez data.session de la réponse JSON.

PowerShell
$secret = Read-Host 'Mot de passe' -AsSecureString
$savedEncoding = $OutputEncoding
try {
  $OutputEncoding = [System.Text.UTF8Encoding]::new($false)
  [System.Net.NetworkCredential]::new('', $secret).Password |
    .\rdp-cli.exe connect --host 192.0.2.20 --user USER --password-stdin
} finally {
  $OutputEncoding = $savedEncoding
  $secret.Dispose()
}
3. Observer avant d’agir

Remplacez SESSION par le résultat de connexion. Ouvrez before.png, repérez la cible et conservez data.observation de la réponse.

PowerShell
.\rdp-cli.exe screenshot --session SESSION --out ./before.png
4. Agir puis vérifier

Repérez le champ dans l’image et remplacez X, Y et OBSERVATION. Refaites une capture après le clic et utilisez la nouvelle observation pour saisir. Vérifiez after.png.

PowerShell
.\rdp-cli.exe click --session SESSION --desktop --x X --y Y --observation OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out ./focused.png
.\rdp-cli.exe type --session SESSION --text "Tâche distante terminée." --observation NEW_OBSERVATION
.\rdp-cli.exe screenshot --session SESSION --out ./after.png
5. Inviter quelqu’un à observer

Ouvrez la session existante lorsqu’une personne souhaite regarder. Les visualiseurs démarrent en lecture seule. Suspendez, prenez puis rendez le contrôle. Après un transfert ou une reconnexion, l’agent doit obtenir une nouvelle observation.

PowerShell
.\rdp-cli.exe watch --session SESSION --viewer window
.\rdp-cli.exe watch --session SESSION --viewer web
01 / INSTALLER ET VÉRIFIER

Ouvrez le DMG et activez la CLI.

Glissez rdp-cli dans Applications, puis exécutez ces commandes dans le Terminal macOS (zsh).

Choisissez le DMG adapté à votre Mac : Apple silicon (macOS 13 ou version ultérieure) ou Intel (macOS 12 ou version ultérieure). Consultez la disponibilité sur la page de téléchargement.

zsh
/Applications/rdp-cli.app/Contents/MacOS/rdp-cli install-cli
rdp-cli --help
2. Connecter le bureau

Activez RDP sur la cible. Remplacez 192.0.2.20 et USER. La saisie masquée transmet le mot de passe sur l’entrée standard. Conservez data.session de la réponse JSON.

zsh
read -r -s "rdp_password?Mot de passe: "
printf '\n'
printf '%s' "$rdp_password" | rdp-cli connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
3. Observer avant d’agir

Remplacez SESSION par le résultat de connexion. Ouvrez before.png, repérez la cible et conservez data.observation de la réponse.

zsh
rdp-cli screenshot --session SESSION --out ./before.png
4. Agir puis vérifier

Repérez le champ dans l’image et remplacez X, Y et OBSERVATION. Refaites une capture après le clic et utilisez la nouvelle observation pour saisir. Vérifiez after.png.

zsh
rdp-cli click --session SESSION --desktop --x X --y Y --observation OBSERVATION
rdp-cli screenshot --session SESSION --out ./focused.png
rdp-cli type --session SESSION --text "Tâche distante terminée." --observation NEW_OBSERVATION
rdp-cli screenshot --session SESSION --out ./after.png
5. Inviter quelqu’un à observer

Ouvrez la session existante lorsqu’une personne souhaite regarder. Les visualiseurs démarrent en lecture seule. Suspendez, prenez puis rendez le contrôle. Après un transfert ou une reconnexion, l’agent doit obtenir une nouvelle observation.

zsh
rdp-cli watch --session SESSION --viewer window
rdp-cli watch --session SESSION --viewer web
01 / INSTALLER ET VÉRIFIER

Un fichier à exécuter

Téléchargez le fichier Linux x86_64, accordez-lui le droit d’exécution et lancez-le dans le terminal. Aucun droit administrateur n’est nécessaire.

Le même ELF statique pour les systèmes x86_64 indiqués. Les autres versions et architectures de processeur sont hors du périmètre de cette version.

Bash
chmod u+x ./rdp-cli-linux-x86_64
./rdp-cli-linux-x86_64 --help
2. Connecter le bureau

Activez RDP sur la cible. Remplacez 192.0.2.20 et USER. La saisie masquée transmet le mot de passe sur l’entrée standard. Conservez data.session de la réponse JSON.

Bash
IFS= read -r -s -p 'Mot de passe: ' rdp_password
printf '\n'
printf '%s' "$rdp_password" | ./rdp-cli-linux-x86_64 connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
3. Observer avant d’agir

Remplacez SESSION par le résultat de connexion. Ouvrez before.png, repérez la cible et conservez data.observation de la réponse.

Bash
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./before.png
4. Agir puis vérifier

Repérez le champ dans l’image et remplacez X, Y et OBSERVATION. Refaites une capture après le clic et utilisez la nouvelle observation pour saisir. Vérifiez after.png.

Bash
./rdp-cli-linux-x86_64 click --session SESSION --desktop --x X --y Y --observation OBSERVATION
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./focused.png
./rdp-cli-linux-x86_64 type --session SESSION --text "Tâche distante terminée." --observation NEW_OBSERVATION
./rdp-cli-linux-x86_64 screenshot --session SESSION --out ./after.png
5. Inviter quelqu’un à observer

Ouvrez la session existante lorsqu’une personne souhaite regarder. Les visualiseurs démarrent en lecture seule. Suspendez, prenez puis rendez le contrôle. Après un transfert ou une reconnexion, l’agent doit obtenir une nouvelle observation.

Bash
./rdp-cli-linux-x86_64 watch --session SESSION --viewer window
./rdp-cli-linux-x86_64 watch --session SESSION --viewer web
01 / INSTALLER ET VÉRIFIER

Un fichier à exécuter

Téléchargez le fichier Linux ARM64 pour un système Linux ARM 64 bits, accordez-lui le droit d’exécution et lancez-le avec votre compte habituel.

Un même fichier ELF statique ARM64 pour les systèmes Linux indiqués, Raspberry Pi 4 et DGX Spark. Raspberry Pi OS 32 bits n’est pas pris en charge.

Bash
chmod u+x ./rdp-cli-linux-arm64
./rdp-cli-linux-arm64 --help
2. Connecter le bureau

Activez RDP sur la cible. Remplacez 192.0.2.20 et USER. La saisie masquée transmet le mot de passe sur l’entrée standard. Conservez data.session de la réponse JSON.

Bash
IFS= read -r -s -p 'Mot de passe: ' rdp_password
printf '\n'
printf '%s' "$rdp_password" | ./rdp-cli-linux-arm64 connect --host 192.0.2.20 --user USER --password-stdin
unset rdp_password
3. Observer avant d’agir

Remplacez SESSION par le résultat de connexion. Ouvrez before.png, repérez la cible et conservez data.observation de la réponse.

Bash
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./before.png
4. Agir puis vérifier

Repérez le champ dans l’image et remplacez X, Y et OBSERVATION. Refaites une capture après le clic et utilisez la nouvelle observation pour saisir. Vérifiez after.png.

Bash
./rdp-cli-linux-arm64 click --session SESSION --desktop --x X --y Y --observation OBSERVATION
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./focused.png
./rdp-cli-linux-arm64 type --session SESSION --text "Tâche distante terminée." --observation NEW_OBSERVATION
./rdp-cli-linux-arm64 screenshot --session SESSION --out ./after.png
5. Inviter quelqu’un à observer

Ouvrez la session existante lorsqu’une personne souhaite regarder. Les visualiseurs démarrent en lecture seule. Suspendez, prenez puis rendez le contrôle. Après un transfert ou une reconnexion, l’agent doit obtenir une nouvelle observation.

Bash
./rdp-cli-linux-arm64 watch --session SESSION --viewer window
./rdp-cli-linux-arm64 watch --session SESSION --viewer web

Remplacez l’adresse et les valeurs d’exemple. Utilisez session et observation des réponses réelles, puis une nouvelle capture pour vérifier le résultat.

Travailler avec votre agent

Indiquez l’exécutable, la cible autorisée ou la session et le résultat souhaité. La compétence facultative rdp-cli-agent décrit le parcours ; l’agent peut lire SKILL.md directement. Elle n’est pas nécessaire à la connexion.

rdp-cli-agent / SKILL.md ↓

Connexion et accès

La politique de certificat RDP est ignore par compatibilité. Consultez connect --help et adaptez la validation. Le site ne relaie pas les sessions et ne collecte pas leurs identifiants. Le visualiseur web vise LAN/VPN ; VNC nécessite un réseau de confiance.

rdp-cli@weerocks.com