UnattendTool/README.md

UnattendTool 简介

• 生成 Windows 系统自动安装应答文件 Unattend.xml
• 支持 Ventoy
• 只支持 Windows 10 或 Windows 11

下载

从如下链接下载最新的版本：UnattendTool_版本号.zip

https://github.com/dsx42/UnattendTool/releases

如何使用本工具？

有如下两种使用场景：

当前电脑要安装系统

• 在当前电脑安装系统前，把下载的文件解压到当前电脑
• 鼠标左键双击运行解压后的 UnattendTool.cmd 文件，根据提示操作
  • 提示包含当前电脑的信息，可以直接参考

其他电脑要安装系统

• 把下载的文件解压到当前电脑
• 鼠标左键双击运行解压后的 UnattendTool.cmd 文件，根据提示操作
  • 提示包含当前电脑的信息，不是将要安装系统的电脑信息，不可以作为参考
  • 必须了解要安装系统的电脑信息，并合理设置

生成的应答文件在哪里？

• 默认情况下，在 %userprofile%\Desktop\ventoy\script\ 目录下
• 若指定了应答文件目录，则在指定目录下的 ventoy\script\ 目录下

生成的应答文件如何使用？

和 Venoty 一起使用

如下步骤 3 和步骤 4 可通过本工具完成

1. 准备一个 U 盘，用 Ventoy 制作成启动盘，详见：https://www.ventoy.net/cn/doc_start.html
2. 把 Windows 系统 ISO 镜像文件复制到 U 盘
3. 把应答文件复制到 U 盘
4. 修改 U 盘下的 Ventoy 配置文件 ventoy\ventoy.json，让镜像文件关联应答文件，详见：https://www.ventoy.net/cn/plugin_autoinstall.html
5. U 盘插入要安装系统的电脑，该电脑关机重启，进入 BIOS，修改为启动进入 U 盘
6. 进入 Ventoy 选择镜像的页面，选择要安装的镜像，选择要使用的应答文件

和 setup.exe 一起使用

1. 把 Windows 系统 ISO 镜像文件解压到指定目录
2. 把应答文件复制到解压后的目录
3. 进入解压后的目录，命令行下运行 setup.exe /unattend:应答文件名称 即可安装系统

支持的选项

UnattendTool.ps1 支持非交互式运行

.\UnattendTool.ps1 -Version

.\UnattendTool.ps1 -Interactive

.\UnattendTool.ps1
    [-Language String]
    [-OsVersion int]
    [-WindowsProductName String]
    [-Architecture String]
    [-DiskId int]
    [-PartitionID int]
    [-PartitionStyle String]
    [-FullName String]
    [-Password String]
    [-VentoyDriverLetter String]
    [-ISOPath String]
    [-NotFormat]

• -Version：返回当前工具的版本号
• -Interactive：交互模式运行，作用和鼠标左键双击运行 UnattendTool.cmd 文件一样的效果
• -Language String：要安装系统的语言，只支持如下两个值：
  • 'zh-CN'：简体中文；默认值
  • 'en-US'：英文
• -OsVersion int：要安装系统的版本，只支持如下两个值：
  • 11：Windows 11；默认值
  • 10：Windows 10
• -WindowsProductName String：要安装系统的产品，支持如下值：
  • 'Enterprise'：企业版；默认值
  • 'Education'：教育版
  • 'Pro'：专业版
  • 'Pro Education'：专业教育版
  • 'Pro For Workstations'：专业工作站版
  • ''：空字符串，表示非上述的其他版本
• -Architecture String：要安装系统的架构，只支持如下两个值：
  • 'x64'：64 位系统；默认值
  • 'x86'：32 位系统；注意，Windows 11 只有 64 位系统
• -DiskId int：要安装系统的硬盘编号，硬盘编号从 0 开始；默认为 -1，表示自动选择当前操作系统所在的硬盘
• -PartitionID int：要安装系统的分区编号，分区编号从 1 开始；默认为 -1，表示自动选择当前操作系统所在的分区
• -PartitionStyle String：未指定 -NotFormat 时，需要指定该参数，表示要安装系统的硬盘的分区类型，只支持如下两个值：
  • GPT：GPT 分区；默认值
  • MBR：MBR 分区
• -FullName String：系统安装后的登录账号名；推荐英文字母或数字的组合，尽量不使用中文或其他特殊字符；默认为 'MyPC'
• -Password String：系统安装后的登录账号密码；推荐不设置密码，系统安装后再自行设置密码；默认无密码
• -VentoyDriverLetter String：已安装 Ventoy 的 U 盘驱动器；默认为当前用户的桌面
• -ISOPath String：使用应答文件的 ISO 镜像文件的路径；默认未指定
• -NotFormat：安装系统时不格式化所选硬盘分区；默认安装时会格式化所选硬盘分区

参考资料

• Windonws 11 应答文件必须的内容：https://docs.microsoft.com/en-us/windows-hardware/manufacture/desktop/automate-windows-setup?view=windows-11
• 应答文件组件介绍：https://docs.microsoft.com/en-us/windows-hardware/customize/desktop/unattend/components-b-unattend
• 在线应答文件生成器：https://www.windowsafg.com/index.html
• Ventoy 使用：https://www.ventoy.net/cn/doc_start.html
• Ventoy 自动安装：https://www.ventoy.net/cn/plugin_autoinstall.html