CLI
Die Zenovix CLI für schreibgeschützte Pro-Berichte nutzen.
Die Zenovix CLI ist eine sichere Kommandozeilenschnittstelle für Speicheranalyse, Berichte, geplante Scans, Storage History Workbooks und Exporte. Sie ist mit Zenovix Pro verfügbar und ergänzt die Desktop-Anwendung, statt sie zu ersetzen.
CLI
Überblick
Wofür die Zenovix CLI da ist
Nutzen Sie die CLI für wiederholbare Windows-Speicheranalyse per Kommandozeile, PowerShell-Berichte, geplante Analysen, NAS-Analysen, UNC-Scans, Storage History Workbooks oder Exportdateien für Excel, Power BI und andere Berichtstools.
- Verfügbar mit Zenovix Pro.
- Führt schreibgeschützte Analyse- und Berichtsbefehle aus.
- Funktioniert mit Ordnern, Laufwerken, UNC-Pfaden, NAS-Geräten und verbundenen Laufwerken.
- Kann JSON-, CSV-, XLSX-, Storage-History-Workbook- und ODBC-Datenbankausgaben schreiben.
- Kann aus PowerShell, Skripten und der Windows-Aufgabenplanung aufgerufen werden.
- Free-Nutzer können
zenovix --help und zenovix --version ausführen.
SAFE
Sicherheitsmodell
Die CLI führt niemals Bereinigungen aus
Die CLI ist bewusst schreibgeschützt. Kommandozeilen-Automatisierung ist für Analyse und Berichte nützlich, aber die Bereinigung bleibt in der Desktop-Anwendung, wo Prüfstatus, Archivwahl, Wiederherstellungs-Vorschauen und Wiederherstellungsdatensätze sichtbar sind.
- Die Zenovix CLI löscht niemals Dateien.
- Die Zenovix CLI archiviert niemals Dateien.
- Die Zenovix CLI stellt niemals Dateien wieder her.
- Die Zenovix CLI benennt niemals Dateien um.
- Die Zenovix CLI verschiebt niemals Dateien.
- Die Zenovix CLI bereinigt keine Ordner und führt keine automatische Bereinigung durch.
- Destruktive Befehlsnamen wie
delete, archive, restore, cleanup, clean, remove, move, rename, empty-recycle-bin, dedupe und fix werden abgelehnt. - Nutzen Sie die Desktop-Anwendung für prüfungsbasierte Bereinigung, Archiv, Wiederherstellung und Recovery-Centre-Workflows.
01
Installation
Den App-Ausführungsalias des Microsoft Store nutzen
Installieren oder aktualisieren Sie Zenovix Storage Manager aus dem Microsoft Store. Das Store-Paket enthält den Ausführungsalias zenovix.exe, sodass der Befehl als zenovix aus Windows Terminal, PowerShell, Eingabeaufforderung oder Aufgabenplanung gestartet werden kann.
zenovix --help
zenovix --version
- Findet Windows
zenovix nicht, prüfen Sie Windows-Einstellungen > Apps > Erweiterte App-Einstellungen > Aliase für die App-Ausführung. - Kann Pro nicht verifiziert werden, schlagen funktionale Befehle sicher vor dem Scannen fehl und erklären, dass Zenovix Pro nicht verifiziert werden konnte.
- Free- und unbekannte Lizenzzustände können Hilfe und Version anzeigen, funktionale Befehle erfordern jedoch Pro.
02
Verwendung
Aufbau der Befehlszeile
Das allgemeine Befehlsformat lautet:
zenovix <befehl> [argumente] [optionen]
- Globale Optionen:
--help, -h, --version, --quiet, --json und --log <datei>. - Funktionale Pro-Befehle:
scan, compare, top, health, history, export und profile. - Reservierte Namen wie summary, growth, duplicates und insights werden erst als öffentliche Befehle dokumentiert, wenn sie implementiert sind.
03
Scan
Speicherscans von der Kommandozeile ausführen
zenovix scan <pfad> [<pfad> ...] [optionen]
scan führt Speicheranalysen über Ordner, Laufwerke, UNC-Pfade, NAS-Geräte oder verbundene Laufwerke aus. Nutzen Sie ihn für geplante Berichte, Workbook-Historie und Exporte.
- Dateiberichtsoptionen umfassen
--history <datei.xlsx>, --output <ordner>, --json, --csv und --xlsx. - ODBC-Ausgabe nutzt
--output odbc --connection <DSN-oder-Verbindungszeichenfolge>. Fügen Sie --report-output <ordner> hinzu, wenn kombinierte JSON-, CSV- oder XLSX-Berichtsdateien ein Ziel benötigen. - Weitere Scanoptionen sind
--fast, --analysis, --top-folders <n>, --include <muster>, --exclude <muster>, --recursive true|false, --quiet und --log <datei>.
zenovix scan D:\Fotos
zenovix scan "\\server\Finanzen" --analysis --history "Storage History.xlsx"
zenovix scan D:\Daten --json
zenovix scan D:\Daten --xlsx --output "C:\Berichte" --top-folders 25
zenovix scan D:\Daten --output odbc --connection "ZenovixHistory"
zenovix scan D:\Daten --output odbc --connection "ZenovixHistory" --xlsx --report-output "C:\Berichte"
04
Berichte
Scandaten vergleichen, sortieren und exportieren
zenovix compare --history <datei.xlsx> [optionen]
zenovix top folders|files|extensions <pfad> [optionen]
zenovix top folders|extensions --history <datei.xlsx> [optionen]
zenovix export --history <datei.xlsx> [--json] [--csv] [--xlsx] [--output <ordner>]
compare vergleicht den letzten Scan mit dem vorherigen in einem Storage History Workbook.top zeigt die größten Ordner, Dateien oder Erweiterungen aus einem Pfad oder Workbook.export exportiert den neuesten Scan eines Storage History Workbook.- Nutzen Sie
--count <n>, --json, --quiet und --log <datei>, wo unterstützt.
05
History Workbook
Speicherhistorie behalten, ohne alte Daten zu löschen
zenovix history info [--history <datei.xlsx>] [--json]
zenovix history validate [--history <datei.xlsx>] [--json]
zenovix history init [--history <datei.xlsx>]
zenovix history repair [--history <datei.xlsx>]
- Storage History Workbooks sind XLSX-Dateien für wiederholte Speicheranalysen über die Zeit.
- Das Workbook lässt sich in Excel-kompatiblen Tools öffnen und in Power BI analysieren.
- Die Zenovix CLI kann Workbook-Daten erstellen und anhängen, ohne dass Microsoft Excel installiert ist.
history repair pflegt die Workbook-Struktur, ohne historische Scandaten zu löschen oder umzuschreiben.
PROFILE
Gespeicherte Profile
Einen Desktop-Scanplan über seine stabile ID ausführen
zenovix profile run <profil-id> [--quiet] [--log <datei>]
profile run führt ein Profil aus, das im Desktop-Fenster Geplante Scanpläne erstellt wurde.- Das gespeicherte Profil liefert Scanpfade, Filter, History Workbook, JSON-/CSV-/XLSX-Berichte und ein optionales ODBC-Ziel.
- Die Windows-Aufgabenplanung benötigt nur die stabile Profil-ID; Profileinstellungen und ODBC-Verbindungsdetails stehen nicht in der Befehlszeile der geplanten Aufgabe.
- Scan- und Ausgabeoptionen lassen sich bei
profile run nicht überschreiben; bearbeiten Sie stattdessen den gespeicherten Plan in der Desktop-App.
zenovix profile run 63fc6e99-42f7-47a7-9972-83ec998aab31 --quiet
06
Health
Scan-Bereitschaft vor geplanten Jobs prüfen
zenovix health <pfad> [optionen]
health prüft, ob ein Pfad gescannt werden kann.- Er meldet Zugriff, übersprungene Dateien, lange Pfade, Scangeschwindigkeit und eine Lesedurchsatz-Schätzung.
- Optionen umfassen
--json, --quiet und --log <datei>.
07
Automatisierung
Beispiele für PowerShell und Aufgabenplanung
Nutzen Sie PowerShell für Ad-hoc-Berichte und die Aufgabenplanung für wiederholbare Scanjobs.
zenovix scan D:\Daten --json | Out-File "C:\Berichte\latest-storage.json" -Encoding utf8
zenovix top folders --history "C:\Berichte\Storage History.xlsx" --count 20 --json
Programm/Skript: zenovix
Argumente: scan "D:\Daten" --history "C:\Berichte\Storage History.xlsx" --xlsx --output "C:\Berichte" --quiet --log "C:\Berichte\zenovix.log"
- Setzen Sie Pfade mit Leerzeichen für Ordner, Netzwerkfreigaben und Workbooks in Anführungszeichen.
- Nutzen Sie
--quiet für geplante Jobs, bei denen Sie nur Dateien und Protokolle brauchen. - Nutzen Sie
--log <datei>, um Ausführungsprotokolle für die spätere Fehlersuche anzuhängen.
08
Ausgaben
JSON-, CSV-, XLSX-, Workbook- und ODBC-Ausgabe
- Nutzen Sie
--json, wenn Skripte oder Monitoring strukturierte Ausgaben auf stdout brauchen. - Nutzen Sie
--csv für leichte tabellarische Exporte. - Nutzen Sie
--xlsx für Excel-kompatible Berichte und Storage-History-Workflows. - Nutzen Sie
--output <ordner>, um den Zielordner für Exporte zu wählen. - Nutzen Sie
--history <datei.xlsx>, wenn ein Scan an ein Workbook anhängen oder daraus lesen soll. - Nutzen Sie
--output odbc --connection <wert>, um eine unveränderliche Scan-Momentaufnahme an eine ODBC-Datenbank anzuhängen. Der Wert kann ein DSN-Name oder eine vollständige ODBC-Verbindungszeichenfolge sein. - Nutzen Sie
--report-output <ordner> für JSON-, CSV- oder XLSX-Berichtsdateien, wenn --output odbc die Ausgabeoption belegt. - ODBC lässt sich mit
--history, --json, --csv und --xlsx kombinieren; alle Ziele verwenden dieselbe abgeschlossene Scan-Momentaufnahme.
09
Exit-Codes
Automatisierungsfreundliche Ergebnisse
0 – Erfolg.1 – Ungültige Argumente oder abgelehnter destruktiver Befehl.2 – Scan oder Befehl fehlgeschlagen.3 – Zugriff verweigert.4 – Workbook-Fehler.5 – Interner Fehler.6 – Zenovix Pro erforderlich oder Pro-Status nicht verifizierbar.7 – ODBC-Verbindung, Schema oder Datenbankschreibvorgang fehlgeschlagen; die Transaktion wurde zurückgesetzt.8 – JSON-, CSV- oder XLSX-Berichtsexport nach abgeschlossenem Scan fehlgeschlagen.
PRO
Geplante Scanpläne
Wiederverwendbare Pläne, manuell oder nach Zeitplan ausführen
Ein geplanter Scanplan speichert Scanquellen, Scaneinstellungen und Berichtsziele gemeinsam, damit Sie sie nie zweimal einrichten müssen. Pläne sind eine Pro-Funktion; Zenovix erstellt und verwaltet den Zeitplan über die Windows-Aufgabenplanung.
- Wiederverwendbare Pläne erstellen, bearbeiten, duplizieren und entfernen.
- Einen Plan bei Bedarf oder automatisch nach Zeitplan ausführen.
- Jeden Zeitplan direkt in Zenovix aktivieren, deaktivieren und verwalten.
- Gespeicherte Scanprofile lassen sich über eine stabile Profil-ID auch aus der CLI ausführen.
DB
ODBC-Speicherverlauf
Unveränderlichen Verlauf in eine Datenbank exportieren
Der ODBC-Export des Speicherverlaufs sendet unveränderliche Scan-Momentaufnahmen an eine ODBC-kompatible Datenbank für langfristige Historie, historische Berichte und Trendanalysen in Tools wie Power BI. Er lässt sich mit Storage History Workbooks sowie JSON-, CSV- oder XLSX-Berichten kombinieren.
- Die Oberfläche unterstützt DSN, vollständige Verbindungszeichenfolge oder Datenbankdatei mit einem installierten 64-Bit-ODBC-Treiber.
- Zenovix erkennt installierte Treiber und DSNs, bündelt oder installiert jedoch keine Datenbanktreiber.
- Nutzt transaktionale Schreibvorgänge und vermeidet doppelte Verläufe bei erneuten Ausführungen.
- Der Bereich Storage History in den Einstellungen und der ODBC-Tab Geplante Scanpläne können das Ziel speichern, die Verbindung testen sowie das Schema validieren und vorbereiten.
- Microsoft-Access-Ziele erhalten Kapazitätsprüfungen; für andere Anbieter wird keine allgemeine Dateigrößengrenze behauptet.
- Wenn die Desktop-App ein ODBC-Ziel speichert, werden sensible Verbindungswerte wie Datenbankkennwörter in der Windows-Anmeldeinformationsverwaltung geschützt. Ein direkter CLI-Wert für
--connection gilt stattdessen für diesen Befehlsaufruf.
FAQ
Mehr Hilfe
Passende FAQ-Themen
Die CLI-FAQ beantwortet häufige Fragen zu Free- und Pro-Zugriff, PowerShell, Aufgabenplanung, NAS-Geräten, UNC-Pfaden, Excel, Power BI und dazu, warum die Bereinigung ein Desktop-Workflow bleibt.