Azure DevOps部署池代理注册脚本启动服务失败排查求助

• 先查权限问题
  执行config.cmd和启动服务的账户必须有本地管理员权限——毕竟要修改服务注册表、写入系统目录，权限不够直接卡壳。如果用的是域账户，得确保它在本地安全策略里有「作为服务登录」的权限。

• 深挖_diag日志细节
  找到AgentService_*.diag日志文件，重点看执行init参数失败时的具体报错：

  • 有没有提示依赖库缺失？比如VC++运行时组件没装全
  • agent.properties配置文件是不是有乱码或者格式错误？
  • 代理默认使用的端口是不是被其他程序占用了？

• 验证AgentService.exe完整性
  重新下载对应版本的Azure DevOps代理压缩包，解压后替换现有目录里的AgentService.exe和相关依赖文件，再手动执行AgentService.exe init，看能不能得到更明确的错误提示。

• 检查系统环境依赖
  确认服务器装了对应版本的运行时：代理2.x版本需要.NET Framework，3.x及以上版本需要.NET Core Runtime，而且得是最新版。另外系统补丁也得更到最新，尤其是和服务控制、注册表操作相关的补丁。

• 排查服务注册冲突
  打开服务管理器（services.msc），看看有没有同名的「Azure Pipelines Agent」服务，有的话先用sc delete "Azure Pipelines Agent"命令删掉。然后把代理目录下的_service文件夹清空，再重新运行config.cmd完成注册。

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