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, Storage History Workbooks e bancos de dados ODBC.
- 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, export e profile. - 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 de relatórios em arquivos incluem
--history <file.xlsx>, --output <folder>, --json, --csv e --xlsx. - A saída ODBC usa
--output odbc --connection <DSN-ou-string-de-conexão>. Adicione --report-output <folder> quando os arquivos de relatório JSON, CSV ou XLSX combinados precisarem de um destino. - Outras opções de varredura incluem
--fast, --analysis, --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
zenovix scan D:\Dados --output odbc --connection "ZenovixHistory"
zenovix scan D:\Dados --output odbc --connection "ZenovixHistory" --xlsx --report-output "C:\Relatorios"
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.
PROFILE
Perfis salvos
Execute um plano de varredura do desktop pelo ID estável
zenovix profile run <profile-id> [--quiet] [--log <file>]
profile run executa um perfil criado na janela Planos de Varredura Agendados do aplicativo desktop.- O perfil salvo fornece caminhos, filtros, Storage History Workbook, relatórios JSON/CSV/XLSX e um destino ODBC opcional.
- O Agendador de Tarefas do Windows precisa apenas do ID estável; as configurações do perfil e os detalhes da conexão ODBC não aparecem na linha de comando da tarefa agendada.
- As opções de varredura e saída não podem ser substituídas em
profile run; edite o plano salvo no aplicativo desktop.
zenovix profile run 63fc6e99-42f7-47a7-9972-83ec998aab31 --quiet
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 JSON, CSV, XLSX, workbook e ODBC
- 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. - Use
--output odbc --connection <value> para anexar um snapshot imutável da varredura a um banco de dados ODBC. O valor pode ser um nome DSN ou uma string de conexão ODBC completa. - Use
--report-output <folder> para arquivos de relatório JSON, CSV ou XLSX quando --output odbc ocupar a opção de saída. - ODBC pode ser combinado com
--history, --json, --csv e --xlsx; todos os destinos usam o mesmo snapshot de varredura concluído.
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.7 — Falha na conexão ODBC, no esquema ou na gravação no banco; a transação foi revertida.8 — Falha na exportação do relatório JSON, CSV ou XLSX depois que a varredura foi concluída.
PRO
Planos de Varredura Agendados
Planos reutilizáveis, executados manualmente ou por agenda
Um Plano de Varredura Agendado salva juntos as fontes de varredura, as configurações e os destinos de relatório, para que você não precise configurá-los duas vezes. Os planos são um recurso Pro; o Zenovix cria e gerencia o agendamento por meio do Agendador de Tarefas do Windows.
- Crie, edite, duplique e remova planos reutilizáveis.
- Execute um plano sob demanda ou automaticamente conforme uma agenda.
- Ative, desative e gerencie cada agenda diretamente no Zenovix.
- Perfis de varredura salvos também podem ser executados pela CLI usando um ID de perfil estável.
DB
Storage History via ODBC
Exporte histórico imutável para um banco de dados
A exportação do Storage History via ODBC envia snapshots de varredura imutáveis para um banco de dados compatível com ODBC, para histórico de longo prazo, relatórios históricos e análise de tendências em ferramentas como o Power BI. Pode ser combinada com Storage History Workbooks e relatórios JSON, CSV ou XLSX.
- A interface aceita DSN, string de conexão completa ou arquivo de banco de dados com um driver ODBC de 64 bits instalado.
- O Zenovix detecta drivers e DSNs instalados; não inclui nem instala silenciosamente drivers de banco de dados.
- Usa gravações transacionais e evita duplicar o histórico quando uma execução é repetida.
- A área Storage History nas Configurações e a guia ODBC dos Planos de Varredura Agendados permitem salvar o destino, testar a conexão, validar o esquema e preparar o esquema.
- Destinos Microsoft Access recebem verificações de capacidade; nenhum limite universal de tamanho de arquivo é atribuído aos outros provedores.
- Quando o aplicativo desktop salva um destino ODBC, valores sensíveis como senhas são protegidos pelo Gerenciador de Credenciais do Windows. Um valor direto de
--connection na CLI é fornecido para aquela execução.
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.