使用PowerShell安装MSI时出现Exit-code 1603错误求助

结合你描述的场景——全新安装MSI正常，但重新安装时触发1603错误，且已经排除了微软官方提到的重复安装检测、文件夹加密、替代驱动器、SYSTEM账户权限这几个常见问题，下面是几个针对性的排查方向和脚本优化建议：

1. 明确MSI重新安装的命令参数 #

你的脚本使用了$InstallCommand变量，但默认的安装参数可能不支持覆盖现有安装状态。重新安装MSI需要指定专属参数，比如：

• 强制覆盖式重新安装：使用/qn REINSTALL=ALL REINSTALLMODE=amus（amus表示强制覆盖文件、注册表、快捷方式等所有组件）
• 修复式重新安装：使用/qn REINSTALL=ALL REINSTALLMODE=omus（仅修复缺失或损坏的组件）

可以直接修改$InstallCommand为适合重新安装的参数，示例：

$InstallCommand = "/qn REINSTALL=ALL REINSTALLMODE=amus"

2. 新增MSI安装日志定位具体错误 #

1603是通用错误码，想要找到根因必须查看MSI的详细安装日志。在安装参数里添加日志输出命令，方便后续排查：

$InstallCommand = "/qn REINSTALL=ALL REINSTALLMODE=amus /L*v `"C:\Temp\MSI_Reinstall_Log.log`""

日志里会记录安装过程中每一步的细节，比如文件锁定、自定义动作失败、依赖缺失等具体问题。

3. 优化脚本的进程处理与前置逻辑 #

你的脚本在失败时直接终止进程，但有时候1603错误可能是因为MSI等待隐藏的交互请求，或者现有安装状态未清理干净。可以做这些调整：

• 重新安装前先卸载现有版本，避免状态冲突：

  # 前置卸载步骤
  WriteLog -Message("Uninstalling existing $ProcessTitle instance") -MainLoggingConfigs $MainLoggingConfigs
  $uninstallProc = Start-Process msiexec.exe -ArgumentList "/x `"$InstallerPath`" /qn" -PassThru
  $uninstallProc | Wait-Process -Timeout $SecondsToWait -ea 0 -ev uninstallTimeout
  if ($uninstallTimeout) {
      $uninstallProc | kill
      WriteLog -Message("Uninstall timed out, proceeding to fresh install") -MainLoggingConfigs $MainLoggingConfigs
  }
  

• 确保使用msiexec.exe直接调用MSI，而不是直接启动MSI文件，避免参数传递异常。

4. 检查MSI的自定义动作与依赖项 #

部分MSI包含自定义动作（比如运行脚本、修改系统服务），重新安装时这些动作可能因为现有文件锁定、服务运行状态而失败：

• 重新安装前手动停止相关服务、关闭关联进程，释放被锁定的文件
• 查看MSI内部的自定义动作逻辑，确认重新安装时的执行条件

调整后的完整脚本示例 #

# 前置卸载现有版本
WriteLog -Message("Starting uninstall of existing $ProcessTitle") -MainLoggingConfigs $MainLoggingConfigs
$uninstallProc = Start-Process msiexec.exe -ArgumentList "/x `"$InstallerPath`" /qn /L*v `"C:\Temp\MSI_Uninstall_Log.log`"" -PassThru
$uninstallProc | Wait-Process -Timeout $SecondsToWait -ea 0 -ev uninstallTimeout
if ($uninstallTimeout) {
    $uninstallProc | kill
    WriteLog -Message("Uninstall timed out, continuing with install attempt") -MainLoggingConfigs $MainLoggingConfigs
}

:outer for($i=1; $i -le $attempts; $i++) { 
    $timeout = $null 
    # 配置重新安装参数与日志
    $installArgs = "/i `"$InstallerPath`" /qn REINSTALL=ALL REINSTALLMODE=amus /L*v `"C:\Temp\MSI_Install_Attempt$i.log`""
    $proc = Start-Process -filePath msiexec.exe -ArgumentList $installArgs -PassThru 
    $proc | Wait-Process -Timeout $SecondsToWait -ea 0 -ev timeout 
    
    If (($timeout) -or ($proc.ExitCode -ne 0)) { 
        $proc | kill 
        $error = "`tFailed $ProcessTitle reinstall attempt $i: Exit-Code = $($proc.ExitCode). Check log: C:\Temp\MSI_Install_Attempt$i.log" 
        If(($i+1) -le $attempts) { 
            WriteLog -Message($error) -MainLoggingConfigs $MainLoggingConfigs 
            Start-Sleep -s $WaitTimePerAttempt 
        } Else { 
            throw $error 
        } 
    } Else { 
        WriteLog -Message("$ProcessTitle reinstalled successfully on attempt $i") -MainLoggingConfigs $MainLoggingConfigs
        break outer 
    } 
}

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