tarefa CmdLine@2 - Linha de comando v2
Use essa tarefa para executar um script de linha de comando usando Bash no Linux, macOS e cmd.exe no Windows.
Syntax
# Command Line v2
# Run a command line script using Bash on Linux and macOS and cmd.exe on Windows.
- task: CmdLine@2
inputs:
script: # string. Required. Script.
# Advanced
#workingDirectory: # string. Working Directory.
#failOnStderr: false # boolean. Fail on Standard Error. Default: false.
Entradas
script
- Script
string
. Obrigatórios. Valor padrão: echo Write your commands here\n\necho Hello world
.
O conteúdo do script que você deseja executar.
script
- Script
string
. Obrigatórios. Valor padrão: echo Write your commands here\n\necho Use the environment variables input below to pass secret variables to this script
.
O conteúdo do script que você deseja executar.
workingDirectory
- Diretório de Trabalho
string
.
Especifica o diretório de trabalho para executar comandos. Se você deixá-lo vazio, o diretório de trabalho será $(Build.SourcesDirectory).
failOnStderr
- Falha no Erro Padrão
boolean
. Valor padrão: false
.
Se o valor for definido como true, a tarefa falhará se algum erro for gravado no fluxo de Erro Padrão.
Opções de controle da tarefa
Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.
Variáveis de saída
Nenhum.
Comentários
A linha de comando tem um atalho no YAML: steps.script.
- script: # inline script
workingDirectory: #
displayName: #
failOnStderr: #
env: { string: string } # mapping of environment variables to add
Como executar arquivos .CMD e em lote
O Azure Pipelines coloca seu conteúdo de script embutido em um arquivo em lote temporário (.cmd) para executá-lo.
Quando você quiser executar um arquivo em lote de outro arquivo em lote no WINDOWS CMD, deverá usar o comando call
, caso contrário, o primeiro arquivo em lote será encerrado.
Isso resultará em o Azure Pipelines executar o script pretendido até o primeiro arquivo em lote, então a executar o arquivo em lote e, por fim, o encerrar a etapa.
Linhas adicionais no primeiro script não são executadas.
Você sempre deve acrescentar call
antes de executar um arquivo em lote em uma etapa de script do Azure Pipelines.
Importante
Talvez você não perceba que está executando um arquivo em lotes.
Por exemplo, npm
no Windows, juntamente com as ferramentas que você instala usando o npm install -g
, na verdade, são arquivos em lote.
Sempre use call npm <command>
para executar comandos NPM em uma tarefa de Linha de Comando no Windows.
Exemplos
steps:
- script: date /t
displayName: Get the date
- script: dir
workingDirectory: $(Agent.BuildDirectory)
displayName: List contents of a folder
- script: |
set MYVAR=foo
set
displayName: Set a variable and then display all
env:
aVarFromYaml: someValue
Requisitos
Requisito | Descrição |
---|---|
Tipos de pipeline | YAML, build clássico, versão clássica |
É executado em | Agent, DeploymentGroup |
Demandas | Nenhum |
Funcionalidades | Essa tarefa não atende a nenhuma demanda por tarefas subsequentes no trabalho. |
Restrições de comando | Qualquer |
Variáveis configuráveis | Qualquer |
Versão do agente | Todas as versões do agente com suporte. |
Categoria da tarefa | Utilitário |
Confira também
- Saiba como usar logs detalhados para solução de problemas.