CLI
Utilizza Zenovix CLI per report Pro di sola lettura.
Zenovix CLI è un'interfaccia a riga di comando sicura per analisi di archiviazione, report, scansioni pianificate, Storage History Workbooks ed esportazioni. È disponibile con Zenovix Pro e integra l'applicazione desktop anziché sostituirla.
CLI
panoramica
A cosa serve Zenovix CLI
Utilizza CLI per analisi di archiviazione Windows ripetibili da riga di comando, report PowerShell, analisi pianificate, analisi NAS, scansioni UNC, Storage History Workbooks o file di esportazione per Excel, Power BI e altri strumenti di reporting.
- Disponibile con Zenovix Pro.
- Esegue analisi di sola lettura e comandi di reporting.
- Funziona con cartelle, unità, percorsi UNC, dispositivi NAS e unità connesse.
- Può scrivere output JSON, CSV, XLSX, Storage History Workbook e database ODBC.
- È possibile accedervi da PowerShell, script e pianificatore di attività Windows.
- Gli utenti gratuiti possono
zenovix --help e zenovix --version eseguire.
SAFE
Modello di sicurezza
Lo CLI non esegue mai pulizie
Lo CLI è intenzionalmente protetto da scrittura. L'automazione della riga di comando è utile per l'analisi e il reporting, ma la pulizia rimane nell'applicazione desktop, dove sono visibili lo stato della scansione, la selezione dell'archivio, le anteprime del ripristino e i record di ripristino.
- Zenovix CLI non elimina mai i file.
- Zenovix CLI non archivia mai i file.
- Zenovix CLI non recupera mai i file.
- Zenovix CLI non rinomina mai i file.
- Zenovix CLI non sposta mai i file.
- Zenovix CLI non pulisce le cartelle né esegue la pulizia automatica.
- Nomi di comandi distruttivi come
eliminare, archivio, ripristinare, ripulire, pulito, rimuovere, mossa, rinominare, cestino-vuoto, deduplicare e aggiustare vengono respinti. - Utilizza l'applicazione desktop per flussi di lavoro di pulizia, archiviazione, ripristino e centro di ripristino basati su controllo.
01
installazione
Utilizza l'alias di esecuzione dell'app Microsoft Store
Installa o aggiorna Zenovix Storage Manager da Microsoft Store. Il pacchetto del negozio contiene l'alias di esecuzione zenovix.exe, quindi il comando as zenovix può essere avviato dal terminale Windows, PowerShell, dal prompt dei comandi o dall'Utilità di pianificazione.
zenovix --help
zenovix --version
- Trova Windows
zenovix In caso contrario, controlla Windows Impostazioni > App > Impostazioni avanzate dell'app > Alias di esecuzione dell'app. - Se Pro non può essere verificato, i comandi funzionali falliranno in modo sicuro prima della scansione, affermando che Zenovix Pro non può essere verificato.
- Gli stati di licenza libera e sconosciuta possono visualizzare la guida e la versione, ma i comandi funzionali richiedono Pro.
02
utilizzo
Struttura della riga di comando
Il formato generale del comando è:
zenovix <command> [arguments] [options]
- Opzioni globali:
--help, -H, --version, --quiet, --json e --log <file>. - Comandi funzionali Pro:
scan, compare, top, health, history, export e profile. - I nomi riservati come riepilogo, crescita, duplicati e approfondimenti non sono documentati come comandi pubblici finché non vengono implementati.
03
scansione
Esegui scansioni dello spazio dalla riga di comando
zenovix scan <path> [<path> ...] [options]
scan esegue l'analisi dell'archiviazione su cartelle, unità, percorsi UNC, dispositivi NAS o unità connesse. Usalo per report pianificati, cronologia delle cartelle di lavoro ed esportazioni.
- Le opzioni per i report su file includono
--history <file.xlsx>, --output <folder>, --json, --csv e --xlsx. - L'output ODBC usa
--output odbc --connection <DSN-o-stringa-di-connessione>. Aggiungi --report-output <folder> quando i file di report JSON, CSV o XLSX combinati necessitano di una destinazione. - Le altre opzioni di scansione includono
--fast, --analysis, --top-folders <n>, --include <pattern>, --exclude <pattern>, --recursive true|false, --quiet e --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
Rapporti
Confronta, ordina ed esporta i dati di scansione
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 confronta l'ultima scansione con quella precedente in uno Storage History Workbook.top mostra le cartelle, i file o le estensioni più grandi da un percorso o da una cartella di lavoro.export esporta l'ultima scansione di un Storage History Workbook.- Approfitta
--count <n>, --json, --quiet e --log <file>, dove supportato.
05
Quaderno di esercizi di storia
Conserva la cronologia di archiviazione senza eliminare i vecchi dati
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>]
- Storage History Workbooks sono file XLSX per analisi ripetute dello spazio nel tempo.
- La cartella di lavoro può essere aperta con strumenti compatibili con Excel e analizzata in Power BI.
- Zenovix CLI può creare e allegare dati di cartelle di lavoro senza Microsoft Excel installato.
riparazione della storia mantiene la struttura della cartella di lavoro senza eliminare o riscrivere i dati di scansione storici.
PROFILE
Profili salvati
Esegui un piano di scansione desktop tramite il suo ID stabile
zenovix profile run <profile-id> [--quiet] [--log <file>]
profile run esegue un profilo creato nella finestra Piani di scansione pianificati dell'app desktop.- Il profilo salvato fornisce percorsi, filtri, Storage History Workbook, report JSON/CSV/XLSX e una destinazione ODBC facoltativa.
- L'Utilità di pianificazione di Windows richiede solo l'ID stabile; impostazioni del profilo e dettagli di connessione ODBC non vengono inseriti nella riga di comando dell'attività pianificata.
- Le opzioni di scansione e output non possono essere sostituite in
profile run; modifica invece il piano salvato nell'app desktop.
zenovix profile run 63fc6e99-42f7-47a7-9972-83ec998aab31 --quiet
06
Salute
Controlla la disponibilità della scansione prima dei lavori pianificati
zenovix health <path> [options]
health controlla se un percorso può essere scansionato.- Segnala l'accesso, i file saltati, i percorsi lunghi, la velocità di scansione e una stima della velocità di lettura.
- Le opzioni includono
--json, --quiet e --log <file>.
07
automazione
Esempi di PowerShell e pianificazione delle attività
Utilizza PowerShell per report ad hoc e pianificazione delle attività per lavori di scansione ripetibili.
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"
- Racchiudere i percorsi con spazi per cartelle, condivisioni di rete e cartelle di lavoro tra virgolette.
- Approfitta
--quiet per lavori pianificati in cui sono necessari solo file e registri. - Approfitta
--log <file> per allegare i log di esecuzione per la successiva risoluzione dei problemi.
08
spesa
Output JSON, CSV, XLSX, workbook e ODBC
- Approfitta
--json quando gli script o il monitoraggio necessitano di output strutturato su stdout. - Approfitta
--csv per esportazioni tabellari leggere. - Approfitta
--xlsx per report compatibili con Excel e flussi di lavoro della cronologia di archiviazione. - Approfitta
--output <folder> per scegliere la cartella di destinazione delle esportazioni. - Approfitta
--history <file.xlsx> se desideri allegare una scansione o leggere da una cartella di lavoro. - Usa
--output odbc --connection <value> per aggiungere uno snapshot di scansione immutabile a un database ODBC. Il valore può essere un nome DSN o una stringa di connessione ODBC completa. - Usa
--report-output <folder> per i file di report JSON, CSV o XLSX quando --output odbc occupa l'opzione di output. - ODBC può essere combinato con
--history, --json, --csv e --xlsx; tutte le destinazioni usano lo stesso snapshot di scansione completato.
09
Codici di uscita
Risultati favorevoli all'automazione
0- Successo.1– Argomenti non validi o comando distruttivo rifiutato.2– Scansione o comando non riuscito.3– Accesso negato.4– Errore della cartella di lavoro.5– Errore interno.6– Zenovix Pro richiesto o lo stato Pro non può essere verificato.7– Connessione ODBC, schema o scrittura nel database non riusciti; la transazione è stata annullata.8– Esportazione del report JSON, CSV o XLSX non riuscita dopo il completamento della scansione.
PRO
Piani di scansione pianificati
Piani riutilizzabili, eseguiti manualmente o pianificati
Un piano di scansione pianificato salva insieme origini di scansione, impostazioni e destinazioni dei report, così non devi configurarli due volte. I piani sono una funzione Pro; Zenovix crea e gestisce la pianificazione tramite l'Utilità di pianificazione di Windows.
- Crea, modifica, duplica e rimuovi piani riutilizzabili.
- Esegui un piano su richiesta o automaticamente in base a una pianificazione.
- Attiva, disattiva e gestisci ogni pianificazione direttamente da Zenovix.
- I profili di scansione salvati possono essere eseguiti anche dalla CLI tramite un ID profilo stabile.
DB
Cronologia di archiviazione ODBC
Esporta una cronologia immutabile in un database
L'esportazione della cronologia di archiviazione tramite ODBC invia snapshot di scansione immutabili a un database compatibile con ODBC per cronologia a lungo termine, reportistica storica e analisi delle tendenze in strumenti come Power BI. Può essere combinata con gli Storage History Workbooks e i report JSON, CSV o XLSX.
- L'interfaccia supporta un DSN, una stringa di connessione completa o un file di database con un driver ODBC a 64 bit installato.
- Zenovix rileva driver e DSN installati; non include né installa automaticamente driver di database.
- Usa scritture transazionali ed evita di duplicare la cronologia quando un'esecuzione viene ripetuta.
- L'area Storage History nelle Impostazioni e la scheda ODBC dei Piani di scansione pianificati consentono di salvare la destinazione, testare la connessione, convalidare lo schema e prepararlo.
- Le destinazioni Microsoft Access ricevono controlli di capacità; per gli altri provider non viene dichiarato un limite universale di dimensione del file.
- Quando l'app desktop salva una destinazione ODBC, i valori sensibili come le password sono protetti da Gestione credenziali di Windows. Un valore CLI diretto per
--connection viene fornito per quella singola invocazione.
FAQ
Più aiuto
Argomenti delle domande frequenti corrispondenti
IL CLI Domande frequenti risponde alle domande comuni sull'accesso gratuito e Pro, PowerShell, pianificazione delle attività, dispositivi NAS, percorsi UNC, Excel, Power BI e perché la pulizia rimane un flusso di lavoro desktop.