Avant la connexion
Il faut un Windows dont le service RDP est activé, un compte autorisé à ouvrir une session distante et un chemin réseau depuis le Mac. Installer le client n’active pas le service Windows. Utilisez votre réseau local ou VPN si le serveur n’est pas public.
Choisissez le paquet adapté à votre Mac sur la page de téléchargement : Apple silicon nécessite macOS 13 ou ultérieur, et Intel, macOS 12 ou ultérieur. Consultez cette page pour connaître la disponibilité. Téléchargez le DMG correspondant, ouvrez-le et glissez rdp-cli dans Applications. Activez la CLI ci-dessous. Si la commande est introuvable, ouvrez un nouveau terminal ou utilisez le chemin complet. Le DMG contient aussi un exécutable autonome.
/Applications/rdp-cli.app/Contents/MacOS/rdp-cli install-cli
rdp-cli --help
Créer une session
Remplacez l’adresse d’exemple et USER par votre serveur et votre compte autorisés. Collez ce bloc dans le Terminal de macOS (zsh), saisissez votre mot de passe à l’invite et appuyez sur Entrée. Le mot de passe n’est pas affiché ; le bloc le transmet à rdp-cli et termine automatiquement l’entrée.
Pour un domaine, ajoutez --domain DOMAIN. Une référence enregistrée peut remplacer le mot de passe avec --credential-ref CREDENTIAL ; ne combinez pas les sources. Consultez connect --help pour les certificats : la valeur RDP initiale est ignore. Lisez l’état JSON et conservez data.session. Une connexion établie peut encore afficher l’écran de bienvenue.
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
Voir le véritable bureau
Remplacez SESSION par la valeur renvoyée et ouvrez first-screen.png. Conservez aussi data.observation de cette réponse pour les entrées fondées sur cette image. Ce jeton n’est ni un mot de passe permanent ni un identifiant de session. Reconnexion, changement de contrôle ou de disposition des écrans peuvent l’invalider.
rdp-cli screenshot --session SESSION --out first-screen.png
Ouvrir une fenêtre au besoin
La connexion ne nécessite pas de fenêtre locale. Ouvrez la session existante pour suivre le travail. Le visualiseur démarre en lecture seule, avec pause et prise de contrôle. Fermer une fenêtre d’observation conserve la connexion ; fermer celle qui contrôle suspend les entrées.
rdp-cli watch --session SESSION --viewer window
En cas d’échec
Vérifiez adresse, réseau, service RDP et autorisations. Lisez l’erreur structurée au lieu de renvoyer le mot de passe à répétition. Un ancien serveur peut nécessiter un réglage de compatibilité explicite, sans l’appliquer aux autres sessions. Pour une session existante, consultez rdp-cli status --session SESSION avant de répéter une action.
Pour continuer
- Confier une tâche distante à un agent par commandes
- Observer, suspendre et reprendre la même session
- Bien démarrer
Commencer sur votre bureau distant
Télécharger rdp-cli · Suivre le démarrage rapide de votre plateforme