Référence des commandes rdp-cli

Observer, agir, vérifier

USER, SESSION, OBSERVATION, X et Y sont des valeurs à remplacer. Envoyez le mot de passe sur stdin, puis fermez le flux ; --password-stdin ne propose pas de saisie interactive. Conservez data.session, lisez before.png, choisissez ses coordonnées puis vérifiez after.png. Une entrée envoyée ne prouve pas la réussite de la tâche.

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 indique la version et les capacités ; --help-json fournit le catalogue structuré ; COMMAND --help décrit les options sans démarrer de session.

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

JSON et options communes

Une commande normale renvoie un objet JSON UTF-8 sur stdout : ok: true avec data, ou ok: false avec error. stderr contient les diagnostics. Codes de sortie : 0 réussite, 1 échec opérationnel, 2 arguments incorrects.

L’aide est du texte. events --follow diffuse du NDJSON ; events sans suivi renvoie un résultat JSON contenant data.events et data.ndjson. Dans PowerShell 5.1, réglez [Console]::OutputEncoding et $OutputEncoding sur UTF-8 pour les caractères non ASCII.

data.session

Conservez l’identifiant renvoyé par connect.

data.observation

Utilisez le jeton de capture ; renouvelez-le après reconnexion, changement de contrôle ou de disposition.

data.capabilities

Vérifiez les capacités négociées avant les opérations sur fichiers, audio, presse-papiers ou écrans.

data.state / data.remote_outcome

queued, sent, partial, unknown, cancelled et failed indiquent la progression. remote_outcome: not_confirmed exige une vérification du résultat.

data.transfer_id

Utilisez cet ID avec files status ou files cancel ; attendez l’état final et vérifiez les empreintes des fichiers terminés.

error.code / error.message / error.retryable

Décidez selon le code stable. Le message et retryable donnent du contexte, sans autoriser une répétition aveugle.

Toutes les commandes acceptent --request-id et --timeout-ms. Réutilisez un ID seulement avec une commande et des arguments identiques dans la durée de conservation. Un délai dépassé ne prouve pas l’absence d’envoi : interrogez operations status.

Conditions de protocole et de plateforme

• RDP utilise --cert-policy ignore et --tls-profile modern. strict vérifie confiance et nom ; legacy autorise explicitement un ancien TLS. La validation HTTPS web reste inchangée.
• VNC refuse --user, --domain, --size, --layout, --cert-policy et --tls-profile. L’authentification classique emploie huit octets UTF-8 du mot de passe. Sans authentification : --vnc-security none, sans mot de passe. Les transports VNC pris en charge ne sont pas chiffrés.
• VNC ne fournit ni fichiers, son, microphone ni changement actif de disposition. Le presse-papiers UTF-8 nécessite une négociation ; sinon, seul Latin-1 est accepté.
• Les fichiers RDP nécessitent la redirection de disque. Audio, presse-papiers, microphone et écrans multiples dépendent aussi du serveur.
• Windows/macOS disposent de vues et d’un état natifs. Linux nécessite les services d’affichage/audio et Secret Service pour conserver les identifiants. Sans bureau, les opérations CLI compatibles restent disponibles.
• La saisie Unicode est temporisée pour les applications distantes. Adaptez le délai aux textes longs et vérifiez ; aucun observateur ne garantit tous les caractères sur tous les serveurs.

Reprise après erreur

OBSERVATION_REQUIRED / INVALID_COORDINATES

Refaites une capture et contrôlez écrans et coordonnées.

SESSION_PAUSED / CONTROL_HELD_BY_HUMAN

Arrêtez la saisie et attendez la restitution explicite à l’Agent.

AUTH_FAILED / VNC_AUTH_FAILED

Vérifiez compte, source du mot de passe et stratégie distante.

RDP_TLS_HANDSHAKE_FAILED / CERTIFICATE_UNTRUSTED

Contrôlez TLS, certificat et empreinte ; une erreur TLS ne signifie pas un mauvais mot de passe.

CAPABILITY_UNAVAILABLE / CLIPBOARD_ENCODING_UNSUPPORTED

Vérifiez capacités ou encodage et choisissez une opération compatible.

REQUEST_TIMEOUT / REQUEST_ID_CONFLICT / REQUEST_WINDOW_EXPIRED

Consultez opération et écran avant de réessayer ; ne réutilisez pas un ID avec d’autres arguments ni après expiration.