您现在的位置: 365建站网 > 365文章 > msiexec 静默安装命令怎么写?/qn、/passive 与 /L 日志开关的区别

msiexec 静默安装命令怎么写?/qn、/passive 与 /L 日志开关的区别

文章来源:365jz.com 点击数:365 更新时间:2024-09-06 09:05

一、先分清三个最容易混的静默开关

“静默安装”在 msiexec 里其实对应三个不同的官方定义,用错一个就会出现“明明写了参数,屏幕上还是弹出向导”的情况。Microsoft Learn 的参数表写得很细:

  • /quiet:指定静默模式,也就是不需要任何用户交互。
  • /passive:指定无人值守模式,也就是安装过程只显示一个进度条。
  • /qn:指定安装过程中没有 UI。

差别在“有没有可见的东西”和“会不会等人点按钮”两轴上:/passive 是有进度条但不需要人操作;/qn 是完全不画界面;/quiet 官方描述的是“无交互”这一属性。文档在开头也给了选择依据:如果要把包分发给所有客户端做手工安装,应该用完整 UI;而通过组策略部署时要求没有用户交互,就应当完全不涉及 UI。

其余几个变体按表格:/qn+ 是无 UI 但最后弹一个对话框;/qb 是基本 UI;/qb+ 是基本 UI 加结尾对话框;/qr 缩减 UI;/qf 完整 UI。备注里还有一个细节:如果安装被用户取消,则不会显示模态框;可以用 /qb+! 或 /qb!+ 隐藏 CANCEL 按钮。也就是说那个感叹号是专门用来去掉取消按钮的。

msiexec 显示级别、重启控制与日志开关一览

二、装完到底会不会重启:/norestart 只保证“不重启”

这是运维最常踩的点。官方对重启开关的定义:

  • /norestart:阻止设备在安装完成后重启。
  • /promptrestart:如果需要重启则提示用户。
  • /forcerestart:安装完成后重启设备。

请注意 /norestart 的措辞是“阻止重启”,不是“不需要重启”。文档在 Restart options 开头说明了前提:如果你的安装包会覆盖文件、或者试图修改正在被使用的文件,可能在安装完成前就需要重启。换句话说,安装本身仍然可能返回“需要重启”的状态码,只是 msiexec 没有真的把机器重启掉。批量部署时的正确姿势是 /qn 配 /norestart,然后由外层脚本按退出码去排重启窗口,而不是指望加个 /norestart 就没有重启需求。

三、安装失败没有日志等于没有诊断:/L 的 14 个字母

官方 Logging options 把 /L 后面的每个字母都单独定义了含义,这一节是最该抄下来的部分:

开关官方说明
/li开启日志并在输出日志文件中包含状态消息。
/lw包含非致命警告。
/le包含所有错误消息。
/la包含某个操作何时启动的信息。
/lr包含操作专属记录。
/lu包含用户请求信息。
/lc包含初始 UI 参数。
/lm包含内存不足或致命退出信息。
/lo包含磁盘空间不足消息。
/lp包含终止属性。
/lv包含详细(verbose)输出。
/lx包含额外调试信息。
/l+把信息追加到已有日志文件。
/l!每行都立即刷新写入日志文件。
/l*记录所有信息,但不含详细输出 /lv 与额外调试信息 /lx。

官方示例给的是最完整的一条:

msiexec.exe /i "C:\example.msi" /L*V "C:\package.log"

说明文字为:使用正常安装过程安装包 C:\example.msi,提供全部日志信息(含详细输出),并把输出日志文件保存到 C:\package.log。

这里有一个实践性推论:/l* 名字里带星号看着像“全记”,但按定义它不包含 /lv 和 /lx。真要在日志里看到逐条属性求值过程,必须显式加上 V(所以示例写的是 /L*V 而不是 /L*)。另外 /l! 的每行刷新很关键:如果安装进程被强杀,没有这个感叹号时日志尾部会整段丢失,恰好丢掉的就是失败现场。

四、/p 打补丁必须带两个属性,否则只更新了缓存

这是 msiexec 里最反直觉的一条。官方对 /p 的定义是安装修补程序,紧接着是一个硬性条件:如果你要静默安装,就必须同时把 REINSTALLMODE 属性设为 ecmus、REINSTALL 设为 ALL;否则该补丁只会更新目标设备上缓存的 MSI。

也就是说:msiexec /p MyPatch.msp /qn 这种写法会“成功退出但什么都没改”。正确写法就是官方示例:

msiexec.exe /p "C:\MyPatch.msp" /qb REINSTALLMODE="ecmus" REINSTALL="ALL"

另外 /update 与 /p 不同,它是“安装修补程序选项”,官方提示:如果要应用多个更新,必须用分号 (;) 分隔它们。

卸载补丁要成对给两个 GUID,官方示例:

msiexec.exe /uninstall {1BCBF52C-CD1B-454D-AEF7-852F73967318} /package {AAD3D77A-7476-469F-ADF4-04424124E91D}

文档明确标注:第一个 GUID 是补丁 GUID,第二个是应用了该补丁的 MSI 产品代码。写反了就变成“用某个补丁去卸载另一个产品”这类诡异报错。

五、安装入口 /i、/a、/j、/x 的差别

Install options 表格:/i 指定正常安装;/a 指定管理员安装;/ju 把产品 advertise 给当前用户;/jm advertise 给所有用户;/j/g 指定被 advertise 包所使用的语言标识符;/j/t 对被 advertise 的包应用转换(transform);/x 卸载包。示例:

msiexec.exe /i "C:\example.msi"

这里 “advertise” 是按需安装:注册表里只有入口,真正运行时才触发安装,所以 /ju、/jm 主要用于组策略分发场景,而不是用来“静默安装一个本地包”。

六、修复已装程序:/f 的十个字母各有触发条件

Repair options 的表格值得逐条对照,因为每个开关的“什么时候才修”不一样:

  • /fp:文件缺失时修复包。
  • /fo:文件缺失或已装更旧版本时修复。
  • /fe:文件缺失,或已安装等于或更旧的版本时修复。
  • /fd:文件缺失,或安装了不同版本时修复。
  • /fc:文件缺失,或校验和与计算值不匹配时修复。
  • /fa:强制重装所有文件。
  • /fu 修复所有必需的用户特定注册表项;/fm 修复计算机特定注册表项;/fs 修复所有现有快捷方式;/fv 从源运行并重新缓存本地包。

注意 /fc 与 /fa 的分工:怀疑文件被改坏时用 /fc(靠校验和判断),只想保证文件齐全时用 /fa(无脑全量重装)。官方示例:

msiexec.exe /fa {AAD3D77A-7476-469F-ADF4-04424124E91D}

并说明这是基于待修复的 MSI 产品代码强制重新安装所有文件。

七、属性传递的格式约束

文档在 Set public properties 一节指向 Public Properties 文档,说明可以用命令行设置公共属性。结合 /p 的示例可以推出标准格式:属性名="值",且值含分号之类的特殊字符时必须加引号(如 REINSTALLMODE="ecmus")。这些属性必须写在 msiexec.exe /i "包路径" 之后,同一条命令行里以空格分隔。

生产内容,同时打通搜索引擎(SEO)与AI搜索引擎(GEO)流量入口的软件! 点击进入365建站器 »