ДОКУМЕНТАЦИЈА · КОМАНДНА ЛИНИЈА

Командната линија vvdesk

vvdesk.exe го управува VVDesk што работи на вашиот компјутер: истата сметка, истиот адресар, истите правила. Користете ја од скрипти, RMM-алатки и AI-асистенти.

Пред да почнете

Каде е

vvdesk.exe се инсталира со VVDesk за Windows, до апликацијата во %LocalAppData%\VVDesk\current. Додајте ја таа папка во PATH или повикајте ја со целата патека.

VVDesk мора да работи

Командната линија зборува со VVDesk што работи за вашиот корисник на Windows, преку приватен канал на овој компјутер. Ништо не оди на мрежата што апликацијата не би го пратила сама.

ID на компјутери

9-цифрен ID може да се напише со или без празни места (615 220 937 или 615220937). Кога е отворена само една сесија, ID-то може да се изостави.

Овој компјутер

status

VVDesk на овој компјутер: неговиот ID, серверот, верзијата и отворените сесии.

vvdesk status

desks

Адресарот, со ID-то и името на секој компјутер и дали е онлајн.

vvdesk desks [--filter online]

sessions

Далечинските сесии отворени во моментов и нивната состојба.

vvdesk sessions

log

Последните редови од дневникот за активности на овој VVDesk.

vvdesk log [--lines 40]

show

Го носи прозорецот на VVDesk напред.

vvdesk show

Сесии, екран и внес

connect

Отвора сесија со компјутер и чека додека не стане активна. --control бара контрола; --hidden се поврзува во позадина без да отвора јазиче (сепак се појавува во Сесии и во дневникот).

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

screenshot

Зачувува свежа слика од екранот на компјутерот. Работи и на скриени сесии и сесии во позадина.

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

input

Го управува компјутерот со глушецот и тастатурата. x и y се делови од екранот, од 0 до 1, мерено од горниот лев агол.

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

Дејства за внес

--action move --x 0.5 --y 0.5
Го поместува покажувачот.
--action click|double|right [--x 0.5 --y 0.5]
Лев клик, двоен клик или десен клик — каде што е покажувачот, или на x, y.
--action scroll --delta 120
Лизгање; 120 е еден чекор нагоре, -120 еден чекор надолу.
--action text --text "hello"
Пишува текст.
--action key --key enter [--dir tap|down|up]
Притиска копче, или го држи и го пушта.
--action combo --keys ctrl+alt+del
Притиска комбинација, како ctrl+c, win+r или ctrl+alt+del.

disconnect

Затвора една сесија или сите.

vvdesk disconnect [<id>] | --all

Команди, дијагностика и дневници

exec

Извршува команда на компјутерот и го печати резултатот. Компјутерот ја извршува само ако сопственикот ги вклучил далечинските команди; се прикажува на компјутерот и се ревидира.

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

diagnostics

Ја извршува дијагностиката на компјутерот: мрежа, рути и неговата јавна адреса.

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

logs

Ги собира дневниците на VVDesk од компјутерот во zip на овој компјутер.

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

maintenance

Го рестартира VVDesk на компјутерот или прикажува пробна слика за проверка на патот на екранот.

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

Тунели

tunnel

Трајните тунели на овој компјутер: прикажете ги, додадете еден и почекајте ја неговата јавна адреса, избришете, или вклучете и исклучете.

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]

Компјутери управувани од компанија

policy

PolicyGuard на компјутер управуван од компанија: состојба, вклучено или исклучено, ревизија или спроведување. Мора да сте еден од администраторите на тој компјутер.

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

settings

Ги чита или менува поставките на VVDesk на компјутер управуван од компанија, како прозорецот Управување. Лицето на компјутерот е известено.

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

AI-асистенти

vvdesk mcp ги претвора командите погоре во алатки на Model Context Protocol. Секоја алатка е една команда со истите аргументи, а сликите од екранот се враќаат како слики што асистентот може да ги погледне.

mcp

Ги нуди овие команди на AI-асистент како MCP-алатки преку stdin и stdout. Правилата на самите компјутери и понатаму важат.

vvdesk mcp

Следно ажурирањеMCP-серверот (vvdesk mcp) доаѓа со следното ажурирање на VVDesk. Командната линија vvdesk работи уште денес.

Claude Code
claude mcp add vvdesk -- vvdesk mcp
Claude Desktop и други MCP-клиенти
{
  "mcpServers": {
    "vvdesk": {
      "command": "C:\\Users\\you\\AppData\\Local\\VVDesk\\current\\vvdesk.exe",
      "args": ["mcp"]
    }
  }
}

vvdesk.exe е во папката на VVDesk, %LocalAppData%\VVDesk\current. Користете ја целата патека ако таа папка не е во PATH.

Алатки

Што може асистент да прави со VVDesk →

Опции за секоја команда

--json
Го печати необработениот JSON-одговор, за скрипти.
--timeout 200000
Колку да се чека одговорот, во милисекунди (стандардно 200000).
--machine NAME
Зборувајте со VVDesk што работи под друг идентитет на компјутер (стандардно: името на овој компјутер).

Излезни кодови

0
Готово.
1
Командата не успеа — причината е на stderr.
3
VVDesk не работи за овој корисник.
4
VVDesk не одговори навреме.

Пример: проверете го печатачот на каса

Отворете скриена сесија, погледнете го екранот, прашајте го Windows за услугата за печатење и повторно затворете ја сесијата.

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