Compartilhar via


Solucionar erros comuns na CLI do Azure DevOps

Serviços do Azure DevOps

Você pode resolver os erros mais comuns encontrados ao executar os comandos az devops boards area e az devops boards iteration no nível de equipe, seguindo as diretrizes fornecidas neste artigo.

Áreas de nível de equipe

Erro: Valor Padrão

Você recebe a mensagem de erro DefaultValue ao tentar adicionar o primeiro caminho de área a uma equipe sem passar o sinalizador --set-as-default.

Resolução :

Inclua o --set-as-default argumento ao adicionar uma área a uma equipe ou use az boards area team update o comando para alterar a área padrão da equipe. Insira az boards area team add -h para uso de comando.

Erro: TF400499

Você pode encontrar o erro a seguir ao adicionar, remover ou atualizar uma área de equipe.

TF400499: You have not set your team field.

Resolução :

O --path parameter para a área de uma equipe deve ser \ProjectName\RootAreaName\ChildArea1 e não \ProjectName\Area\RootAreaName\ChildArea1. Os comandos de área de equipe não esperam que a Area palavra-chave seja passada no --path parâmetro.

Iterações de nível de equipe

Erro: VS1530019: não é possível localizar a iteração

Ao tentar adicionar uma iteração de backlog a uma equipe, você poderá encontrar o seguinte erro:

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.

Resolução :

Você só pode adicionar iterações filho de uma iteração de backlog à sua equipe. Crie iterações filho da iteração de backlog usando o seguinte comando:

az boards iteration project create --name "child_iteration_name" --path <BacklogIterationPath>

Obtenha o identificador da iteração e adicione-o à sua equipe usando o az boards iteration team add -h comando.

Usar a IA para solucionar problemas da CLI do Azure DevOps

O prompt de exemplo a seguir para o Copilot Chat ajuda você a solucionar problemas de comandos e mensagens de erro da CLI do Azure DevOps. Copie e cole esse prompt no Copilot Chat, substituindo os espaços reservados por suas informações específicas.

Para obter a melhor assistência de IA, inclua detalhes específicos, como o comando exato executado, a mensagem de erro completa, os nomes do projeto e da equipe e a versão de extensão da CLI do Azure que você está usando.

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.