Ziel dieser Anleitung

Übertragen Sie eine lokale Arbeitsmappe in eine RDP-Sitzung und holen Sie eine unveränderte Kopie zurück. Prüfen Sie den Übertragungsstatus und SHA-256; danach können Sie denselben Ablauf für Ergebnisse einer entfernten Anwendung verwenden. Die Schritte beruhen auf der Befehlsschnittstelle von rdp-cli 0.1.0 und dem am 21. September 2026 geprüften Dateiablauf. Sie sind eine Anleitung zur Wiederholung, kein neuer Testlauf.

Sitzung und Beispieldatei vorbereiten

Laden Sie die passende Ausgabe herunter und verbinden Sie sich nach der Schnellstartanleitung mit einem autorisierten Windows-RDP-Server. Speichern Sie data.session und ersetzen Sie SESSION. Der Server muss Laufwerksumleitung erlauben, und der Aufrufer benötigt Dateiberechtigungen. VNC bietet dieses Austauschlaufwerk nicht.

Jede Sitzung hat ein eigenes Austauschverzeichnis. --path ist relativ zu diesem Verzeichnis und kein beliebiger Windows-Pfad wie C:\Users\.... Die entfernte Anwendung sieht es als umgeleitetes Laufwerk. CLI-Dateioperationen erfordern weder einen Viewer noch die Übernahme von Tastatur und Maus.

Speichern Sie die Beispielarbeitsmappe im aktuellen lokalen Verzeichnis als service-activity.xlsx. Sie umfasst 4.489 Bytes mit zwölf Monaten fiktiver Servicedaten. Die Beispiele verwenden rdp-cli im PATH. Unter Windows ersetzen Sie dies im EXE-Verzeichnis durch .\rdp-cli.exe, unter Linux durch den installierten Befehl oder ./rdp-cli-linux-x86_64 / ./rdp-cli-linux-arm64.

rdp-cli status --session SESSION
rdp-cli files list --session SESSION

Prüfen Sie Verbindungszustand, ausgehandelte Fähigkeiten und Dateiliste. Ist der Dateizugriff nicht verfügbar, klären Sie zuerst Serverrichtlinien und Berechtigungen.

Hochladen und Abschluss abwarten

rdp-cli files upload --session SESSION --local ./service-activity.xlsx --path service-activity.xlsx

Ein angenommener Start kann data.state: queued und data.transfer_id zurückgeben. Speichern Sie diese ID als TRANSFER_ID. Die Annahme bedeutet noch keinen erfolgreichen Abschluss.

rdp-cli files status --session SESSION --transfer-id TRANSFER_ID

Lesen Sie in der Statusantwort data.state, vergleichen Sie data.bytes_transferred mit data.total_bytes und prüfen Sie den Hash der abgeschlossenen Datei unter data.files[].sha256.

Fragen Sie bis zu einem Endzustand erneut ab. Fahren Sie nur bei completed, den erwarteten 4.489 Bytes und geprüftem Hash fort. Danach kann die entfernte Anwendung die Mappe vom umgeleiteten Laufwerk dieser Sitzung öffnen. Ein sichtbarer Dateiname allein belegt keinen Abschluss.

Herunterladen und Bytes vergleichen

Lassen Sie die Arbeitsmappe beim ersten Durchlauf unverändert:

rdp-cli files download --session SESSION --path service-activity.xlsx --local ./service-activity-returned.xlsx

Der Download liefert eine eigene data.transfer_id. Verwenden Sie diese neue ID für files status. Nach completed liegt lokal service-activity-returned.xlsx vor. Unter macOS vergleichen Sie beide Dateien so:

shasum -a 256 ./service-activity.xlsx ./service-activity-returned.xlsx

Unter Linux:

sha256sum ./service-activity.xlsx ./service-activity-returned.xlsx

Unter Windows PowerShell:

Get-FileHash -Algorithm SHA256 .\service-activity.xlsx, .\service-activity-returned.xlsx

Beide Hashes sollten 1869e5708fe8922a99ff3efee1c0d285df3dd94588d59f5ad48f282db915df51 sein. Haben Sie die Mappe entfernt bearbeitet, ist keine Übereinstimmung mit dem Original zu erwarten. Speichern Sie das Ergebnis auf dem Austauschlaufwerk, laden Sie dessen Pfad herunter und prüfen Sie den Inhalt.

Einen ganzen Ordner übertragen

Legen Sie lokal einen Ordner source-folder mit den gewünschten Dateien an:

rdp-cli files upload --session SESSION --local ./source-folder --path source-folder

Warten Sie auf den Abschluss dieses Uploads, bevor Sie herunterladen:

rdp-cli files download --session SESSION --path source-folder --local ./received-folder

Prüfen Sie jede Übertragung separat. Struktur und leere Verzeichnisse bleiben erhalten; ./received-folder ist das genaue Zielwurzelverzeichnis. Verzeichnisübertragungen schließen Dateien einzeln ab. Bei partial oder Abbruch können bereits fertige Dateien zurückbleiben; der ganze Verzeichnisbaum ist keine einzelne atomare Transaktion.

Unklare Übertragungen sicher fortsetzen

  • Ziel existiert bereits: Wählen Sie einen anderen Pfad oder ergänzen Sie --overwrite, wenn Sie gezielt ersetzen möchten. Standardmäßig wird nicht überschrieben.
  • FILE_BUSY: Lassen Sie die entfernte Anwendung speichern oder exportieren und prüfen Sie Datei und Status vor einem erneuten Versuch.
  • Startantwort fehlt: Mit rdp-cli files status --session SESSION sehen Sie bekannte Übertragungen. Wiederholen Sie einen Upload oder ein Überschreiben mit unbekanntem Ergebnis nicht sofort.
  • failed, partial oder cancelled: Prüfen Sie Einzeldateiergebnisse und Ursache. Fertige Dateien können bestehen bleiben. Verbindungsabbruch oder verlorene Dateirechte können den Vorgang stoppen. Eine neue Verbindung startet ihn nicht stillschweigend erneut.
  • Ungültiger Pfad: Verwenden Sie austauschrelative Pfade mit /. Absolute Pfade, .., unsichere Links und kollidierende Namen werden abgewiesen.

Beenden Sie eine bekannte Übertragung mit ihrer tatsächlichen ID und prüfen Sie danach den Zustand:

rdp-cli files cancel --session SESSION --transfer-id TRANSFER_ID

Eine Pause der Desktopeingabe bricht Dateiübertragungen nicht ab. completed bestätigt kopierte Bytes, nicht die inhaltliche Richtigkeit eines Berichts.

Mit einem geprüften Ergebnis fortfahren

Das LibreOffice-Calc-Beispiel verwendet denselben Ablauf aus Upload, entfernter Bearbeitung und Download. Es enthält den tatsächlich gespeicherten Bericht, den Original-Screenshot, Formeln und geprüfte Summen. Beachten Sie die Dateifunktionen und Protokollgrenzen, bevor Sie den Ablauf auf andere Umgebungen übertragen.