Partilhar via


Solucionar erros comuns na CLI do Azure DevOps

Serviços de DevOps do Azure

Você pode resolver a maioria dos erros comuns encontrados ao executar os comandos az devops boards area e az devops boards iteration a nível de equipe seguindo as orientações fornecidas neste artigo.

Áreas ao nível da equipa

Erro: DefaultValue

Você recebe a mensagem de DefaultValue erro quando tenta adicionar seu 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. Enter az boards area team add -h para uso do comando.

Erro: TF400499

Você pode encontrar o seguinte erro ao adicionar, remover ou atualizar uma área da equipe.

TF400499: You have not set your team field.

Resolução:

O --path parameter para uma área de 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 em nível de equipe

Erro: VS1530019: Não é possível encontrar a iteração

Quando você tenta adicionar uma iteração de lista de pendências para uma equipe, você pode 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 filhas de uma iteração de lista de pendências à sua equipe. Crie iterações filhas 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 az boards iteration team add -h o comando.

Use IA para resolver problemas com a CLI DevOps do Azure

O exemplo seguinte do Copilot Chat ajuda-o a solucionar problemas relacionados com comandos e mensagens de erro da CLI do Azure DevOps. Copie e cole este prompt no Copilot Chat, substituindo os espaços reservados pela sua informação específica.

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

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.