stappen.scriptdefinitie

In de script stap wordt een script uitgevoerd met behulp van cmd.exe in Windows en Bash op andere platforms.

steps:
- script: string # Required as first property. An inline script.
  failOnStderr: string # Fail the task if output is sent to Stderr?
  workingDirectory: string # Start the script with this working directory.
  condition: string # Evaluate this condition expression to determine whether to run this task.
  continueOnError: boolean # Continue running even on failure?
  displayName: string # Human-readable name for the task.
  target: string | target # Environment in which to run this task.
  enabled: boolean # Run this task when the job runs?
  env: # Variables to map into the process's environment.
    string: string # Name/value pairs
  name: string # ID of the step.
  timeoutInMinutes: string # Time to wait for this task to complete before the server kills it.
  retryCountOnTaskFailure: string # Number of retries if the task fails.

Definities die naar deze definitie verwijzen: stappen

Eigenschappen

script tekenreeks. Vereist als eerste eigenschap.
een inlinescript.

failOnStderr tekenreeks.
Mislukt de taak als uitvoer naar Stderr wordt verzonden?

workingDirectory tekenreeks.
het script starten met deze werkmap. Als je geen waarde specificeert, begint de stap in $(Build.SourcesDirectory).

condition tekenreeks.
Evalueer deze voorwaardeexpressie om te bepalen of deze taak moet worden uitgevoerd.

continueOnError booleaanse.
Doorgaan met uitvoeren, zelfs bij een fout?

displayName tekenreeks.
leesbare naam voor de taak.

target doel.
Omgeving waarin deze taak moet worden uitgevoerd.

enabled booleaanse.
Deze taak uitvoeren wanneer de taak wordt uitgevoerd?

env tekenreekswoordenlijst.
variabelen die moeten worden toegewezen aan de omgeving van het proces.

name tekenreeks.
id van de stap. Acceptabele waarden: [-_A-Za-z0-9]*.

timeoutInMinutes tekenreeks.
Tijd om te wachten tot deze taak is voltooid voordat de server deze doodt.

Notitie

Pijplijnen kunnen worden geconfigureerd met een time-out op taakniveau. Als het time-outinterval op taakniveau is verstreken voordat de stap is voltooid, wordt de actieve taak (inclusief uw stap) beëindigd, zelfs als de stap is geconfigureerd met een langer timeoutInMinutes interval. Zie Time-outsvoor meer informatie.

retryCountOnTaskFailure tekenreeks.
aantal nieuwe pogingen als de taak mislukt.

Opmerkingen

Het trefwoord script is een snelkoppeling voor de opdrachtregeltaak. De taak voert een script uit met behulp van cmd.exe in Windows en Bash op andere platforms.

Als je niet instelt workingDirectory, draait het script vanaf $(Build.SourcesDirectory), wat de root is van de gecheckte repository voor de taak. Stel workingDirectory in wanneer je script in een andere map moet starten, zoals een submap die je buildscripts of projectbestanden bevat.

Meer informatie over voorwaarden, time-outsen stapdoelen.

Voorbeelden

Als u geen opdrachtmodus opgeeft, kunt u de target structuur verkorten tot:

- script:
  target: string  # container name or the word 'host'

steps:
- script: echo Hello world!
  displayName: Say hello

Het volgende voorbeeld toont de standaard werkmap wanneer workingDirectory niet is opgegeven:

steps:
- script: |
    echo "Default working directory:"
    pwd
  displayName: Show default working directory

Zie ook

• opdrachtregeltaak