CLI
概要
Zenovix CLI は何のためにあるのか
Windows のコマンド ラインによる反復可能なストレージ分析、PowerShell でのレポート、スケジュールされた分析、NAS スキャン、UNC パス、ストレージ履歴ワークブック、または Excel、Power BI、およびその他のレポート ツールへのエクスポートに CLI を使用します。
- Zenovix Pro で利用可能です。
- 読み取り専用の分析およびレポート コマンドを実行します。
- フォルダー、ドライブ、UNC パス、NAS デバイス、接続されたドライブを操作します。
- JSON、CSV、XLSX、Storage History Workbook、および ODBC データベースに出力できます。
- PowerShell、スクリプト、Windows タスク スケジューラから呼び出すことができます。
- 無料ユーザーは、
zenovix --help および zenovix --version を実行できます。
SAFE
セキュリティモデル
CLI はクリーンアップを実行しません
CLI は意図的に読み取り専用です。コマンド ラインの自動化は分析とレポート作成に役立ちますが、クリーンアップはデスクトップ アプリケーションに残り、レビュー ステータス、ファイル選択、リカバリ プレビュー、リカバリ ログが表示されたままになります。
- Zenovix CLI はファイルを削除しません。
- Zenovix CLI はファイルをアーカイブしません。
- Zenovix CLI はファイルを回復しません。
- Zenovix CLI はファイルの名前を変更しません。
- Zenovix CLI はファイルを移動しません。
- Zenovix CLI はフォルダーをクリーンアップしたり、自動クリーンアップを実行したりしません。
delete、archive、restore、cleanup、clean、remove、move、renameなどの破壊的なコマンド名empty-recycle-bin、dedupe、および fix は拒否されました。- デスクトップ アプリケーションを使用して、レビューベースのクリーンアップ、アーカイブ、復元、およびリカバリ センター フローを実行します。
01
インストール
Microsoft Store アプリ実行エイリアスを使用する
Microsoft Store から Zenovix Storage Manager をインストールまたは更新します。 Store パッケージには実行エイリアス zenovix.exe が含まれているため、コマンド zenovix を Windows ターミナル、PowerShell、コマンド プロンプト、またはタスク スケジューラで実行できます。
zenovix --help
zenovix --version
- Windows で
zenovix が見つからない場合は、[Windows の設定] > [アプリケーション] > [アプリケーションの詳細設定] > [アプリケーション実行エイリアス] を確認します。 - Pro を検証できない場合、機能コマンドはスキャン前に安全に失敗し、Zenovix Pro が検証できないという通知が表示されます。
- 無料および不明のライセンス ステータスには引き続きヘルプとバージョンが表示されますが、機能的なコマンドには Pro が必要です。
コマンドの一般的な形式は次のとおりです。
zenovix <command> [arguments] [options]
- グローバル オプション:
--help、-h、--version、--quiet、--json、および --log 。 - Pro 機能コマンド:
scan、compare、top、health、history、export、および profile。 - Summary、Growth、Duplicates、Insights などの予約名は、実装されるまでパブリック コマンドとして文書化されません。
03
スキャン
コマンドライン経由でストレージ分析を実行する
zenovix scan <path> [<path> ...] [options]
scan は、フォルダー、ドライブ、UNC パス、NAS デバイス、または接続されたドライブのストレージ分析を実行します。スケジュールされたレポート、履歴ワークブック、エクスポートに使用します。
- ファイル レポートのオプションは、
--history <file.xlsx>、--output <folder>、--json、--csv、--xlsx です。 - ODBC 出力には
--output odbc --connection <DSN-or-connection-string> を使用します。JSON、CSV、XLSX のレポート ファイルも保存する場合は --report-output <folder> を追加します。 - その他のスキャン オプションは、
--fast、--analysis、--top-folders <n>、--include <pattern>、--exclude <pattern>、--recursive true|false、--quiet、--log <file> です。
zenovix scan D:\Data
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
レポート
スキャンデータの比較、並べ替え、エクスポート
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 は、ストレージ履歴ワークブック内の最新のスキャンと以前のスキャンを比較します。top は、パスまたはワークブックの最大のフォルダー、ファイル、または拡張子を表示します。export は、ストレージ履歴ワークブックから最新のスキャンをエクスポートします。- サポートされている場合は、
--count 、--json、--quiet、および --log を使用します。
05
歴史ワークブック
古いデータを削除せずにストレージ履歴を維持します
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>]
- ストレージ履歴ワークブックは、長期間にわたって繰り返されるストレージ分析用の XLSX ファイルです。
- ブックは Excel 互換ツールで開き、Power BI で分析できます。
- Zenovix CLI は、Microsoft Excel がインストールされていなくても、データを作成してワークブックに追加できます。
履歴修復は、スキャン履歴データを削除または書き換えることなく、ワークブックの構造を保持します。
PROFILE
保存済みプロファイル
安定した ID でデスクトップのスキャン プランを実行
zenovix profile run <profile-id> [--quiet] [--log <file>]
profile run は、デスクトップ アプリのスケジュール スキャン プラン画面で作成したプロファイルを実行します。- 保存済みプロファイルから、スキャン パス、フィルター、Storage History Workbook、JSON・CSV・XLSX レポート、および任意の ODBC 出力先が読み込まれます。
- Windows タスク スケジューラに必要なのは安定したプロファイル ID だけです。プロファイル設定と ODBC 接続情報は、スケジュール タスクのコマンド ラインに置かれません。
profile run ではスキャンや出力のオプションを上書きできません。保存済みプランはデスクトップ アプリで編集します。
zenovix profile run 63fc6e99-42f7-47a7-9972-83ec998aab31 --quiet
06
健康
スケジュールされたタスクの前にスキャンの準備ができているかを確認する
zenovix health <path> [options]
health は、パスをスキャンできるかどうかを確認します。- このコマンドは、アクセス、スキップされたファイル、パスの長さ、スキャン速度、および推定読み取り速度をレポートします。
- オプションには、
--json、--quiet、および --log が含まれます。
07
自動化
PowerShell とタスク スケジューラを使用した例
ワンショット レポートには PowerShell を使用し、反復可能なスキャン タスクにはタスク スケジューラを使用します。
zenovix scan D:\Data --json | Out-File "C:\Laporan\latest-storage.json" -Encoding utf8
zenovix top folders --history "C:\Laporan\Storage History.xlsx" --count 20 --json
Program/skrip: zenovix
Argumen: scan "D:\Data" --history "C:\Laporan\Storage History.xlsx" --xlsx --output "C:\Laporan" --quiet --log "C:\Laporan\zenovix.log"
- フォルダー、ネットワーク共有、およびワークブックのパスは引用符で囲み、スペースを空けてください。
- ファイルとログのみが必要な場合は、スケジュールされたタスクで
--quiet を使用します。 - 将来のトラブルシューティングのために実行ログを追加するには、
--log を使用します。
08
出力
JSON、CSV、XLSX、ワークブック、ODBC 出力
- スクリプトまたはモニタリングで標準出力に構造化された出力が必要な場合は、
--json を使用します。 - 軽量の表形式のエクスポートには、
--csv を使用します。 - Excel 互換レポートと保存履歴フローには
--xlsx を使用します。 --output <folder> を使用して、エクスポート先フォルダーを選択します。--history <file.xlsx> を使用して、スキャン結果をワークブックへ追加するか、ワークブックから読み取ります。--output odbc --connection <value> を使用して、変更不可のスキャン スナップショットを ODBC データベースへ追加します。値には DSN 名または完全な ODBC 接続文字列を指定できます。--output odbc が出力オプションを使用している場合、JSON、CSV、XLSX のレポート ファイルには --report-output <folder> を使用します。- ODBC は
--history、--json、--csv、--xlsx と組み合わせることができ、すべての出力先で同じ完了済みスキャン スナップショットが使用されます。
0 — 成功。1 — 無効な引数または破壊的なコマンドが拒否されました。2 — スキャンまたはコマンドが失敗しました。3 — アクセスが拒否されました。4 — ワークブックが失敗しました。5 — 内部エラー。6 — Zenovix Pro が必要であるか、Pro ステータスを確認できません。7 — ODBC 接続、スキーマ、またはデータベース書き込みに失敗し、トランザクションがロールバックされました。8 — スキャン完了後の JSON、CSV、または XLSX レポートのエクスポートに失敗しました。
PRO
スケジュール スキャン プラン
再利用可能なプランを手動またはスケジュールで実行
スケジュール スキャン プランは、スキャン ソース、スキャン設定、レポートの出力先をまとめて保存するため、二度設定する必要がありません。プランは Pro 機能で、Zenovix が Windows タスク スケジューラを通じてスケジュールを作成・管理します。
- 再利用可能なプランの作成・編集・複製・削除ができます。
- プランを必要なときに手動で、またはスケジュールで自動的に実行できます。
- 各スケジュールを Zenovix から直接、有効化・無効化・管理できます。
- 保存済みスキャン プロファイルは、安定したプロファイル ID を使って CLI からも実行できます。
DB
ODBC ストレージ履歴
変更不可の履歴をデータベースにエクスポート
ODBC ストレージ履歴エクスポートは、変更不可のスキャン スナップショットを ODBC 互換データベースに送信し、長期的な履歴、履歴レポート、Power BI などのツールでの傾向分析に利用できます。Storage History Workbooks や JSON・CSV・XLSX レポートと組み合わせることもできます。
- 画面では、インストール済みの 64 ビット ODBC ドライバーを使い、DSN、完全な接続文字列、またはデータベース ファイルを選択できます。
- Zenovix はインストール済みのドライバーと DSN を検出しますが、データベース ドライバーを同梱したり自動インストールしたりしません。
- トランザクション書き込みを使用し、再試行時の履歴重複を回避します。
- 設定の Storage History 領域とスケジュール スキャン プランの ODBC タブでは、出力先の保存、接続テスト、スキーマ検証、スキーマ準備を行えます。
- Microsoft Access の出力先では容量を確認します。他のプロバイダーに共通のファイル サイズ上限があるとは説明しません。
- デスクトップ アプリで ODBC 出力先を保存すると、パスワードなどの機密値は Windows 資格情報マネージャーで保護されます。CLI で直接指定する
--connection の値は、そのコマンド実行に対して渡されます。
CLI に関するよくある質問では、無料およびプロ アクセス、PowerShell、タスク スケジューラ、NAS デバイス、UNC パス、Excel、Power BI、およびクリーンアップがデスクトップ フローのままである理由に関するよくある質問に答えます。