rdp-cli
RDP-Verbindung, schwarzen Bildschirm und gesperrte Eingaben untersuchen
Version und Plattform: 0.1.2 · Windows / macOS / Linux · RDP
Mit der tatsächlichen Antwort beginnen
Prüfen Sie RDP-Probleme schrittweise: Netzwerk, Verschlüsselung, Anmeldung, Bild und Eingabe. Wählen Sie anhand des Fehlercodes den nächsten Schritt, statt ständig Passwörter zu ändern oder neu zu verbinden.
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
Prüfen Sie bei FRAME_UNAVAILABLE den Status und error.retryable. Warten Sie, bis Wiederverbindung oder Bildschirmwechsel abgeschlossen sind, und erstellen Sie ein neues Bild. Bleibt es schwarz, prüfen Sie Server, Ruhezustand des Clients und VPN. Prüfen Sie das Bild, bevor Sie Zugangsdaten eingeben.
Eingabe- und Rechtefehler beheben
OBSERVATION_REQUIRED: neues Bild aufnehmen und lesen; dessendata.observationfür die nächste Aktion verwenden. Nach Wiederverbindung, Übernahme oder Bildschirmänderung erneuern.SESSION_PAUSED,CONTROL_HELD_BY_HUMANoderCONTROL_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_UNAVAILABLEverlangt 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.
Erweiterte Befehle in rdp-cli
Führe zuerst rdp-cli --version aus. Die folgenden Befehle setzen agent_execution.contract_version gleich 1 voraus. Ältere Builds können weiterhin den oben beschriebenen Ablauf mit einzelnen Schritten verwenden.
Ersetze Platzhalter in Großbuchstaben durch die zurückgegebenen Werte. Verwende in Windows PowerShell im Programmordner .\rdp-cli.exe; unter macOS und Linux den installierten Befehl oder den tatsächlichen Programmpfad.
Agenten anbinden und Verbindungen prüfen
Nutze die integrierte MCP-Schnittstelle oder die CLI. Speichere benannte Verbindungsprofile mit Verweisen auf Zugangsdaten und prüfe Verbindungsschichten mit doctor.
Dieses doctor-Beispiel liest vorhandene Belege und fordert keine aktive Prüfung an. Unknown oder not-run bedeuten keine bestandene Prüfung. Verbindungsprofile verwenden Zugangsdaten-Referenzen statt Passwörtern in Beispielen.
rdp-cli profiles list
rdp-cli doctor --session SESSION
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.