CmdLine@2 - opdrachtregel v2-taak

Artikel
03/24/2025

Gebruik deze taak om een opdrachtregelscript uit te voeren met behulp van Bash op Linux, macOS en cmd.exe in Windows.

Syntaxis

# 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.

Invoer

script - script
string. Verplicht. Standaardwaarde: echo Write your commands here\n\necho Hello world.

De inhoud van het script dat u wilt uitvoeren.

workingDirectory - werkmap
string.

Hiermee geeft u de werkmap om opdrachten uit te voeren. Als u deze leeg laat, wordt de werkmap $(Build.SourcesDirectory).

failOnStderr - mislukt bij standaardfout
boolean. Standaardwaarde: false.

Als de waarde is ingesteld op true, mislukt de taak als er fouten worden weggeschreven naar de standaardfoutstroom.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

De opdrachtregel heeft een snelkoppeling in YAML: steps.script.

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

Batch uitvoeren en . CMD-bestanden

Azure Pipelines plaatst de inhoud van uw inlinescript in een tijdelijk batchbestand (.cmd) om het uit te voeren. Als u een batchbestand wilt uitvoeren vanuit een ander batchbestand in Windows CMD, moet u de opdracht call gebruiken, anders wordt het eerste batchbestand beëindigd. Dit leidt ertoe dat Azure Pipelines het beoogde script uitvoert tot het eerste batchbestand, waarna het batchbestand wordt uitgevoerd en de stap wordt beëindigd. Extra regels in het eerste script worden niet uitgevoerd. U moet altijd call voorbereiden voordat u een batchbestand uitvoert in een Azure Pipelines-scriptstap.

Belangrijk

U realiseert zich mogelijk niet dat u een batchbestand uitvoert. Bijvoorbeeld, npm in Windows, samen met alle hulpprogramma's die u installeert met behulp van npm install -g, zijn eigenlijk batchbestanden. Gebruik altijd call npm <command> om NPM-opdrachten uit te voeren in een opdrachtregeltaak in Windows.

Voorbeelden

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

Vereisten

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Geen
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welk dan ook
variabelen instellen	Welk dan ook
Agentversie	Alle ondersteunde agentversies.
Taakcategorie	Nutsvoorzieningen

Zie ook

Meer informatie over het gebruik van uitgebreide logboeken voor probleemoplossing.

Delen via