Compartilhar via


CmdLine@2 – Tarefa de 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.

Sintaxe

# 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

de Script script -
string. Obrigatório Valor padrão: echo Write your commands here\n\necho Hello world.

O conteúdo do script que você quer executar.


do Diretório de Trabalho do
string.

Especifica o diretório de trabalho para executar os comandos. Se você deixá-lo vazio, o diretório de trabalho será $(Build.SourcesDirectory).


failOnStderr - falha no de erro padrão
boolean. Valor padrão: false.

Se o valor estiver definido como true, a tarefa falhará se algum erro for gravado no fluxo de Erro Padrão.


Opções de controle de tarefa

Todas as tarefas têm opções de controle além das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Observações

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

Executando lote e . Arquivos CMD

O Azure Pipelines coloca o conteúdo do 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 fará com que o Azure Pipelines execute o script pretendido até o primeiro arquivo em lote e, em seguida, execute o arquivo em lote e encerre a etapa. As 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 lote. Por exemplo, npm no Windows, juntamente com as ferramentas que você instala usando npm install -g, são, na verdade, 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
Execuções em Agent, DeploymentGroup
de demandas Nenhum
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente Todas as versões de agente com suporte.
Categoria de tarefa Utilidade

Consulte também