OODCMD 命令參考
語法:
OODCMD <command> [drive ...] [options]
命令和方法名稱不區分大小寫。下表列出標準名稱;已安裝版本的具體用法以 OODCMD help 為準。
命令
| 命令 | 作用 |
|---|---|
analyze <drive ...> | 分析所選磁碟機,不移動檔案。 |
defrag <drive ...> | 預設使用 SOLID/Quick,或使用 --method 指定的最佳化方法。 |
<method> <drive ...> | 執行下表列出的一種方法。 |
list | 列出代理程式識別的磁碟機。 |
status [drive ...] | 顯示磁碟機的狀態和碎片程度;省略磁碟機參數可檢視所有可用磁碟機。 |
status [drive ...] --follow | 持續顯示正在執行的操作,直至結束。 |
stop <drive ...> | 停止所選磁碟機上正在執行的操作。 |
pause <drive ...> | 在暫停和執行狀態之間切換。 |
resume <drive ...> | pause 的別名,同樣會切換狀態。 |
license | 顯示授權狀態;不能用此命令輸入授權。 |
version | 顯示版本號碼。 |
help [topic] | 顯示一般說明,或指定 methods、exitcodes、examples 或某個方法名稱檢視相關說明。 |
暫停命令會切換狀態。 使用 pause 或 resume 前請先檢查狀態。重複呼叫 resume 可能會再次暫停操作。
方法
| 命令名稱 | 最佳化方法 |
|---|---|
solid-quick | SOLID/Quick,也是 defrag 的預設方法。 |
solid | SOLID/Complete。 |
stealth | STEALTH。 |
space | SPACE。 |
complete-name | COMPLETE/Name。 |
complete-modified | COMPLETE/Modified。 |
complete-access | COMPLETE/Access。 |
optimize | OPTIMIZE;需啟用區域。 |
optimize-quick | OPTIMIZE/Quick;需啟用區域。 |
optimize-complete | OPTIMIZE/Complete;需啟用區域。 |
常見別名包括 quick(對應 solid-quick)和 solid-complete(對應 solid)。建議在指令碼中使用標準名稱。使用 help methods 可檢視目前版本支援的別名。
選項
| 選項 | 作用 |
|---|---|
-m, --method <name> | 指定 defrag 使用的最佳化方法。 |
-n, --no-wait | 代理程式接受操作後立即返回。 |
-f, --follow | 使 status 持續追蹤正在執行的操作。 |
-i, --interval <seconds> | 設定進度更新間隔,預設為 2 秒。 |
-t, --timeout <seconds> | 設定連線代理程式的逾時時間,預設為 30 秒。 |
-v, --verbose | 在資訊可用時,顯示目前檔案、負載和磁碟機詳情。 |
-q, --quiet | 隱藏一般進度資訊,保留警告、錯誤及最終結果。 |
更新間隔和連線逾時均接受 1 至 3600 的整數秒數。逾時值僅用於連線代理程式,不限制最佳化的總執行時間。
不指定 --no-wait 時,分析和最佳化命令會等待操作完成。指定 --no-wait 時,成功僅表示代理程式已接受請求。
中斷正在等待的命令
等待期間按 Ctrl+C,會請求停止本次命令啟動的操作。再次按 Ctrl+C 將立即結束,此時操作可能仍在代理程式中執行。請隨後檢查狀態。
單獨執行的 status --follow 用於觀察現有操作。關閉觀察命令不會自動停止其他命令啟動的工作。
結束代碼
| 代碼 | 意義 |
|---|---|
| 0 | 成功:操作已完成,或在使用 --no-wait 時表示請求已被接受。 |
| 1 | 命令列無效。 |
| 2 | 授權處於試用狀態、遺失、已過期或無效。 |
| 3 | 代理程式不可用。 |
| 4 | 磁碟機未知或不可選。 |
| 5 | 操作未啟動,例如磁碟機正忙、未啟用區域或未收到確認。 |
| 6 | 操作未完成,包括停止或暫停未獲確認。 |
| 7 | 因按下 Ctrl+C 而中斷。 |
| 8 | 等待期間連線中斷。 |
| 9 | 意外錯誤。 |
OODCMD 結束後,請立即在命令提示字元中讀取 %ERRORLEVEL%,或在 PowerShell 中讀取 $LASTEXITCODE。