CLI
Utilice Zenovix CLI para informes Pro de solo lectura.
Zenovix CLI es una interfaz de línea de comandos segura para análisis de almacenamiento, informes, escaneos programados, Storage History Workbooks y exportaciones. Está disponible con Zenovix Pro y complementa la aplicación de escritorio en lugar de reemplazarla.
CLI
descripción general
Para qué sirve el Zenovix CLI
Utilice CLI para análisis de almacenamiento Windows de línea de comandos repetibles, informes PowerShell, análisis programados, análisis NAS, escaneos UNC, Storage History Workbooks o archivos de exportación para Excel, Power BI y otras herramientas de informes.
- Disponible con Zenovix Pro.
- Ejecuta comandos de análisis e informes de solo lectura.
- Funciona con carpetas, unidades, rutas UNC, dispositivos NAS y unidades conectadas.
- Puede escribir salidas JSON, CSV, XLSX, Storage History Workbook y bases de datos ODBC.
- Se puede acceder desde PowerShell, scripts y programador de tareas Windows.
- Los usuarios gratuitos pueden
Zenovix --help y Zenovix --version realizar.
SAFE
Modelo de seguridad
La CLI nunca ejecuta limpiezas
La CLI está intencionalmente protegido contra escritura. La automatización de la línea de comandos es útil para análisis e informes, pero la limpieza permanece en la aplicación de escritorio, donde son visibles el estado del análisis, la selección de archivos, las vistas previas de recuperación y los registros de recuperación.
- El Zenovix CLI nunca elimina archivos.
- El Zenovix CLI nunca archiva archivos.
- El Zenovix CLI nunca recupera archivos.
- El Zenovix CLI nunca cambia el nombre de los archivos.
- El Zenovix CLI nunca mueve archivos.
- El Zenovix CLI no limpia carpetas ni realiza una limpieza automática.
- Nombres de comandos destructivos como
borrar, file, restaurar, limpieza, limpio, eliminar, mover, rebautizar, papelera-de-reciclaje-vacia, deduplicar y arreglar son rechazados. - Utilice la aplicación de escritorio para flujos de trabajo de centros de recuperación, archivado, limpieza y recuperación basados en auditorías.
01
instalación
Utilice el alias de ejecución de la aplicación Microsoft Store
Instale o actualice Zenovix Storage Manager desde Microsoft Store. El paquete de la tienda contiene el alias de ejecución. zenovix.exe, entonces el comando como zenovix se puede iniciar desde la terminal Windows, PowerShell, el símbolo del sistema o el programador de tareas.
zenovix --help
zenovix --version
- Encuentra Windows
zenovix De lo contrario, verifique Configuración Windows > Aplicaciones > Configuración avanzada de aplicaciones > Alias de ejecución de aplicaciones. - Si no se puede verificar Pro, los comandos funcionales fallarán de manera segura antes de escanear, indicando que no se pudo verificar Zenovix Pro.
- Los estados de licencia gratuitos y desconocidos pueden mostrar ayuda y versión, pero los comandos funcionales requieren Pro.
02
usar
Estructura de la línea de comando
El formato de comando general es:
zenovix <command> [arguments] [options]
- Opciones globales:
--help, -h, --version, --quiet, --json y --log <file>. - Comandos funcionales de Pro:
scan, compare, top, health, history, export y profile. - Los nombres reservados, como resumen, crecimiento, duplicados e información, no se documentan como comandos públicos hasta que se implementan.
03
escanear
Ejecute análisis de almacenamiento desde la línea de comando
zenovix scan <path> [<path> ...] [options]
scan realiza análisis de almacenamiento en carpetas, unidades, rutas UNC, dispositivos NAS o unidades conectadas. Úselo para informes programados, historial de libros y exportaciones.
- Las opciones de informes en archivos incluyen
--history <file.xlsx>, --output <folder>, --json, --csv y --xlsx. - La salida ODBC usa
--output odbc --connection <DSN-o-cadena-de-conexión>. Añada --report-output <folder> cuando los archivos JSON, CSV o XLSX combinados necesiten un destino. - Otras opciones de análisis son
--fast, --analysis, --top-folders <n>, --include <pattern>, --exclude <pattern>, --recursive true|false, --quiet y --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
Informes
Comparar, ordenar y exportar datos escaneados
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 compara el último escaneo con el anterior en un Storage History Workbook.top muestra las carpetas, archivos o extensiones más grandes de una ruta o libro de trabajo.export exporta el último escaneo de un Storage History Workbook.- Aprovecha
--count <n>, --json, --quiet y --log <file>, donde sea compatible.
05
Cuaderno de historia
Mantenga el historial de almacenamiento sin eliminar datos antiguos
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 son archivos XLSX para análisis de almacenamiento repetidos a lo largo del tiempo.
- El libro se puede abrir en herramientas compatibles con Excel y analizarse en Power BI.
- El Zenovix CLI puede crear y adjuntar datos de libros de trabajo sin Microsoft Excel instalado.
reparación de historia mantiene la estructura del libro de trabajo sin eliminar ni reescribir los datos históricos de escaneo.
PROFILE
Perfiles guardados
Ejecutar un plan de análisis del escritorio por su ID estable
zenovix profile run <profile-id> [--quiet] [--log <file>]
profile run ejecuta un perfil creado en la ventana Planes de análisis programados de la aplicación de escritorio.- El perfil guardado aporta las rutas, filtros, el Storage History Workbook, los informes JSON/CSV/XLSX y un destino ODBC opcional.
- El Programador de tareas de Windows solo necesita el ID estable; los ajustes del perfil y los datos de conexión ODBC no aparecen en la línea de comandos de la tarea programada.
- Las opciones de análisis y salida no se pueden sustituir en
profile run; edite el plan guardado en la aplicación de escritorio.
zenovix profile run 63fc6e99-42f7-47a7-9972-83ec998aab31 --quiet
06
Salud
Verifique la preparación del escaneo antes de los trabajos programados
zenovix health <path> [options]
health comprueba si se puede escanear una ruta.- Informa el acceso, los archivos omitidos, las rutas largas, la velocidad de escaneo y una estimación del rendimiento de lectura.
- Las opciones incluyen
--json, --quiet y --log <file>.
07
automatización
Ejemplos de PowerShell y programación de tareas
Utilice PowerShell para generar informes ad hoc y programar tareas para trabajos de escaneo repetibles.
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"
- Encierre las rutas con espacios para carpetas, recursos compartidos de red y libros entre comillas.
- Aprovecha
--quiet para trabajos programados donde solo necesita archivos y registros. - Aprovecha
--log <file> para adjuntar registros de ejecución para su posterior resolución de problemas.
08
gasto
Salida JSON, CSV, XLSX, workbook y ODBC
- Aprovecha
--json cuando los scripts o el monitoreo necesitan una salida estructurada para la salida estándar. - Aprovecha
--csv para exportaciones tabulares ligeras. - Aprovecha
--xlsx para informes compatibles con Excel y flujos de trabajo de historial de almacenamiento. - Aprovecha
--output <folder> para elegir la carpeta de destino para las exportaciones. - Aprovecha
--history <file.xlsx> si desea adjuntar un escaneo o leer un libro de trabajo. - Use
--output odbc --connection <value> para añadir una instantánea de análisis inmutable a una base de datos ODBC. El valor puede ser un nombre DSN o una cadena de conexión ODBC completa. - Use
--report-output <folder> para los archivos de informes JSON, CSV o XLSX cuando --output odbc ocupa la opción de salida. - ODBC puede combinarse con
--history, --json, --csv y --xlsx; todos los destinos usan la misma instantánea de análisis completada.
09
códigos de salida
Resultados fáciles de automatizar
0- Éxito.1– Argumentos no válidos o comando destructivo rechazado.2– Falló el escaneo o el comando.3– Acceso denegado.4– Error en el libro de trabajo.5– Error interno.6– Se requiere Zenovix Pro o no se puede verificar el estado Pro.7– Falló la conexión ODBC, el esquema o la escritura en la base de datos y la transacción se revirtió.8– Falló la exportación de informes JSON, CSV o XLSX después de completarse el análisis.
PRO
Planes de escaneo programados
Planes reutilizables, ejecutados manualmente o por programación
Un plan de escaneo programado guarda juntos los orígenes de escaneo, los ajustes y los destinos de informes, para que no tengas que configurarlos dos veces. Los planes son una función Pro; Zenovix crea y gestiona la programación mediante el Programador de tareas de Windows.
- Crea, edita, duplica y elimina planes reutilizables.
- Ejecuta un plan a demanda o automáticamente según una programación.
- Activa, desactiva y gestiona cada programación directamente desde Zenovix.
- Los perfiles de escaneo guardados también se pueden ejecutar desde la CLI mediante un ID de perfil estable.
DB
Historial de almacenamiento ODBC
Exporta historial inmutable a una base de datos
La exportación del historial de almacenamiento por ODBC envía instantáneas de escaneo inmutables a una base de datos compatible con ODBC para historial a largo plazo, informes históricos y análisis de tendencias en herramientas como Power BI. Puede combinarse con Storage History Workbooks e informes JSON, CSV o XLSX.
- La interfaz admite un DSN, una cadena de conexión completa o un archivo de base de datos con un controlador ODBC de 64 bits instalado.
- Zenovix detecta los controladores y DSN instalados; no incluye ni instala controladores de bases de datos de forma silenciosa.
- Usa escrituras transaccionales y evita duplicar el historial al reintentar una ejecución.
- El área Storage History de Ajustes y la pestaña ODBC de Planes de análisis programados permiten guardar el destino, probar la conexión, validar el esquema y prepararlo.
- Los destinos de Microsoft Access reciben comprobaciones de capacidad; no se atribuye un límite universal de tamaño de archivo a otros proveedores.
- Cuando la aplicación de escritorio guarda un destino ODBC, los valores sensibles, como las contraseñas, se protegen con el Administrador de credenciales de Windows. Un valor CLI directo de
--connection se proporciona solo para esa invocación.
FAQ
Más ayuda
Temas de preguntas frecuentes coincidentes
El Preguntas frecuentes sobre CLI responde preguntas comunes sobre el acceso gratuito y profesional, PowerShell, programación de tareas, dispositivos NAS, rutas UNC, Excel, Power BI y por qué la limpieza sigue siendo un flujo de trabajo de escritorio.