O que fazer se o comando funcionar no seu terminal, mas apresentar erro de sintaxe no Agent?
Confirme primeiro o shell realmente usado pelo Agent e corrija parâmetros, aspas e caminhos.
O ponto de execução pode usar outro shell
Não deduza o shell do Agent apenas pelo sistema operacional ou pelo terminal que abre manualmente. No Windows, desktop e CLI priorizam Git Bash; se não o encontrarem, usam cmd, não PowerShell fixamente. Desktops Unix escolhem o shell disponível do utilizador na máquina; a CLI usa bash para comandos comuns. Trocar o ponto de entrada pode mudar a interpretação da mesma sequência de caracteres.
Confira primeiro caminhos e uso de aspas
Peça ao Agent que confirme o shell real antes de tratar caminhos com espaços, URLs com interrogações ou conectores e sintaxe de parâmetros específica da plataforma. Alguns shells interpretam caracteres sem aspas como curingas, gerando erros semelhantes a ficheiro não encontrado. Não altere apenas um caractere suspeito e continue a execução em lote. Separe primeiro um único comando verificável somente de leitura e observe o resultado.
Diferencie sintaxe incorreta de ferramenta ausente
Se o erro indicar programa não encontrado, confira instalação e caminhos. Se o acesso for negado, confira permissões. Apenas erros de interpretação exigem concentrar-se na sintaxe do shell. Mesmo que o final do comando mostre sucesso, examine erros anteriores para não ignorar falhas parciais. Confirme o comportamento de uma etapa antes de retomar tudo. Para isso, não é necessário redefinir tokens ou elevar permissões do cliente por padrão.