如何检查Windows Server 2016机器上Azure Pipeline代理是否已安装并运行

一、确认代理是否已安装 #

• 查看安装目录：Azure Pipeline代理默认安装路径为C:\agent（若当初自定义了安装路径，替换为实际路径即可）。进入该目录下的config文件夹，查看是否存在settings.json文件，打开文件后可找到agentName字段，核对是否为你指定的代理名称。
• PowerShell查询服务：打开PowerShell，执行以下命令筛选出所有Azure Pipeline代理相关服务（代理服务命名规则为vstsagent.<机器名称>.<代理名称>）：

  Get-Service | Where-Object {$_.Name -match "vstsagent"}
  

  从返回结果中匹配你指定的代理名称，即可判断该代理是否已安装。

二、检查代理运行状态 #

方式1：通过服务管理器查看 #

1. 按下Win + R，输入services.msc打开服务管理器。
2. 在服务列表中找到对应名称的代理服务（格式为vstsagent.<机器名>.<你的代理名称>）。
3. 查看服务的「状态」列，显示「正在运行」则说明代理处于活跃状态。

方式2：PowerShell命令快速查询 #

打开PowerShell，将下方命令中的<代理服务名称>替换为实际服务名，执行后直接查看状态：

Get-Service -Name "<代理服务名称>" | Select-Object Name, Status

若Status列返回Running，代表代理正在运行。

方式3：通过代理自带工具检查 #

进入代理的安装目录（例如C:\agent），在命令提示符或PowerShell中执行：

.\run.cmd status

该命令会返回代理的详细状态，包括是否在线、关联的Azure DevOps组织等信息，结果直观清晰。

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