CLI
Utilisez le Zenovix CLI pour les rapports Pro en lecture seule.
Le Zenovix CLI est une interface de ligne de commande sécurisée pour l'analyse du stockage, les rapports, les analyses planifiées, le Storage History Workbooks et les exportations. Il est disponible avec Zenovix Pro et complète l'application de bureau plutôt que de la remplacer.
CLI
aperçu
À quoi sert le Zenovix CLI
Utilisez la CLI pour une analyse de stockage Windows en ligne de commande répétable, des rapports PowerShell, une analyse planifiée, une analyse NAS, des analyses UNC, Storage History Workbooks ou des fichiers d'exportation pour Excel, Power BI et d'autres outils de reporting.
- Disponible avec Zenovix Pro.
- Exécute des commandes d’analyse et de création de rapports en lecture seule.
- Fonctionne avec les dossiers, les lecteurs, les chemins UNC, les périphériques NAS et les lecteurs connectés.
- Peut écrire des sorties JSON, CSV, XLSX, Storage History Workbook et base de données ODBC.
- Accessible à partir de PowerShell, des scripts et du planificateur de tâches Windows.
- Les utilisateurs gratuits peuvent
Zenovix --help et Zenovix --version effectuer.
SAFE
Modèle de sécurité
La CLI n'exécute jamais de nettoyages
La CLI est intentionnellement protégé en écriture. L'automatisation de la ligne de commande est utile pour l'analyse et la création de rapports, mais le nettoyage reste dans l'application de bureau, où l'état de l'analyse, la sélection des archives, les aperçus de récupération et les enregistrements de récupération sont visibles.
- Le Zenovix CLI ne supprime jamais les fichiers.
- Le Zenovix CLI n’archive jamais de fichiers.
- Le Zenovix CLI ne récupère jamais les fichiers.
- Le Zenovix CLI ne renomme jamais les fichiers.
- Le Zenovix CLI ne déplace jamais de fichiers.
- Le Zenovix CLI ne nettoie pas les dossiers et n'effectue pas de nettoyage automatique.
- Noms de commandes destructeurs comme
supprimer, archive, restaurer, nettoyage, faire le ménage, retirer, se déplacer, rebaptiser, corbeille-vide, dédoublonner et réparer sont rejetées. - Utilisez l'application de bureau pour les workflows de nettoyage, d'archivage, de restauration et de centre de récupération basés sur l'audit.
01
installation
Utiliser l'alias d'exécution de l'application Microsoft Store
Installez ou mettez à jour Zenovix Storage Manager à partir de Microsoft Store. Le package du magasin contient l'alias d'exécution zenovix.exe, donc la commande comme zénovix peut être démarré à partir du terminal Windows, de PowerShell, de l'invite de commande ou du planificateur de tâches.
zenovix --help
zenovix --version
- Trouve Windows
zénovix Sinon, vérifiez Paramètres Windows > Applications > Paramètres avancés de l'application > Alias d'exécution de l'application. - Si Pro ne peut pas être vérifié, les commandes fonctionnelles échoueront en toute sécurité avant la analyse, indiquant que Zenovix Pro n'a pas pu être vérifié.
- Les états de licence gratuits et inconnus peuvent afficher l'aide et la version, mais les commandes fonctionnelles nécessitent Pro.
02
utiliser
Structure de la ligne de commande
Le format général de la commande est :
zenovix <command> [arguments] [options]
- Options globales :
--help, -h, --version, --quiet, --json et --log <file>. - Commandes Pro fonctionnelles :
scan, compare, top, health, history, export et profile. - Les noms réservés tels que résumé, croissance, doublons et informations ne sont pas documentés en tant que commandes publiques tant qu'ils ne sont pas implémentés.
03
balayage
Exécutez des analyses de stockage à partir de la ligne de commande
zenovix scan <path> [<path> ...] [options]
scan effectue une analyse de stockage sur les dossiers, les lecteurs, les chemins UNC, les périphériques NAS ou les lecteurs connectés. Utilisez-le pour les rapports planifiés, l'historique des classeurs et les exportations.
- Les options de rapports en fichiers incluent
--history <file.xlsx>, --output <folder>, --json, --csv et --xlsx. - La sortie ODBC utilise
--output odbc --connection <DSN-ou-chaîne-de-connexion>. Ajoutez --report-output <folder> lorsque les fichiers JSON, CSV ou XLSX combinés nécessitent une destination. - Les autres options d'analyse comprennent
--fast, --analysis, --top-folders <n>, --include <pattern>, --exclude <pattern>, --recursive true|false, --quiet et --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
Rapports
Comparez, triez et exportez les données analysées
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 compare le dernier scan avec le précédent dans un Storage History Workbook.top affiche les dossiers, fichiers ou extensions les plus volumineux d'un chemin ou d'un classeur.export exporte le dernier scan d'un Storage History Workbook.- Profitez
--count<n>, --json, --quiet et --log <file>, là où il est pris en charge.
05
Cahier d'exercices d'histoire
Conservez l'historique de stockage sans supprimer les anciennes données
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 sont des fichiers XLSX pour une analyse répétée du stockage au fil du temps.
- Le classeur peut être ouvert dans des outils compatibles Excel et analysé dans Power BI.
- Le Zenovix CLI peut créer et joindre des données de classeur sans que Microsoft Excel soit installé.
réparation de l'histoire conserve la structure du classeur sans supprimer ni réécrire les données d'analyse historiques.
PROFILE
Profils enregistrés
Exécuter un plan d'analyse du bureau par son ID stable
zenovix profile run <profile-id> [--quiet] [--log <file>]
profile run exécute un profil créé dans la fenêtre Plans d'analyse planifiés de l'application de bureau.- Le profil enregistré fournit les chemins, filtres, le Storage History Workbook, les rapports JSON/CSV/XLSX et une destination ODBC facultative.
- Le Planificateur de tâches Windows n'a besoin que de l'ID stable ; les paramètres du profil et les informations de connexion ODBC ne figurent pas sur la ligne de commande de la tâche planifiée.
- Les options d'analyse et de sortie ne peuvent pas être remplacées avec
profile run ; modifiez plutôt le plan enregistré dans l'application de bureau.
zenovix profile run 63fc6e99-42f7-47a7-9972-83ec998aab31 --quiet
06
Santé
Vérifier l'état de préparation de l'analyse avant les tâches planifiées
zenovix health <path> [options]
health vérifie si un chemin peut être analysé.- Il signale les accès, les fichiers ignorés, les longs chemins, la vitesse d'analyse et une estimation du débit de lecture.
- Les options incluent
--json, --quiet et --log <file>.
07
automation
Exemples de PowerShell et de planification des tâches
Utilisez PowerShell pour créer des rapports ad hoc et planifier des tâches pour les tâches d'analyse répétables.
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"
- Placez les chemins d’accès avec des espaces pour les dossiers, les partages réseau et les classeurs entre guillemets.
- Profitez
--quiet pour les tâches planifiées pour lesquelles vous n'avez besoin que de fichiers et de journaux. - Profitez
--log <file> pour joindre les journaux d'exécution pour un dépannage ultérieur.
08
dépense
Sortie JSON, CSV, XLSX, workbook et ODBC
- Profitez
--json lorsque les scripts ou la surveillance nécessitent une sortie structurée vers la sortie standard. - Profitez
--csv pour les exportations tabulaires légères. - Profitez
--xlsx pour les rapports compatibles Excel et les flux de travail d'historique de stockage. - Profitez
--output <folder> pour choisir le dossier de destination des exportations. - Profitez
--history <file.xlsx> si vous souhaitez joindre une analyse ou lire un classeur. - Utilisez
--output odbc --connection <value> pour ajouter un instantané d'analyse immuable à une base de données ODBC. La valeur peut être un nom DSN ou une chaîne de connexion ODBC complète. - Utilisez
--report-output <folder> pour les fichiers de rapports JSON, CSV ou XLSX lorsque --output odbc occupe l'option de sortie. - ODBC peut être combiné avec
--history, --json, --csv et --xlsx ; toutes les destinations utilisent le même instantané d'analyse terminé.
09
Codes de sortie
Des résultats adaptés à l'automatisation
0- Succès.1– Arguments invalides ou commande destructrice rejetée.2– L'analyse ou la commande a échoué.3– Accès refusé.4– Erreur de classeur.5– Erreur interne.6– Zenovix Pro requis ou le statut Pro ne peut pas être vérifié.7– Échec de la connexion ODBC, du schéma ou de l'écriture en base de données ; la transaction a été annulée.8– Échec de l'exportation du rapport JSON, CSV ou XLSX après la fin de l'analyse.
PRO
Plans d'analyse planifiés
Des plans réutilisables, exécutés manuellement ou planifiés
Un plan d'analyse planifié enregistre ensemble les sources d'analyse, les paramètres et les destinations de rapports, pour ne jamais les configurer deux fois. Les plans sont une fonctionnalité Pro ; Zenovix crée et gère la planification via le Planificateur de tâches de Windows.
- Créez, modifiez, dupliquez et supprimez des plans réutilisables.
- Exécutez un plan à la demande ou automatiquement selon une planification.
- Activez, désactivez et gérez chaque planification directement depuis Zenovix.
- Les profils d'analyse enregistrés peuvent aussi être exécutés depuis la CLI à l'aide d'un identifiant de profil stable.
DB
Historique de stockage ODBC
Exportez un historique immuable vers une base de données
L'exportation de l'historique de stockage via ODBC envoie des instantanés d'analyse immuables vers une base de données compatible ODBC pour l'historique à long terme, les rapports historiques et l'analyse des tendances dans des outils tels que Power BI. Elle peut être combinée avec les Storage History Workbooks et les rapports JSON, CSV ou XLSX.
- L'interface accepte un DSN, une chaîne de connexion complète ou un fichier de base de données avec un pilote ODBC 64 bits installé.
- Zenovix détecte les pilotes et DSN installés ; il n'inclut ni n'installe silencieusement de pilotes de base de données.
- Utilise des écritures transactionnelles et évite de dupliquer l'historique en cas de nouvelle tentative.
- La zone Storage History des paramètres et l'onglet ODBC des Plans d'analyse planifiés permettent d'enregistrer la destination, de tester la connexion, de valider le schéma et de le préparer.
- Les destinations Microsoft Access bénéficient de contrôles de capacité ; aucune limite universelle de taille de fichier n'est attribuée aux autres fournisseurs.
- Lorsque l'application de bureau enregistre une destination ODBC, les valeurs sensibles comme les mots de passe sont protégées par le Gestionnaire d'identification Windows. Une valeur CLI directe pour
--connection est fournie pour cette invocation.
FAQ
Plus d'aide
Sujets de FAQ correspondants
Le FAQ CLI répond aux questions courantes sur l'accès gratuit et professionnel, PowerShell, la planification des tâches, les appareils NAS, les chemins UNC, Excel, Power BI et pourquoi le nettoyage reste un flux de travail de bureau.