CmdLine@2 - Tarefa da linha de comandos v2

Artigo
07/02/2024

Utilize esta tarefa para executar um script de linha de comandos com o 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ório. Valor predefinido: echo Write your commands here\n\necho Hello world.

Os conteúdos do script que quer executar.

script - Script
string. Obrigatório. Valor predefinido: echo Write your commands here\n\necho Use the environment variables input below to pass secret variables to this script.

Os conteúdos do script que quer executar.

workingDirectory - Diretório de Trabalho
string.

Especifica o diretório de trabalho para executar comandos. Se o deixar vazio, o diretório de trabalho é $(Build.SourcesDirectory).

failOnStderr - Falha no Erro Padrão
boolean. Valor predefinido: false.

Se o valor estiver definido como verdadeiro, a tarefa falhará se forem escritos erros no fluxo de Erros Padrão.

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

A linha de comandos tem um atalho no YAML: steps.script.

- script: # inline script
  workingDirectory: #
  displayName: #
  failOnStderr: #
  env: { string: string } # mapping of environment variables to add

A executar batch e . Ficheiros CMD

Os Pipelines do Azure colocam os conteúdos do script inline num ficheiro de lote temporário (.cmd) para o executar. Quando pretender executar um ficheiro batch a partir de outro ficheiro de lote no CMD do Windows, tem de utilizar o call comando, caso contrário, o primeiro ficheiro de lote é terminado. Tal fará com que os Pipelines do Azure executem o script pretendido até ao primeiro ficheiro de lote e, em seguida, executem o ficheiro de lote e, por fim, terminem o passo. As linhas adicionais no primeiro script não são executadas. Deve sempre preparar call antes de executar um ficheiro em lote num passo de script do Azure Pipelines.

Importante

É possível que não se aperceba de que está a executar um ficheiro em lote. Por exemplo, npm no Windows, juntamente com todas as ferramentas que instalar com npm install -g, são, na verdade, ficheiros em lote. Utilize call npm <command> sempre para executar comandos NPM numa tarefa da Linha de Comandos 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	Description
Tipos de pipeline	YAML, Compilação clássica, Versão clássica
É executado em	Agente, DeploymentGroup
Exigências	Nenhuma
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos	Qualquer
Variáveis de tabelas definidas	Qualquer
Versão do agente	Todas as versões de agente suportadas.
Categoria da tarefa	Utilitário

Ver também

Saiba como utilizar registos verbosos para a resolução de problemas.

Partilhar via