GitLab流水线执行MSDeploy报401未授权错误求助（IIS10+WebDeploy4）

我有一台安装了MSDeploy的IIS服务器（IIS 10.0.0，Web Deploy 4.0.0），在GitLab流水线中执行以下命令部署站点：

msdeploy -verb:sync -source:package="\publish\mysite.zip" -dest:auto,computerName=myiisserver,username=admin,password=password,authType=NTLM
msdeploy -verb:sync -source:package="\publish\mysite.zip" -dest:auto,computerName=myiisserver,username=admin,password=password,authType=Basic

执行后出现401未授权错误，报错信息如下：

Error Code: ERROR_USER_NOT_ADMIN
More Information: Connected to 'myiisserver' using the Web Deployment Agent Service, 
but could not authorize. Make sure you are an administrator on 'myiisserver'.
Error: The remote server returned an error: (401) Unauthorized.
Error count: 1.

已将admin账号加入管理员组，且在IIS站点中授权了该账号，同时使用同一admin账号通过Visual Studio进行Web Deploy部署可正常完成，请问该如何解决？

• 检查Web Management Service（WMSVC）的权限配置
  远程部署依赖WMSVC服务验证权限，即使账号在本地管理员组，也需确保服务允许该账号访问：

  1. 打开IIS管理器，选中服务器节点，找到管理服务
  2. 确认启用远程连接已勾选，同时检查允许的用户列表包含admin账号，或勾选允许服务器管理员连接
  3. 重启Web Management Service服务

• 修正MSDeploy命令的参数格式
  命令中使用的中文引号“”会导致参数解析异常，必须替换为英文引号""。另外：

  • 用NTLM认证时，确保GitLab Runner所在机器与IIS服务器在同一域或信任域；
  • 用Basic认证时，需先在IIS站点的身份验证模块中启用Basic认证。
    修正后的命令示例：

  # NTLM认证命令
  msdeploy -verb:sync -source:package="\publish\mysite.zip" -dest:auto,computerName=myiisserver,username=admin,password=password,authType=NTLM
  # Basic认证命令（需提前启用IIS Basic认证）
  msdeploy -verb:sync -source:package="\publish\mysite.zip" -dest:auto,computerName=myiisserver,username=admin,password=password,authType=Basic
  

• 排查GitLab Runner执行环境问题
  在GitLab Runner所在机器上手动执行MSDeploy命令，确认：

  1. 运行命令的账号能正常访问\publish\mysite.zip部署包；
  2. 机器能通IIS服务器的8172端口（Web Deploy默认端口）；
  3. 命令执行无权限问题，排除流水线环境的特殊限制。

• 确认Web Deploy的管理员权限设置
  打开Web Deploy配置工具，检查是否存在部署账号的权限限制，确保admin账号被纳入Web Deploy的允许部署列表，未被排除或限制。

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