实现重启后自动启动自托管Azure DevOps代理的方法

方案一：将代理注册为Windows服务（官方推荐） #

这是最可靠的方式，服务会随系统自动启动，且自带故障恢复机制：

• 以管理员身份打开命令提示符或PowerShell，导航到代理安装目录的bin子文件夹（示例路径：C:\agent\bin）
• 执行注册服务命令：

  .\svc.cmd install
  

• 启动服务：

  .\svc.cmd start
  

• 验证服务配置：打开services.msc，找到名称为vstsagent.{你的组织名}.{代理名}的服务，将启动类型设置为自动

方案二：修正Windows任务计划程序配置 #

如果不想使用服务，可按以下步骤修正任务计划，解决之前启动失败的问题：

• 打开任务计划程序，创建新任务：
  1. 常规选项卡：勾选「使用最高权限运行」，配置目标选择对应系统版本（如Windows Server 2019）
  2. 触发器选项卡：新建触发器，选择「启动时」，设置延迟任务2分钟（避免系统启动未就绪时执行）
  3. 操作选项卡：新建操作，选择「启动程序」，程序路径填写代理根目录的run.cmd（示例：C:\agent\run.cmd），起始位置填写代理根目录（示例：C:\agent）
  4. 条件选项卡：取消勾选「只有在计算机使用交流电源时才启动此任务」，勾选「唤醒计算机运行此任务」
  5. 设置选项卡：勾选「如果任务失败，每隔5分钟重试一次」（最多3次），取消勾选「如果过了计划时间，立即启动任务」

排查要点 #

如果仍无法启动，可通过以下方式定位问题：

• 查看代理日志：代理安装目录下_diag文件夹中的日志文件，检查启动失败的具体错误信息
• 验证代理配置：确认config.cmd中的组织URL、PAT令牌是否有效，令牌过期会导致注册失败

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