tiny11builder「oscdimg.exe not found」构建失败:两条路径完整修复指南
2026/9/10 7:30:06 网站建设 项目流程

tiny11builder「oscdimg.exe not found」构建失败:两条路径完整修复指南

【免费下载链接】tiny11builderScripts to build a trimmed-down Windows 11 image.项目地址: https://gitcode.com/GitHub_Trending/ti/tiny11builder

运行tiny11maker.ps1走到最后生成 ISO 的环节时卡死,报oscdimg.exe not found。原因几乎都是同一个:脚本找不到它需要的oscdimg.exe。这是脚本打包 ISO 必需的工具,补上这一个点,构建就能跑完。最短路径:先按下面自检表决定放单文件还是装完整 ADK,再按步骤执行。

「oscdimg.exe not found」卡在流程哪一步

oscdimg.exe负责整个构建的最后一步:把处理完的构建目录打包成可引导的tiny11.iso。它相当于流水线末端的封箱工位——前面的镜像拷贝、删应用、改注册表、压缩导出都完成了,封箱工位没机器,产品就出不去。

脚本的查找顺序见 tiny11maker.ps1:先查系统 ADK 的Deployment Tools\<架构>\Oscdimg目录,存在就用 ADK 版;否则用脚本目录里的oscdimg.exe,还没有就尝试联网下载。失败链条是:ADK 未安装 → 回落到本地文件 → 本地没有且下载失败 →oscdimg.exe not found→ 构建中断。

用自检表决定装 ADK 还是放单文件

自检点是 →否 →
是否长期做 Windows 镜像构建走路径 B(装完整 ADK)走路径 A(单文件)
机器能否连通微软符号服务器路径 A 可依赖脚本自动下载手动把文件拷进脚本目录
机器有管理员权限装软件吗可走路径 B只能走路径 A

按行锁定一条路径,不要两条都做。

路径 A:把单个oscdimg.exe放进脚本目录

适用场景:偶尔构建一次,不想装几 GB 的 ADK。前置条件:PowerShell 5.1;构建需要以管理员运行(脚本非管理员时会自动重启窗口)。

  1. 进入脚本所在目录,确认主文件在场。
dir tiny11maker.ps1

成功标志:输出里包含tiny11maker.ps1

  1. 检查oscdimg.exe是否已存在。
dir oscdimg.exe

存在就跳过下一步,直接去验证章节;不存在再执行第 3 步。

  1. 让文件落进目录。网络可用就直接跑构建,脚本到 ISO 环节会自动下载;网络受限时,从另一台装了 ADK 的机器上把Oscdimg目录里的oscdimg.exe拷到本目录。

✅ 成功标志:日志出现下载完成的提示,或dir能看到该文件。

注意:脚本构建成功后会自动删掉oscdimg.exe,事后看不到该文件属正常现象。

路径 B:装完整 Windows ADK 部署工具

适用场景:机器长期构建镜像,或还需要 ADK 的其他部署工具。前置条件:管理员权限,约 5 GB 磁盘空间。

  1. 安装 Windows ADK,功能里只勾「部署工具(Deployment Tools)」,其余不勾。
  2. 验证脚本真正会读取的路径(架构名由$env:PROCESSOR_ARCHITECTURE拼出):
Test-Path "C:\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit\Deployment Tools\$env:PROCESSOR_ARCHITECTURE\Oscdimg"

✅ 成功标志:输出True,且构建到 ISO 环节时日志打印Will be using oscdimg.exe from system ADK.

脚本会自动探测该路径,不需要配置任何环境变量。

跑两级测试确认修好

最小验证:直接执行你补好的工具,看是否打印用法。把下面路径换成你的实际路径(脚本目录或 ADK 目录)。

& "C:\path\to\oscdimg.exe" /?

成功标志:打印出Usage: oscdimg /m|/v /o ...一行的用法说明

完整验证:挂载 Windows 11 安装 ISO 后(挂载方法见 README.md),端到端跑一遍。

Set-ExecutionPolicy Bypass -Scope Process .\tiny11maker.ps1 -ISO E -SCRATCH D

成功标志:脚本目录出现tiny11.iso(约 3~5 GB),窗口打印Creation completed!

排障速查

现象可能原因处置动作
oscdimg.exe not foundADK 未装且自动下载失败,脚本目录无文件按路径 A 三步走,先落文件再跑构建
日志出现Downloading oscdimg.exe...后卡死或超时连不通符号服务器(网络受限/代理)从装了 ADK 的机器拷贝oscdimg.exe到脚本目录
ADK 装好了仍报找不到架构目录名不匹配(arm64 机器指到 amd64)重跑路径 B 的Test-Path确认实际路径
oscdimg.exe存在但报缺 DLL / Win32 错误文件不完整(下载中断)删掉重新下载,或从 ADK 拷贝完整文件
tiny11.iso生成了但无法引导源 ISO 损坏或缺引导文件校验源 ISO 完整性,重新跑完整构建

oscdimg.exe是脚本自动定位的工具,放进脚本目录或 ADK 目录任一位置,构建就能通过最后一关。

【免费下载链接】tiny11builderScripts to build a trimmed-down Windows 11 image.项目地址: https://gitcode.com/GitHub_Trending/ti/tiny11builder

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询