Azure DevOps代理池：如何指定特定.NET Framework SDK版本需求？

一、先确认代理上报的.NET相关功能 #

要指定需求，首先得明确你的代理实际能提供哪些.NET版本支持，有两种简单方式：

• 登录Azure DevOps组织，进入项目设置 → 代理池，找到目标代理池，点击具体代理机器名称，在功能标签页就能看到该代理已注册的所有功能，其中包含已安装的.NET Framework/.NET Core版本条目。
• 直接在代理机器上，打开代理安装目录下的_diag文件夹，查看最新的Agent_*.log日志，搜索Adding capability关键词，就能找到代理启动时上报的所有功能明细。

二、在管道中指定.NET版本需求 #

1. .NET Framework SDK（如4.8.1） #

自托管代理会自动检测已安装的.NET Framework SDK，上报的功能名称格式通常为DotNetFrameworkSDK_4.8.1（具体以代理实际显示的名称为准）。只需在YAML管道的job中添加demands字段匹配：

jobs:
- job: BuildNetFxProject
  displayName: 构建依赖.NET 4.8.1的项目
  demands:
    - DotNetFrameworkSDK_4.8.1 # 必须与代理上报的功能名称完全一致
  steps:
    # 此处添加你的构建步骤

2. .NET Core/.NET SDK版本 #

对于.NET Core或.NET 5+的SDK，代理上报的名称格式一般是DotNetCoreSDK_<主版本>.<次版本>.<补丁版本>，比如DotNetCoreSDK_6.0.417。支持精确匹配，也可用通配符匹配同主次要版本的任意补丁：

jobs:
- job: BuildNetCoreProject
  displayName: 构建依赖.NET 6.0的项目
  demands:
    - DotNetCoreSDK_6.0.x # 通配符匹配6.0系列所有补丁版本
    # 如需精确版本则写：DotNetCoreSDK_6.0.417
  steps:
    # 此处添加你的构建步骤

三、自动检测失效时，手动添加自定义功能 #

如果部分.NET版本代理未自动上报，可手动添加自定义功能：

• 在代理机器上，打开代理安装目录下的config.cmd，运行config.cmd configure进入配置模式。
• 选择Add capabilities选项，手动添加键值对，比如键填DotNetFrameworkSDK_4.8.1，值填true或具体版本号均可。
• 重启代理服务，新功能会同步到Azure DevOps，之后就能在管道中用该名称作为需求。

内容的提问来源于stack exchange，提问作者Chris F Carroll