CLI
Używaj Zenovix CLI do raportów Pro tylko do odczytu.
Zenovix CLI to bezpieczny interfejs wiersza poleceń do analizy miejsca, raportowania, zaplanowanych skanów, skoroszytów Storage History Workbook i eksportów. Jest dostępny z Zenovix Pro i uzupełnia aplikację klasyczną, zamiast ją zastępować.
CLI Przegląd
Do czego służy Zenovix CLI
Używaj CLI do powtarzalnej analizy dysków Windows z wiersza poleceń, raportów w PowerShell, zaplanowanej analizy, analizy NAS, skanów ścieżek UNC, skoroszytów Storage History Workbook oraz eksportu plików do Excela, Power BI i innych narzędzi raportowych.
- Dostępne z Zenovix Pro.
- Uruchamia wyłącznie polecenia analizy i raportowania tylko do odczytu.
- Działa z folderami, dyskami, ścieżkami UNC, urządzeniami NAS i dyskami podłączanymi.
- Może zapisywać wyniki JSON, CSV, XLSX i skoroszyty Storage History Workbook.
- Można go używać z PowerShell, skryptów i Harmonogramu zadań Windows.
- Użytkownicy wersji bezpłatnej mogą uruchamiać
zenovix --help i zenovix --version.
SAFE Model bezpieczeństwa
CLI nigdy nie wykonuje czyszczenia
CLI jest celowo tylko do odczytu. Automatyzacja z wiersza poleceń przydaje się do analizy i raportów, ale czyszczenie pozostaje w aplikacji klasycznej, gdzie widoczne są stan przeglądu, wybór plików, podglądy odzyskiwania i rekordy odzyskiwania.
- Zenovix CLI nigdy nie usuwa plików.
- Zenovix CLI nigdy nie archiwizuje plików.
- Zenovix CLI nigdy nie przywraca plików.
- Zenovix CLI nigdy nie zmienia nazw plików.
- Zenovix CLI nigdy nie przenosi plików.
- Zenovix CLI nie czyści folderów ani nie wykonuje automatycznego czyszczenia.
- Destrukcyjne nazwy poleceń, takie jak
delete, archive, restore, cleanup, clean, remove, move, rename, empty-recycle-bin, dedupe i fix, są odrzucane. - Do czyszczenia po przeglądzie, archiwizacji, przywracania i Centrum odzyskiwania służy aplikacja klasyczna.
01 Instalacja
Użyj aliasu wykonywania aplikacji z Microsoft Store
Zainstaluj lub zaktualizuj Zenovix Storage Manager z Microsoft Store. Pakiet ze Sklepu zawiera alias wykonywania zenovix.exe, więc polecenie zenovix można uruchamiać z Terminala Windows, PowerShell, wiersza polecenia lub Harmonogramu zadań.
zenovix --help
zenovix --version
- Jeśli Windows nie znajduje polecenia
zenovix, sprawdź Ustawienia Windows > Aplikacje > Zaawansowane ustawienia aplikacji > Aliasy wykonywania aplikacji. - Jeśli nie można zweryfikować Pro, polecenia funkcjonalne bezpiecznie zakończą się przed skanowaniem, informując, że nie udało się zweryfikować Zenovix Pro.
- Stany licencji Bezpłatna i nieznana mogą wyświetlać pomoc i wersję, ale polecenia funkcjonalne wymagają Pro.
02 Użycie
Struktura wiersza poleceń
Ogólny format polecenia to:
zenovix <command> [arguments] [options]
- Opcje globalne:
--help, -h, --version, --quiet, --json i --log <file>. - Funkcjonalne polecenia Pro:
scan, compare, top, health, history i export. - Nazwy zarezerwowane, takie jak summary, growth, duplicates czy info, nie są dokumentowane jako polecenia publiczne, dopóki nie zostaną zaimplementowane.
03 scan
Uruchamiaj analizę miejsca z wiersza poleceń
zenovix scan <path> [<path> ...] [options]
scan wykonuje analizę miejsca na folderach, dyskach, ścieżkach UNC, urządzeniach NAS lub dyskach podłączanych. Używaj go do zaplanowanych raportów, skoroszytów historii i eksportów.
- Opcje obejmują
--fast, --analysis, --history <file.xlsx>, --output <folder>, --json, --csv, --xlsx, --top-folders <n>, --include <pattern>, --exclude <pattern>, --recursive true|false, --quiet i --log <file>.
zenovix scan D:\Photos
zenovix scan "\\server\Finance" --analysis --history "Storage History.xlsx"
zenovix scan D:\Data --json
zenovix scan D:\Data --xlsx --output "C:\Reports" --top-folders 25
04 Raportowanie
Porównuj, sortuj i eksportuj przeskanowane dane
zenovix compare --history <file.xlsx> [options]
zenovix top folders|files|extensions <path> [options]
zenovix top folders|extensions --history <file.xlsx> [options]
zenovix export --history <file.xlsx> [--json] [--csv] [--xlsx] [--output <folder>]
compare porównuje najnowszy skan z poprzednim w skoroszycie Storage History Workbook.top pokazuje największe foldery, pliki lub rozszerzenia ze ścieżki albo skoroszytu.export eksportuje najnowszy skan zapisany w skoroszycie Storage History Workbook.- Używaj
--count <n>, --json, --quiet i --log <file> tam, gdzie są obsługiwane.
05 Skoroszyt historii
Prowadź historię miejsca bez usuwania starych danych
zenovix history info [--history <file.xlsx>] [--json]
zenovix history validate [--history <file.xlsx>] [--json]
zenovix history init [--history <file.xlsx>]
zenovix history repair [--history <file.xlsx>]
- Skoroszyty Storage History Workbook to pliki XLSX do powtarzanej w czasie analizy miejsca.
- Skoroszyt można otwierać w narzędziach zgodnych z Excelem i analizować w Power BI.
- Zenovix CLI może tworzyć skoroszyty i dopisywać do nich dane bez zainstalowanego Microsoft Excel.
history repair porządkuje strukturę skoroszytu bez usuwania ani nadpisywania historycznych danych skanów.
06 Health
Sprawdzaj gotowość do skanowania przed zaplanowanymi zadaniami
zenovix health <path> [options]
health sprawdza, czy ścieżkę można przeskanować.- Raportuje dostęp, pliki pomijane, długie ścieżki, szybkość skanowania i szacunkową przepustowość odczytu.
- Opcje obejmują
--json, --quiet i --log <file>.
07 Automatyzacja
Przykłady dla PowerShell i Harmonogramu zadań
Używaj PowerShell do doraźnych raportów, a Harmonogramu zadań do powtarzalnych zadań skanowania.
zenovix scan D:\Data --json | Out-File "C:\Reports\latest-storage.json" -Encoding utf8
zenovix top folders --history "C:\Reports\Storage History.xlsx" --count 20 --json
Program/script: zenovix
Arguments: scan "D:\Data" --history "C:\Reports\Storage History.xlsx" --xlsx --output "C:\Reports" --quiet --log "C:\Reports\zenovix.log"
- Ścieżki ze spacjami — foldery, udziały sieciowe i skoroszyty — ujmuj w cudzysłowy.
- Używaj
--quiet w zadaniach zaplanowanych, gdy potrzebujesz tylko plików i logów. - Używaj
--log <file>, aby dopisywać wiersze dziennika wykonania do późniejszej diagnostyki.
08 Wyniki
Wyjście JSON, Excel i CSV
- Używaj
--json, gdy skrypty lub monitoring potrzebują ustrukturyzowanego wyjścia na stdout. - Używaj
--csv do lekkich eksportów tabelarycznych. - Używaj
--xlsx do raportów zgodnych z Excelem i przepływów Storage History Workbook. - Używaj
--output <folder>, aby wybrać folder docelowy eksportów. - Używaj
--history <file.xlsx>, gdy skan ma zostać dopisany do skoroszytu albo z niego odczytany.
09 Kody wyjścia
Wyniki łatwe w automatyzacji
0 — sukces.1 — nieprawidłowe argumenty lub odrzucone polecenie destrukcyjne.2 — skan lub polecenie nie powiodło się.3 — odmowa dostępu.4 — błąd skoroszytu.5 — błąd wewnętrzny.6 — wymagany Zenovix Pro albo nie można zweryfikować stanu Pro.
FAQ Więcej pomocy
Powiązane tematy FAQ
Sekcja FAQ o CLI odpowiada na częste pytania o dostęp Bezpłatny i Pro, PowerShell, Harmonogram zadań, urządzenia NAS, ścieżki UNC, Excel, Power BI oraz o to, dlaczego czyszczenie pozostaje przepływem pracy aplikacji klasycznej.