CmdLine@2 – Kommandorad v2-uppgift

2025-06-24

Använd den här uppgiften om du vill köra ett kommandoradsskript med hjälp av Bash i Linux, macOS och cmd.exe i 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.

Ingångar

script - Manus
string. Obligatoriskt. Standardvärde: echo Write your commands here\n\necho Hello world.

Innehållet i skriptet som du vill köra.

workingDirectory - Arbetskatalog
string.

Anger arbetskatalogen för att köra kommandon. Om du lämnar den tom är arbetskatalogen $(Build.SourcesDirectory).

failOnStderr - fel vid standardfel
boolean. Standardvärde: false.

Om värdet är inställt på true misslyckas aktiviteten om fel skrivs till standardfelströmmen.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Ingen.

Anmärkningar

Kommandoraden har en genväg i YAML: steps.script.

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

Kör batch och . CMD-filer

Azure Pipelines placerar det infogade skriptinnehållet i en tillfällig batchfil (.cmd) för att köra det. När du vill köra en batchfil från en annan batchfil i Windows CMD måste du använda kommandot call, annars avslutas den första batchfilen. Detta resulterar i att Azure Pipelines kör ditt avsedda skript fram till den första batchfilen, sedan kör batchfilen och sedan avslutar steget. Ytterligare rader i det första skriptet körs inte. Du bör alltid förbereda call innan du kör en batchfil i ett Azure Pipelines-skriptsteg.

Viktigt!

Du kanske inte inser att du kör en batchfil. Till exempel är npm i Windows, tillsammans med alla verktyg som du installerar med npm install -g, faktiskt batchfiler. Använd alltid call npm <command> för att köra NPM-kommandon i en kommandoradsaktivitet i Windows.

Exempel

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

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
kräver	Ingen
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Vilken som helst
variabler som kan	Vilken som helst
Agentversion	Alla agentversioner som stöds.
Aktivitetskategori	Nytta

Se även

Lär dig hur du använder utförliga loggar för felsökning.

Dela via