WiX升级时IIS文件被占用致重启管理器误判，如何提前停止网站

核心问题拆解 #

重启管理器会在InstallValidate阶段启动前自动检测文件锁定状态，常规自定义动作的执行时机滞后于这个检测流程；同时w3wp.exe的运行SID与MSI进程SID不匹配，导致重启管理器无法正常管控IIS进程，最终触发不必要的重启提示。

可行解决方案 #

1. 禁用重启管理器自动检测 #

通过设置MSI属性MSIRESTARTMANAGERCONTROL为Disable，完全跳过重启管理器的自动检测流程，转而通过自定义动作手动控制网站启停：

<Property Id="MSIRESTARTMANAGERCONTROL" Value="Disable" />

2. 在最早期执行停站自定义动作 #

添加即时自定义动作，将执行时机放在LaunchConditions之前（MSI流程中极早的阶段，早于重启管理器检测），确保文件锁定检测前就释放网站占用：

<!-- 注册自定义动作 -->
<CustomAction Id="StopTargetWebsite" BinaryKey="IISControlDll" DllEntry="StopWebsite" Execute="immediate" Return="check" />

<!-- 配置执行顺序 -->
<InstallExecuteSequence>
  <Custom Action="StopTargetWebsite" Before="LaunchConditions" />
</InstallExecuteSequence>

自定义动作可通过Microsoft.Web.Administration库实现IIS操作：

public static ActionResult StopWebsite(Session session)
{
    using (var serverManager = new ServerManager())
    {
        var targetSite = serverManager.Sites["你的网站名称"];
        if (targetSite != null && targetSite.State == ObjectState.Started)
        {
            targetSite.Stop();
            session.Log("已成功停止目标网站：" + targetSite.Name);
        }
    }
    return ActionResult.Success;
}

3. 升级完成后自动重启网站 #

在安装/升级收尾阶段添加自定义动作，自动重启网站以恢复服务：

<CustomAction Id="StartTargetWebsite" BinaryKey="IISControlDll" DllEntry="StartWebsite" Execute="immediate" Return="check" />

<InstallExecuteSequence>
  <Custom Action="StartTargetWebsite" After="InstallFinalize" />
</InstallExecuteSequence>

对应的启动逻辑：

public static ActionResult StartWebsite(Session session)
{
    using (var serverManager = new ServerManager())
    {
        var targetSite = serverManager.Sites["你的网站名称"];
        if (targetSite != null && targetSite.State == ObjectState.Stopped)
        {
            targetSite.Start();
            session.Log("已成功重启目标网站：" + targetSite.Name);
        }
    }
    return ActionResult.Success;
}

4. 补充：确保w3wp进程完全退出 #

若仍存在文件锁定，可添加延迟自定义动作等待进程退出：

<CustomAction Id="WaitForW3wpExit" BinaryKey="WixCA" DllEntry="WixSleep" Execute="deferred" Return="check" />
<CustomAction Id="SetWaitTime" Property="WaitForW3wpExit" Value="3000" />

<InstallExecuteSequence>
  <Custom Action="SetWaitTime" Before="WaitForW3wpExit" />
  <Custom Action="WaitForW3wpExit" After="StopTargetWebsite" />
</InstallExecuteSequence>

注意事项 #

• 即时自定义动作默认以管理员权限执行，确保具备IIS操作权限；
• 若不想完全禁用重启管理器，可尝试将MSIRESTARTMANAGERCONTROL设为Remove，让管理器仅移除文件锁定引用，但仍可能受SID不匹配问题影响。

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