DevOps流水线中MSDEPLOY_RENAME_LOCKED_FILES等效配置方法

本地IIS部署场景配置方法 #

你使用DevOps流水线发布到本地IIS服务器时，根据所用部署任务类型，按以下方式配置即可实现锁定文件自动重命名能力：

• 如果你使用官方内置的「IIS Web App Deploy」（基于WinRM/部署组的IIS部署任务），直接找到任务配置中的附加Web Deploy参数输入框，填入以下参数：
  -enableRule:RenameLockedFiles
• 如果你是通过PowerShell/CMD脚本直接调用msdeploy.exe执行部署，把上述参数直接追加到msdeploy的执行参数列表中即可。
• 如果你使用的是旧版本IIS部署任务，没有找到附加参数配置项，可以直接给部署任务添加环境变量MSDEPLOY_RENAME_LOCKED_FILES=1，MSDeploy运行时会自动识别该变量启用锁定文件重命名规则。

注意事项：

1. 目标IIS服务器上安装的Web Deploy版本必须为3.5及以上，否则该规则无法被识别，会触发部署报错。
2. 不要和-enableRule:AppOffline规则同时启用，二者的文件锁处理逻辑存在冲突，可能导致部署失败。

该配置和Azure环境中设置MSDEPLOY_RENAME_LOCKED_FILES=1的应用设置效果完全一致：部署过程中遇到被w3wp.exe等进程锁定无法覆盖的文件时，会自动将旧文件重命名为.delete后缀，待文件锁释放后自动清理，不会因为文件锁定中断部署流程。

配置位置参考截图 #

流水线任务参数配置位置参考

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