如何在IISWebAppDeploymentOnMachineGroup任务中指定自定义app_offline模板？

问题背景 #

使用Azure DevOps Server 2022的IISWebAppDeploymentOnMachineGroup@0任务部署.NET 8 API到Windows Server 2022的IIS环境，TakeAppOfflineFlag已生效，但无法替换默认的app_offline页面，尝试指定appOfflineTemplate参数时触发msdeploy报错（代码4294967295，提示参数不识别）。

可行解决方案 #

方案1：将自定义app_offline.htm包含在发布包中 #

这是最简单的实现方式，无需额外配置任务参数：

• 在.NET项目根目录添加app_offline.htm文件，编辑好自定义内容
• 修改项目文件（.csproj），确保该文件被包含在发布包里：

  <ItemGroup>
    <Content Include="app_offline.htm">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
      <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
    </Content>
  </ItemGroup>
  

• 重新生成发布包，部署时msdeploy会自动使用包里的app_offline.htm替换默认页面

方案2：通过任务的AdditionalArguments指定外部模板文件 #

如果不想将模板文件打包进应用，可通过msdeploy的参数指定外部文件，注意参数的正确写法：

• 确保目标服务器上存在自定义模板文件（比如C:\inetpub\app_offline-template.htm），且部署代理的运行账号拥有该文件的读取权限
• 修改YAML任务配置，在AdditionalArguments中正确传递参数：

  - task: IISWebAppDeploymentOnMachineGroup@0
    inputs:
      WebSiteName: ${{ parameters.webSiteName }}
      Package: '$(System.ArtifactsDirectory)/${{ parameters.artefactName }}/*.zip'
      RemoveAdditionalFilesFlag: true
      TakeAppOfflineFlag: true
      AdditionalArguments: '-appOfflineTemplate:"C:\inetpub\app_offline-template.htm"'
  

• 注意：参数名为-appOfflineTemplate（驼峰格式，无下划线），路径需用双引号包裹，避免路径含空格时解析错误

之前尝试失败的原因 #

你之前的参数写法存在两个关键错误：

1. 参数名错误：误用了-app_offline-template.htm，正确参数名应为-appOfflineTemplate
2. 路径未加引号：未用双引号包裹路径，若路径含空格会导致msdeploy无法正确解析参数值

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