Mit der tatsächlichen Antwort beginnen

Diese Anleitung behandelt die RDP-Schnittstelle von rdp-cli 0.1.0 unter Windows, macOS und Linux. Grundlage sind vorhandene Verbindungs- und Agent-Prüfungen vom September 2026, keine neuen Servertests. Verwenden Sie einen autorisierten Windows-RDP-Server und die aktuelle Ausgabe für Ihren Client. Beispiele nutzen rdp-cli im PATH; unter Windows verwenden Sie .\rdp-cli.exe im Programmordner, unter Linux den installierten Befehl oder die heruntergeladene Datei.

rdp-cli --version
rdp-cli list
rdp-cli status --session SESSION

Ersetzen Sie SESSION durch Ihre zurückgegebene Sitzungs-ID. Lesen Sie bei Fehlern error.code, error.message und error.retryable. Prüfen Sie im erfolgreichen Status data.connection_state, data.control_state, gegebenenfalls data.last_error und data.capabilities. Ein Wiederholbarkeitshinweis erlaubt nicht automatisch das erneute Senden von Eingaben.

Die Verbindung schrittweise prüfen

Fehler Prüfung und Maßnahme
CONNECT_TIMEOUT / RDP_CONNECT_FAILED Host, eingestellten Port (üblicherweise 3389), LAN/VPN-Verbindung und laufenden RDP-Dienst prüfen. Der Administrator sollte Listener und erlaubte Firewall-Regel kontrollieren. Ein erreichbarer Port beweist keine erfolgreiche RDP-Anmeldung. Nach der Korrektur einmal erneut versuchen.
RDP_TLS_HANDSHAKE_FAILED TLS-Konfiguration des Servers prüfen. Das Standardprofil modern benötigt TLS 1.2. --tls-profile legacy nur für einen identifizierten Altserver in einem vertrauenswürdigen Netz verwenden; es erlaubt ältere Kryptografie. Nicht pauschal anwenden oder Serversicherheit für einen Test abschalten.
CERTIFICATE_UNTRUSTED Bei --cert-policy strict Servername und Zertifikatskette prüfen oder den SHA-256-Fingerabdruck vor einem gezielten Vertrauenseintrag mit dem Administrator abgleichen. Der aktuelle Standard ignore prüft die Identität nicht. Nicht nur zum Unterdrücken eines strict-Fehlers umschalten.
AUTH_FAILED Benutzername, lokales/Domänenkonto, --domain und Remoteanmelderecht prüfen. Passwortabfrage oder gespeicherten Verweis aus dem Schnellstart nutzen. Keine Passwortserien ausprobieren: TLS-Fehler und Nichterreichbarkeit beweisen kein falsches Passwort.

Verbunden, aber ohne nutzbares Bild

Führen Sie diese reine Abfrage aus und öffnen Sie das PNG aus data.path. connected bedeutet, dass RDP aktiviert wurde und ein konsistentes Bild vorliegt. Es kann Anmeldung, Willkommen oder Schwarz zeigen; der Desktop muss noch nicht bereit sein.

rdp-cli screenshot --session SESSION

Bei FRAME_UNAVAILABLE Status und error.retryable prüfen, Wiederverbindung oder Bildschirmwechsel abwarten und erneut aufnehmen. Bleibt ein vorhandenes Bild schwarz, Serverzustand, Client-Ruhezustand und VPN prüfen. Historische Fälle hatten verschiedene oder ungeklärte Ursachen. Keine Zugangsdaten in ein unsichtbares Ziel senden und nicht jedes unveränderte Bild als Protokollstillstand deuten.

Eingabe- und Rechtefehler beheben

  • OBSERVATION_REQUIRED: neues Bild aufnehmen und lesen; dessen data.observation für die nächste Aktion verwenden. Nach Wiederverbindung, Übernahme oder Bildschirmänderung erneuern.
  • SESSION_PAUSED, CONTROL_HELD_BY_HUMAN oder CONTROL_NOT_OWNED: Eingaben stoppen und den aktuellen Controller respektieren. Erst nach autorisierter Rückgabe fortsetzen und neu aufnehmen; die Pause nicht mit einem weiteren Viewer umgehen.
  • PERMISSION_DENIED / CAPABILITY_UNAVAILABLE: Fähigkeit und Zugriffsfreigabe prüfen. Ein Viewer aktiviert keine fehlende Serverfunktion. UNICODE_INPUT_UNAVAILABLE verlangt einen unterstützten Eingabeweg statt blinder Wiederholungen.

Ein ungewisses Ergebnis prüfen

Vor einer Eingabe, deren Ergebnis später geklärt werden muss, für jede eigene Aktion eine eindeutige --request-id festlegen und speichern; Beispiel-IDs durch eigene Werte ersetzen. Bei einer JSON-Fehlermeldung deren oberstes Feld request_id behalten; fehlt die Antwort vollständig und wurde die ursprüngliche ID nicht gespeichert, keine neue ID zur Abfrage der alten Aktion erfinden und nicht blind erneut senden.

Bei REQUEST_TIMEOUT oder SERVICE_UNAVAILABLE während einer Aktion die ursprüngliche Anfrage-ID behalten. Mit list den lokalen Dienst prüfen und vor einer Wiederholung die ursprüngliche Operation abfragen. Die Eingabe kann trotz verlorener Antwort gesendet worden sein.

rdp-cli operations status --session SESSION --request-id REQUEST_ID
rdp-cli status --session SESSION
rdp-cli screenshot --session SESSION

REQUEST_ID durch die ursprüngliche ID ersetzen, nicht durch die der Abfrage. data.state, gespeichertes data.result und ein neues Bild prüfen. OPERATION_NOT_FOUND kann abgelaufene Daten oder einen Dienstwechsel bedeuten; es beweist keine Nichtausführung. Nach Behebung der Ursache lässt ein ausdrückliches reconnect einer nicht geschlossenen Sitzung diese pausiert. SESSION_CLOSED erfordert eine neue autorisierte Verbindung, keine wiederholten Wiederverbindungsversuche.

Mit den passenden Belegen fortfahren

Falls ungelöst, Client-/Serverversion, Protokoll, Zeitpunkt, Fehlercode und bereinigten Status/Screenshot bereitstellen. Passwörter, Zugriffstoken und private Bildinhalte entfernen. Die Anleitung belegt weder Kompatibilität noch Langzeitstabilität aller Server.

Download · Schnellstart · Befehlsreferenz