windows_cli . Ventoy

Windows 命令行

1. 背景介绍

从 Ventoy 1.0.86 版本开始，支持在 Windows 命令行模式下调用执行安装、升级操作。

2. 使用方法

命令行格式如下：（参数不区分大小写）

Ventoy2Disk.exe VTOYCLI CMD DISK [Options]

必选参数	说明
`参数1`	必须固定为 `VTOYCLI`
`参数2`	命令字。`/I` 或 `/U` 分别对应安装和升级。
`参数3`	指定磁盘。有2种形式，`/Drive:F:` 或 `/PhyDrive:1` ，即按照盘符指定或者是按照硬盘编号指定。

可选参数	说明
`/GPT`	安装时使用 GPT 分区格式。不指定的话默认使用 MBR 格式。
`/NOSB`	不使能安全启动支持选项。安装、升级时均可指定。默认不管安装还是升级都是会使能这个选项。
`/NOUSBCheck`	安装时不检查是否为USB类型。为了安全起见，默认情况下安装时如果发现对应的盘不是USB类型，则会返回失败。
`/R:XXX`	安装时在磁盘最后保留一部分空间。后面的数字 `XXX` 表示保留的空间大小，单位是MB。比如 `/R:2048` 表示保留 2GB 空间。
`/FS:XXX`	安装时选择文件系统。NTFS/EXFAT/FAT32 等。
`/NonDest`	进行无损安装。具体参考关于无损安装

使用示例：

Ventoy2Disk.exe VTOYCLI /U /Drive:D:
Ventoy2Disk.exe VTOYCLI /U /PhyDrive:1

Ventoy2Disk.exe VTOYCLI /I /Drive:D:
Ventoy2Disk.exe VTOYCLI /I /Drive:D: /GPT /NOUSBCheck
Ventoy2Disk.exe VTOYCLI /I /PhyDrive:2 /GPT /NOUSBCheck /NOSB /R:4096

3. 执行结果

在命令行模式下，Ventoy 执行过程中会生成以下 3 个文件。

文件名称	文件内容
`cli_log.txt`	记录整个安装或升级过程的详细日志信息。
`cli_percent.txt`	安装或升级进度百分比。
`cli_done.txt`	安装或升级完成的标记。此文件出现则表示执行完成。文件内容为 0 表示成功、内容为 1 表示失败。