Visual Studio Setup Project执行msiexec /a时Custom Action不触发问题

问题成因 #

• msiexec的/a参数对应管理安装模式，核心用途是创建可供多台客户端部署的网络共享安装映像，并非面向单台客户端的升级操作。该模式是Windows Installer的特殊执行上下文，默认仅运行和映像生成相关的标准动作，所有未明确允许在管理模式执行的自定义动作都会被直接跳过，属于MSI的设计规则。
• Visual Studio Setup Project生成的自定义动作默认没有配置管理模式下的执行权限，绝大多数场景下自定义动作的触发条件隐式排除了管理安装上下文，避免影响部署映像的正确性。
• 使用/a参数执行客户端升级本身不符合MSI的设计逻辑，自然不会触发安装、安装完成阶段配置的自定义动作。

解决方案 #

方案一：使用正确的客户端升级命令 #

单台客户端升级完全不需要用到/a参数，直接使用普通安装模式的静默命令即可：

• 同版本小更新：执行 msiexec.exe /i setup.msi /qn REINSTALL=ALL REINSTALLMODE=amus
• 跨版本升级：确认新版本安装包的ProductCode、PackageVersion已按升级规则配置完成，直接执行 msiexec.exe /i setup.msi /qn 即可，会自动完成旧版本卸载、新版本安装流程，对应阶段的自定义动作都会正常触发。

方案二：管理安装场景下调整自定义动作执行规则 #

如果你确实需要在/a管理安装流程中运行指定自定义动作，可按以下步骤调整MSI配置：

1. 使用Orca等MSI编辑工具打开生成的setup.msi文件，找到CustomAction表
2. 定位到你需要调整的自定义动作条目，修改Type字段的对应位，取消“仅在非管理安装模式执行”的限制
3. 为该自定义动作添加执行条件 ACTION="ADMIN"，确保管理安装流程会触发该动作

注意：该修改可能破坏管理安装映像的生成逻辑，非必要不建议调整。

内容的提问来源于stack exchange，提问作者Laminos