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, skoroszyty Storage History Workbook i dane w bazach ODBC.
- 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, export i profile. - 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 raportów plikowych obejmują
--history <file.xlsx>, --output <folder>, --json, --csv i --xlsx. - Wyjście ODBC używa
--output odbc --connection <DSN-lub-ciąg-połączenia>. Dodaj --report-output <folder>, gdy połączone pliki raportów JSON, CSV lub XLSX potrzebują miejsca docelowego. - Pozostałe opcje skanowania obejmują
--fast, --analysis, --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
zenovix scan D:\Data --output odbc --connection "ZenovixHistory"
zenovix scan D:\Data --output odbc --connection "ZenovixHistory" --xlsx --report-output "C:\Reports"
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.
PROFILE
Zapisane profile
Uruchom plan skanowania z aplikacji za pomocą jego stałego identyfikatora
zenovix profile run <profile-id> [--quiet] [--log <file>]
profile run uruchamia profil utworzony w oknie Zaplanowane plany skanowania aplikacji klasycznej.- Zapisany profil dostarcza ścieżki, filtry, Storage History Workbook, raporty JSON/CSV/XLSX i opcjonalne miejsce docelowe ODBC.
- Harmonogram zadań systemu Windows potrzebuje tylko stałego identyfikatora; ustawienia profilu i dane połączenia ODBC nie trafiają do wiersza poleceń zaplanowanego zadania.
- Opcji skanowania i wyjścia nie można zastąpić w
profile run; edytuj zapisany plan w aplikacji klasycznej.
zenovix profile run 63fc6e99-42f7-47a7-9972-83ec998aab31 --quiet
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, CSV, XLSX, skoroszyt i ODBC
- 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. - Użyj
--output odbc --connection <value>, aby dodać niezmienną migawkę skanowania do bazy ODBC. Wartością może być nazwa DSN lub pełny ciąg połączenia ODBC. - Użyj
--report-output <folder> dla plików raportów JSON, CSV lub XLSX, gdy --output odbc zajmuje opcję wyjścia. - ODBC można łączyć z
--history, --json, --csv i --xlsx; wszystkie miejsca docelowe używają tej samej ukończonej migawki skanowania.
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.7 — błąd połączenia ODBC, schematu lub zapisu do bazy; transakcja została wycofana.8 — eksport raportu JSON, CSV lub XLSX nie powiódł się po zakończeniu skanowania.
PRO
Zaplanowane plany skanowania
Wielokrotnego użytku plany, uruchamiane ręcznie lub według harmonogramu
Zaplanowany plan skanowania przechowuje razem źródła skanowania, ustawienia i miejsca docelowe raportów, więc nie musisz konfigurować ich dwa razy. Plany to funkcja Pro; Zenovix tworzy harmonogram i zarządza nim za pomocą Harmonogramu zadań systemu Windows.
- Twórz, edytuj, duplikuj i usuwaj plany wielokrotnego użytku.
- Uruchamiaj plan na żądanie lub automatycznie według harmonogramu.
- Włączaj, wyłączaj i zarządzaj każdym harmonogramem bezpośrednio w Zenovix.
- Zapisane profile skanowania można też uruchamiać z CLI przy użyciu stabilnego identyfikatora profilu.
DB
Historia magazynu ODBC
Eksportuj niezmienną historię do bazy danych
Eksport historii magazynu przez ODBC wysyła niezmienne migawki skanowania do bazy danych zgodnej z ODBC na potrzeby długoterminowej historii, raportowania historycznego i analizy trendów w narzędziach takich jak Power BI. Można go łączyć ze Storage History Workbooks oraz raportami JSON, CSV lub XLSX.
- Interfejs obsługuje DSN, pełny ciąg połączenia lub plik bazy danych z zainstalowanym 64-bitowym sterownikiem ODBC.
- Zenovix wykrywa zainstalowane sterowniki i DSN; nie zawiera ani nie instaluje potajemnie sterowników baz danych.
- Korzysta z zapisów transakcyjnych i unika duplikowania historii przy ponownej próbie.
- Obszar Storage History w Ustawieniach i karta ODBC Zaplanowanych planów skanowania pozwalają zapisać miejsce docelowe, przetestować połączenie, zweryfikować schemat i przygotować schemat.
- Miejsca docelowe Microsoft Access mają sprawdzaną pojemność; dla innych dostawców nie jest deklarowany uniwersalny limit rozmiaru pliku.
- Gdy aplikacja klasyczna zapisuje miejsce docelowe ODBC, poufne wartości, takie jak hasła, są chronione przez Menedżera poświadczeń systemu Windows. Bezpośrednia wartość CLI dla
--connection jest przekazywana dla danego wywołania.
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.