UUPdump 脚本配置选项详解
更新时间: 2025/9/22 | 总字数: 0 字 | 阅读时长: 0 分钟
简单说明
通过 uupdump 下载镜像 教程,我们获取到了下载脚本,其初始目录结构如下:

目录及文件简单说明:
files 文件夹:下载脚本执行所需的文件及调用脚本。ConvertConfig.ini:转换选项配置文件,可按需定义构建及镜像转换配置。CustomAppsList.txt:自定义商店应用构建配置,控制系统默认安装哪些商店应用。uup_download_*.cmd/sh:对应平台执行脚本。
配置选项
如上所述,可通过修改 ConvertConfig.ini 来调整构建,这里就针对配置选项进行逐一说明,内容参考自 uupdump 官方。
UUP 转换选项 对应 convert_UUP 块
| 选项名称 | 选项描述 |
|---|---|
| AutoStart | 直接启动转换过程,无需提示。 1:使用 install.wim 创建 ISO。2:使用 install.esd 创建 ISO。3:仅创建 install.wim 文件。4:仅创建 install.esd 文件。 |
| AddUpdates | 检测到更新后的集成方式: 0:关闭。 1:将更新集成至 install.wim 文件中(需要 ADK)。2:将更新从外部添加到 ISO 分发中(17763及更高版本)。 |
| Cleanup | 集成模式(AddUpdates=1 )下的映像清理,并将增量压缩被取代的组件。1:开启;0:关闭 |
| ResetBase | 进一步删除被取代的组件,仅当 Cleanup 开启时有效,由于此选项破坏了 "重置此电脑" 功能,对于内部版本 18362 及更高版本,自动禁用 Full ResetBase。1:开启;0:关闭 |
| NetFx3 | 集成 .NET 3.5 功能1:开启;0:关闭 |
| StartVirtual | 转换完成后启动 create_virtual_editions.cmd 进行虚拟升级版本添加。1:开启;0:关闭 |
| wim2esd | 将 install.wim 转换为 install.esd。1:开启;0:关闭 |
| wim2swm | 将 install.wim 拆分为多个 install.swm。1:开启;0:关闭 |
| SkipISO | 跳过创建 ISO 文件 。1:开启;0:关闭 |
| SkipWinRE | 跳过集成 winre.wim 到 install.wim/esd。1:开启;0:关闭 |
| LCUwinre | 强制更新 winre.wim 使用累计更新,即使检测到 SafeOS 更新。注意: Windows 11 build 22000 及后续版本,此项将自动启用,可设置为 2 以禁用。 |
| LCUmsuExpand | 扩展累积更新,并通过 update.mum 从松散的文件安装,而不是添加直接的 MSU文件。注意: Windows 11 build 22000 及后续版本,此项将自动启用,可设置为 2 以禁用。内部版本 26052 及以后自动禁用。 |
| UpdtBootFiles | 使用累计更新中的新文件更新 ISO 启动文件1:开启;0:关闭 |
| ForceDism | 使用 DISM 官方方法创建 boot.wim 。(需要 ADK)1:开启;0:关闭 |
| RefESD | 保留转换后的 ESD 文件以备将来操作,而不是每次都转换它们。 1:开启;0:关闭 |
| SkipLCUmsu | 跳过内部版本 21382 到 25330 创建累计更新 MSU(使用旧版 cab+psf 提取添加 LCU)。1:开启;0:关闭 |
| SkipEdge | 跳过添加 Microsoft Edge Chromium。 1: 不要将 Edge 与 Windows 10 的累计更新集成。2:通过替代解决方法使用 Windows 10 的累计更新跳过 Edge(可能无效)。此项仅适用于开启选项 AddUpdates=1 。 |
| AutoExit | 完成后自动退出转换过程(脚本),不提示。 1:开启;0:关闭 |
| DisableUpdatingUpgrade | 使用版本升级(家庭版-> 专业版等)禁用更新过程优化,并对每个版本执行单独的更新。 1:开启;0:关闭 |
商店应用选项 对应 Store_Apps 块
提示
以下选项仅适用于内部版本 22563 及更高版本!!!
| 选项名称 | 选项描述 |
|---|---|
| SkipApps | 跳过商店应用 1:开启;0:关闭 |
| AppsLevel | 控制添加客户端应用,注:选项 4 不适用 N 版:0:添加所有引用的应用程序 1:添加商店应用、安全运行状况、应用程序安装程序 2:添加 1 级应用 + 照片、相机、记事本、画图 3:添加 2 级应用 + 终端、小部件、邮件/Outlook、Chipchamp 4:添加 3 级应用 + 媒体应用(音乐、视频、编解码器、Phone Link) |
| StubAppsFull | 0:安装为存根应用程序 1:安装为完整应用程序 |
| CustomList | 使用 CustomAppsList.txt 或 CustomAppsList2.txt 来选择添加的应用程序,若启用此项,AppsLevel 选项则失效。1:开启;0:关闭 |
虚拟版本选项 对应 create_virtual_editions 块
关于虚拟升级版本更多信息,请求参考:虚拟升级对照表 。
| 选项名称 | 选项描述 |
|---|---|
| vUseDism | 虚拟升级版本创建方法: 0:注册表操作,支持任何主机操作系统 1:官方 DISM 方式,需要 NT 10.0 系统。2:强制使用 DISM,适用于 Windows 7 / 8系统。注:当选择为 1 或 2 时,操作系统匹配,但未安装 Windows ADK 或 源文件为 install.esd 时,自动使用选项 0 |
| vAutoStart | 直接启动创建过程,无需提示。 1:开启;0:关闭 |
| vDeleteSource | 不保留源版本,例如:创建 Enterprise 并删除 Pro 1:开启;0:关闭 |
| vPreserve | 保留源分发文件夹 0:直接修改源分发文件夹 1:复制并修改源分发文件夹 |
| vwim2esd | 将 install.wim 转换为 install.esd。1:开启;0:关闭 |
| vwim2swm | 将 install.wim 拆分为多个 install.swm。1:开启;0:关闭 |
| vSkipISO | 不创建ISO 文件,结果分发文件夹将保留1:开启;0:关闭 |
| vAutoEditions | 指定自动创建版本,多个用逗号分隔,留空则创建所有可能的目标版本,支持版本:Enterprise、Education、ProfessionalEducation、ProfessionalWorkstation、CloudEdition、ServerRdsh、IoTEnterprise、IoTEnterpriseK、EnterpriseN、EducationN、ProfessionalEducationN、ProfessionalWorkstationN、CloudEditionN、CoreSingleLanguage、IoTEnterpriseS、IoTEnterpriseSK |
自定义商店应用
推荐应用
修改 CustomAppsList.txt ,以调整系统默认安装应用,推荐应用如下:
ini
Microsoft.WindowsStore_8wekyb3d8bbwe # Microsoft Windows 商店
Microsoft.StorePurchaseApp_8wekyb3d8bbwe # 用于管理 Microsoft 商店购买记录的应用程序
Microsoft.SecHealthUI_8wekyb3d8bbwe # Windows 安全与健康应用程序
Microsoft.DesktopAppInstaller_8wekyb3d8bbwe # 可用于安装和管理应用程序的工具
Microsoft.Windows.Photos_8wekyb3d8bbwe # 照片应用
Microsoft.WindowsNotepad_8wekyb3d8bbwe # 记事本应用
Microsoft.WindowsTerminal_8wekyb3d8bbwe # Windows Terminal(新终端工具)
Microsoft.WindowsCalculator_8wekyb3d8bbwe # 计算器
Microsoft.VP9VideoExtensions # VP9 视频扩展支持(HDR和VP9视频预览)也可以根据需求自行调整,其他应用说明参考:微软自带应用映射表 。