Windows Server 2025中无法安装Azure自托管代理为服务求助

问题背景 #

在Windows Server 2025中安装Azure Pipeline Agent（版本vsts-agent-win-x64-4.255.0），按以下流程配置后触发错误：

• 在C盘创建代理文件夹并解压安装包
• 以管理员身份打开PowerShell执行.\config.cmd
• 完成代理池、名称、工作文件夹配置后，选择将代理作为服务运行（输入Y），启用SERVICE_SID_TYPE_UNRESTRICTED（输入Y）
• 输入本地账号vmname\pipelineagent及密码后，系统弹出提示：

  StandardOut has not been redirected or the process hasn't started yet.

• 同时指向诊断日志C:\agent_diag\Agent_20250530-072906-utc.log，更换本地管理员账号、独立凭据均出现相同错误，需将代理以服务而非交互式运行。

排查与解决步骤 #

1. 补全服务账号必要权限 #

确保vmname\pipelineagent账号拥有以下权限：

• 代理安装目录（C:\agent）和工作文件夹（默认_work）的完全控制权限
• 本地安全策略中的作为服务登录权限：
  1. 运行secpol.msc打开本地安全策略
  2. 依次展开「本地策略」→「用户权限分配」
  3. 找到「作为服务登录」，添加目标账号

2. 使用无交互配置命令跳过交互式流程 #

用带参数的无交互命令完成配置，避免交互式流程中的输出重定向问题：

.\config.cmd --unattended --agent "abcagent" --pool "abcabc" --work "_work" --runAsService --serviceAccount "vmname\pipelineagent" --servicePassword "你的账号密码" --serviceSidType "unrestricted"

替换命令中的代理名称、池名称、账号密码为实际信息

3. 手动创建Windows服务关联代理 #

如果无交互命令仍失败，可手动创建服务：

1. 先完成代理基础配置（不设置为服务）：

   .\config.cmd --unattended --agent "abcagent" --pool "abcabc" --work "_work"
   

2. 用sc.exe创建服务：

   sc create "Azure Pipelines Agent (abcagent)" binPath= "\"C:\agent\bin\AgentService.exe\" run --startuptype service" obj= "vmname\pipelineagent" password= "你的账号密码" DisplayName= "Azure Pipelines Agent (abcagent)"
   

3. 设置服务SID类型为Unrestricted：

   sc sidtype "Azure Pipelines Agent (abcagent)" unrestricted
   

4. 启动服务：

   sc start "Azure Pipelines Agent (abcagent)"
   

4. 从诊断日志定位具体问题 #

打开C:\agent_diag\Agent_20250530-072906-utc.log，重点排查：

• 权限拒绝类错误（如“Access Denied”）
• 服务创建时的异常堆栈信息
• 账号认证失败的相关提示

5. 验证.NET Framework兼容性 #

Azure Pipeline Agent依赖.NET Framework，确保服务器已安装**.NET Framework 4.8或更高版本**，可通过以下命令检查版本：

(Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full').Release

若返回的Release值≥528040，说明已安装.NET Framework 4.8

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