Azure DevOps Services
可以按照本文中提供的指南解决运行团队级别 az devops boards area 和 az devops boards iteration 命令时遇到的最常见错误。
团队级区域
错误：DefaultValue
当您尝试在不传递标志DefaultValue的情况下将第一个区域路径添加到团队时，会收到--set-as-default错误消息。
解决方法：
包含--set-as-default参数以向团队添加区域，或使用az boards area team update命令更改团队的默认区域。 输入 az boards area team add -h 查看命令的用法。
错误：TF400499
添加、删除或更新团队区域时，可能会遇到以下错误。
TF400499: You have not set your team field.
解决方法：
团队区域的--path parameter必须\ProjectName\RootAreaName\ChildArea1，而非\ProjectName\Area\RootAreaName\ChildArea1。 团队区域命令不期望在Area参数中传递--path关键字。
团队级迭代
错误：VS1530019：找不到迭代
尝试向团队添加积压工作迭代时，可能会遇到以下错误：
VS1530019: Cannot find iteration with id 'b1e33737-e943-xxxx-xxxx-e3f1cbaxxxx'. The iteration might have been deleted, or it might not be selected for your team.
解决方法：
只能将积压迭代的子迭代添加到团队中。 使用以下命令创建积压工作迭代的子迭代：
az boards iteration project create --name "child_iteration_name" --path <BacklogIterationPath>
获取迭代的标识符，并使用 az boards iteration team add -h 命令将其添加到您的团队中。
使用 AI 排查 Azure DevOps CLI 问题
以下示例提示适用于 Copilot Chat，可帮助您排查 Azure DevOps CLI 命令及其错误消息。 将此提示复制并粘贴到 Copilot Chat 中，并将占位符替换为你的特定信息。
为了获得最佳 AI 帮助，请包括特定的详细信息，例如运行的确切命令、完整的错误消息、项目和团队名称以及正在使用的 Azure CLI 扩展版本。
I'm getting this error when running an Azure DevOps CLI command: [PASTE YOUR ERROR MESSAGE HERE]
CLI command details:
- Full command: [COMPLETE COMMAND like "az boards area team add --name MyArea --team MyTeam"]
- Azure CLI version: [VERSION like 2.x.x]
- Azure DevOps extension version: [VERSION like 0.x.x]
- Organization: [ORGANIZATION NAME]
- Project: [PROJECT NAME]
- Team: [TEAM NAME if applicable]
- Operating system: [Windows/macOS/Linux]
Can you help me troubleshoot this issue? Please provide step-by-step instructions to:
1. Identify the root cause of the CLI command error
2. Fix the command syntax, authentication, or configuration issue
3. Verify the command executes successfully
Context: This is for Azure DevOps CLI commands. The error might be related to authentication, command syntax, missing parameters, project/team configuration, area paths, iteration paths, or permission issues.