CLI
Use a Zenovix CLI para relatórios Pro somente leitura.
A Zenovix CLI é uma interface de linha de comando segura para análise de armazenamento, relatórios, varreduras agendadas, Storage History Workbooks e exportações. Está disponível com o Zenovix Pro e complementa o aplicativo de desktop em vez de substituí-lo.
CLI Visão geral
Para que serve a Zenovix CLI
Use a CLI para análises de armazenamento repetíveis pela linha de comando no Windows, relatórios em PowerShell, análises agendadas, varreduras de NAS, caminhos UNC, Storage History Workbooks ou exportações para Excel, Power BI e outras ferramentas de relatório.
- Disponível com o Zenovix Pro.
- Executa comandos de análise e relatório somente leitura.
- Funciona com pastas, unidades, caminhos UNC, dispositivos NAS e unidades conectadas.
- Pode gravar resultados em JSON, CSV, XLSX e Storage History Workbooks.
- Pode ser chamada do PowerShell, de scripts e do Agendador de Tarefas do Windows.
- Usuários do Free podem executar
zenovix --help e zenovix --version.
SAFE Modelo de segurança
A CLI nunca executa limpezas
A CLI é intencionalmente somente leitura. A automação pela linha de comando é útil para análises e relatórios, mas a limpeza permanece no aplicativo de desktop, onde o estado da revisão, a seleção de arquivos, as pré-visualizações de recuperação e os registros de recuperação ficam visíveis.
- A Zenovix CLI nunca exclui arquivos.
- A Zenovix CLI nunca arquiva arquivos.
- A Zenovix CLI nunca restaura arquivos.
- A Zenovix CLI nunca renomeia arquivos.
- A Zenovix CLI nunca move arquivos.
- A Zenovix CLI não limpa pastas nem executa limpeza automática.
- Nomes de comando destrutivos como
delete, archive, restore, cleanup, clean, remove, move, rename, empty-recycle-bin, dedupe e fix são rejeitados. - Use o aplicativo de desktop para os fluxos de limpeza, arquivamento, restauração e Recovery Centre baseados em revisão.
01 Instalação
Use o alias de execução do aplicativo da Microsoft Store
Instale ou atualize o Zenovix Storage Manager pela Microsoft Store. O pacote da Store inclui o alias de execução zenovix.exe, então o comando zenovix pode ser iniciado no Windows Terminal, no PowerShell, no Prompt de Comando ou no Agendador de Tarefas.
zenovix --help
zenovix --version
- Se o Windows não encontrar
zenovix, verifique Configurações do Windows > Aplicativos > Configurações avançadas de aplicativos > Aliases de execução de aplicativo. - Se o Pro não puder ser verificado, os comandos funcionais falham com segurança antes de escanear, informando que o Zenovix Pro não pôde ser verificado.
- Estados de licença Free e desconhecidos ainda mostram ajuda e versão, mas os comandos funcionais exigem o Pro.
02 Uso
Estrutura da linha de comando
O formato geral dos comandos é:
zenovix <command> [arguments] [options]
- Opções globais:
--help, -h, --version, --quiet, --json e --log <file>. - Comandos funcionais do Pro:
scan, compare, top, health, history e export. - Nomes reservados, como summary, growth, duplicates e insights, não são documentados como comandos públicos até serem implementados.
03 scan
Execute análises de armazenamento pela linha de comando
zenovix scan <path> [<path> ...] [options]
scan executa a análise de armazenamento em pastas, unidades, caminhos UNC, dispositivos NAS ou unidades conectadas. Use-o para relatórios agendados, workbooks de histórico e exportações.
- As opções incluem
--fast, --analysis, --history <file.xlsx>, --output <folder>, --json, --csv, --xlsx, --top-folders <n>, --include <pattern>, --exclude <pattern>, --recursive true|false, --quiet e --log <file>.
zenovix scan D:\Fotos
zenovix scan "\\servidor\Financeiro" --analysis --history "Storage History.xlsx"
zenovix scan D:\Dados --json
zenovix scan D:\Dados --xlsx --output "C:\Relatorios" --top-folders 25
04 Relatórios
Compare, classifique e exporte dados de varredura
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 a varredura mais recente com a anterior em um Storage History Workbook.top mostra as maiores pastas, arquivos ou extensões de um caminho ou workbook.export exporta a varredura mais recente de um Storage History Workbook.- Use
--count <n>, --json, --quiet e --log <file> onde houver suporte.
05 Workbook de histórico
Mantenha o histórico de armazenamento sem apagar dados antigos
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 são arquivos XLSX para análises de armazenamento repetidas ao longo do tempo.
- O workbook pode ser aberto em ferramentas compatíveis com Excel e analisado no Power BI.
- A Zenovix CLI pode criar e anexar dados ao workbook sem o Microsoft Excel instalado.
history repair mantém a estrutura do workbook sem excluir nem reescrever os dados históricos de varredura.
06 Health
Verifique a prontidão da varredura antes de trabalhos agendados
zenovix health <path> [options]
health verifica se um caminho pode ser escaneado.- Ele informa acesso, arquivos ignorados, caminhos longos, velocidade de varredura e uma estimativa da taxa de leitura.
- As opções incluem
--json, --quiet e --log <file>.
07 Automação
Exemplos com PowerShell e Agendador de Tarefas
Use o PowerShell para relatórios pontuais e o Agendador de Tarefas para trabalhos de varredura repetíveis.
zenovix scan D:\Dados --json | Out-File "C:\Relatorios\latest-storage.json" -Encoding utf8
zenovix top folders --history "C:\Relatorios\Storage History.xlsx" --count 20 --json
Programa/script: zenovix
Argumentos: scan "D:\Dados" --history "C:\Relatorios\Storage History.xlsx" --xlsx --output "C:\Relatorios" --quiet --log "C:\Relatorios\zenovix.log"
- Coloque entre aspas os caminhos com espaços de pastas, compartilhamentos de rede e workbooks.
- Use
--quiet em trabalhos agendados quando só precisar dos arquivos e logs. - Use
--log <file> para anexar registros de execução para solução de problemas posterior.
08 Saída
Saída em JSON, Excel e CSV
- Use
--json quando scripts ou monitoramento precisarem de saída estruturada na saída padrão. - Use
--csv para exportações tabulares leves. - Use
--xlsx para relatórios compatíveis com Excel e fluxos de histórico de armazenamento. - Use
--output <folder> para escolher a pasta de destino das exportações. - Use
--history <file.xlsx> para anexar uma varredura ou ler um workbook.
09 Códigos de saída
Resultados fáceis de automatizar
0 — Sucesso.1 — Argumentos inválidos ou comando destrutivo rejeitado.2 — Falha na varredura ou no comando.3 — Acesso negado.4 — Falha no workbook.5 — Erro interno.6 — O Zenovix Pro é necessário ou o estado Pro não pôde ser verificado.
FAQ Mais ajuda
Temas relacionados nas perguntas frequentes
As perguntas frequentes sobre a CLI respondem dúvidas comuns sobre acesso Free e Pro, PowerShell, Agendador de Tarefas, dispositivos NAS, caminhos UNC, Excel, Power BI e por que a limpeza continua sendo um fluxo do desktop.