DOKUMENTATION · KOMMANDOZEILE

Die vvdesk-Kommandozeile

vvdesk.exe steuert das VVDesk, das auf Ihrem PC läuft: dasselbe Konto, dasselbe Adressbuch, dieselben Regeln. Nutzen Sie sie aus Skripten, RMM-Tools und KI-Assistenten.

Bevor Sie beginnen

Wo sie liegt

vvdesk.exe wird mit VVDesk für Windows installiert, neben der App in %LocalAppData%\VVDesk\current. Fügen Sie diesen Ordner zum PATH hinzu oder rufen Sie sie mit vollständigem Pfad auf.

VVDesk muss laufen

Die Kommandozeile spricht mit dem VVDesk, das für Ihren Windows-Benutzer läuft, über einen privaten Kanal auf diesem PC. Über das Netz geht nichts, was die App nicht selbst senden würde.

Rechner-IDs

Eine 9-stellige ID darf mit oder ohne Leerzeichen geschrieben werden (615 220 937 oder 615220937). Ist nur eine Sitzung offen, können Sie die ID weglassen.

Dieser PC

status

Das VVDesk dieses PCs: seine eigene ID, der Server, die Version und die offenen Sitzungen.

vvdesk status

desks

Das Adressbuch, mit ID und Namen jedes Rechners und ob er online ist.

vvdesk desks [--filter online]

sessions

Die gerade offenen Fernsitzungen und ihr Zustand.

vvdesk sessions

log

Die letzten Zeilen des Aktivitätsprotokolls dieses VVDesk.

vvdesk log [--lines 40]

show

Holt das VVDesk-Fenster nach vorn.

vvdesk show

Sitzungen, Bildschirm und Eingabe

connect

Öffnet eine Sitzung zu einem Rechner und wartet, bis sie aktiv ist. --control bittet um Steuerung; --hidden verbindet im Hintergrund ohne Tab (die Sitzung erscheint trotzdem unter Sitzungen und im Protokoll).

vvdesk connect <id> [--control] [--hidden] [--wait 25000]

screenshot

Speichert ein frisches Bild des Bildschirms. Funktioniert auch in verborgenen Sitzungen und im Hintergrund.

vvdesk screenshot [<id>] [out.png] [--scale 0.5] [--wait 15000]

input

Steuert den Rechner mit Maus und Tastatur. x und y sind Anteile des Bildschirms, von 0 bis 1, gemessen von oben links.

vvdesk input [<id>] --action <action> [options]

Eingabeaktionen

--action move --x 0.5 --y 0.5
Bewegt den Mauszeiger.
--action click|double|right [--x 0.5 --y 0.5]
Linksklick, Doppelklick oder Rechtsklick — wo der Zeiger steht oder bei x, y.
--action scroll --delta 120
Scrollen; 120 ist eine Raste nach oben, -120 eine nach unten.
--action text --text "hello"
Tippt einen Text.
--action key --key enter [--dir tap|down|up]
Drückt eine Taste oder hält sie gedrückt und lässt sie los.
--action combo --keys ctrl+alt+del
Drückt eine Kombination wie ctrl+c, win+r oder ctrl+alt+del.

disconnect

Schließt eine Sitzung oder alle.

vvdesk disconnect [<id>] | --all

Befehle, Diagnose und Protokolle

exec

Führt einen Befehl auf dem Rechner aus und gibt die Ausgabe aus. Der Rechner führt ihn nur aus, wenn sein Besitzer Fernbefehle eingeschaltet hat; er wird am Rechner angezeigt und protokolliert.

vvdesk exec [<id>] --cmd "…" [--shell powershell] [--script file.ps1] [--wait 30000]

diagnostics

Führt die Diagnose des Rechners aus: Netzwerk, Routen und seine öffentliche Adresse.

vvdesk diagnostics [<id>] [--full]

logs

Sammelt die VVDesk-Protokolle des Rechners in einem Zip auf diesem PC.

vvdesk logs [<id>] [--days 2]

maintenance

Startet VVDesk auf dem Rechner neu oder zeigt ein Testbild, um den Bildweg zu prüfen.

vvdesk maintenance [<id>] --action restart|testpicture [--seconds 30]

Tunnel

tunnel

Die dauerhaften Tunnel dieses PCs: auflisten, einen hinzufügen und auf seine öffentliche Adresse warten, entfernen oder ein- und ausschalten.

vvdesk tunnel list
vvdesk tunnel add --port 8080 [--tcp|--https] [--host 127.0.0.1] [--name shop]
vvdesk tunnel remove --id <id> | --port 8080
vvdesk tunnel enable --id <id> | --port 8080 [--off]

Von der Firma verwaltete PCs

policy

PolicyGuard auf einem von der Firma verwalteten PC: Status, ein oder aus, Audit oder Durchsetzen. Sie müssen einer der Firmen-Admins dieses PCs sein.

vvdesk policy status|on|off|audit|enforce --id <desk>

settings

Liest oder ändert die VVDesk-Einstellungen eines von der Firma verwalteten PCs, wie das Fenster „Verwalten“. Die Person am PC wird informiert.

vvdesk settings <id> get
vvdesk settings <id> set --allow-remote-commands on --auto-update on

KI-Assistenten

vvdesk mcp macht aus den Befehlen oben Werkzeuge des Model Context Protocol. Jedes Werkzeug ist ein Befehl mit denselben Argumenten, und Screenshots kommen als Bilder zurück, die der Assistent ansehen kann.

mcp

Stellt diese Befehle einem KI-Assistenten als MCP-Werkzeuge über stdin und stdout bereit. Die Regeln der Rechner gelten weiterhin.

vvdesk mcp

Nächstes UpdateDer MCP-Server (vvdesk mcp) kommt mit dem nächsten VVDesk-Update. Die vvdesk-Kommandozeile funktioniert schon heute.

Claude Code
claude mcp add vvdesk -- vvdesk mcp
Claude Desktop und andere MCP-Clients
{
  "mcpServers": {
    "vvdesk": {
      "command": "C:\\Users\\you\\AppData\\Local\\VVDesk\\current\\vvdesk.exe",
      "args": ["mcp"]
    }
  }
}

vvdesk.exe liegt im VVDesk-Ordner, %LocalAppData%\VVDesk\current. Verwenden Sie den vollständigen Pfad, wenn dieser Ordner nicht im PATH ist.

Werkzeuge

Was ein Assistent mit VVDesk tun kann →

Optionen für jeden Befehl

--json
Gibt die rohe JSON-Antwort aus, für Skripte.
--timeout 200000
Wie lange auf die Antwort gewartet wird, in Millisekunden (Standard 200000).
--machine NAME
Mit einem VVDesk sprechen, das unter einer anderen Rechner-Identität läuft (Standard: der Name dieses PCs).

Exit-Codes

0
Erledigt.
1
Der Befehl ist fehlgeschlagen — der Grund steht auf stderr.
3
VVDesk läuft für diesen Benutzer nicht.
4
VVDesk hat nicht rechtzeitig geantwortet.

Beispiel: den Drucker einer Kasse prüfen

Eine verborgene Sitzung öffnen, den Bildschirm ansehen, Windows nach der Druckwarteschlange fragen und die Sitzung wieder schließen.

vvdesk connect "615 220 937" --hidden
vvdesk screenshot 615220937 till.png --scale 0.5
vvdesk exec 615220937 --shell powershell --cmd "Get-Service Spooler; Get-PrintJob -PrinterName Receipt"
vvdesk disconnect 615220937