Megosztás a következőn keresztül:

steps.powerShell-definíció

A powershell lépés egy szkriptet futtat a Windows PowerShell vagy a pwsh (Linux és macOS) használatával.

steps:
- powershell: string # Required as first property. Inline PowerShell script.
  errorActionPreference: string # Unless otherwise specified, the error action preference defaults to the value stop. See the following section for more information.
  failOnStderr: string # Fail the task if output is sent to Stderr?
  ignoreLASTEXITCODE: string # Check the final exit code of the script to determine whether the step succeeded?
  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.

steps:
- powershell: string # Required as first property. Inline PowerShell script.
  errorActionPreference: string # Unless otherwise specified, the error action preference defaults to the value stop. See the following section for more information.
  failOnStderr: string # Fail the task if output is sent to Stderr?
  ignoreLASTEXITCODE: string # Check the final exit code of the script to determine whether the step succeeded?
  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.

A definícióra hivatkozó definíciók: lépések

Tulajdonságok

powershell sztring. Első tulajdonságként kötelező megadni.
beágyazott PowerShell-szkriptet.

errorActionPreference sztring.
Ha másként nincs megadva, a hibaművelet beállításai alapértelmezés szerint az érték leállítása lesznek. További információért tekintse meg a következő szakaszt.

failOnStderr sztring.
Sikertelen a feladat, ha a kimenetet a Stderrnek küldi?

ignoreLASTEXITCODE sztring.
Ellenőrizze a szkript végleges kilépési kódját annak megállapításához, hogy a lépés sikeres volt-e?

workingDirectory sztring.
Indítsa el a szkriptet ezzel a munkakönyvtárral.

condition sztring.
A feltételkifejezés kiértékelése annak meghatározásához, hogy futtassa-e ezt a feladatot.

continueOnError logikai.
Továbbra is fut a hiba?

displayName sztring.
feladat emberi olvasható nevét.

target cél.
környezetet, amelyben futtatni szeretné ezt a feladatot.

enabled logikai.
Futtassa ezt a feladatot a feladat futtatásakor?

env sztringszótár.
változókat a folyamat környezetébe való leképezéshez.

name sztring.
lépés azonosítója. Elfogadható értékek: [-_A-Za-z0-9]*.

timeoutInMinutes sztring.
Várakozási idő, amíg a feladat befejeződik, mielőtt a kiszolgáló leáll.

Megjegyzés

A folyamatok konfigurálhatók feladatszintű időtúllépéssel. Ha a feladatszint időtúllépési időköze a lépés befejezése előtt eltelik, a futó feladat (beleértve a lépést is) leáll, még akkor is, ha a lépés hosszabb timeoutInMinutes intervallummal van konfigurálva. További információ: időtúllépések.

retryCountOnTaskFailure sztring.
Újrapróbálkozések száma, ha a feladat meghiúsul.

Megjegyzések

A powershell kulcsszó a PowerShell-feladatparancsikonja. A feladat windowsos PowerShell vagy pwsh (Linux és macOS) használatával futtat szkriptet.

Minden PowerShell-munkamenet csak annak a feladatnak az időtartamára tart, amelyben fut. A rendszerindítástól függő feladatoknak ugyanabban a feladatban kell lenniük, mint a bootstrap.

További információ a feltételekről és időtúllépésekről.

Hibaművelet beállításai

Ha másként nincs megadva, a hibaművelet beállításai alapértelmezés szerint a stopértékre kerülnek, és a $ErrorActionPreference = 'stop' sor előre fel van függve a szkript elejére.

Ha a hibaművelet beállítása leáll, a hibák miatt a PowerShell leállítja a feladatot, és egy nem aero kilépési kódot ad vissza. A feladat sikertelenként is meg van jelölve.

errorActionPreference: stop | continue | silentlyContinue

steps:
- powershell: |
    Write-Error 'Uh oh, an error occurred'
    Write-Host 'Trying again...'
  displayName: Error action preference
  errorActionPreference: continue

Utolsó kilépési kód figyelmen kívül hagyása

A szkriptből visszaadott utolsó kilépési kód alapértelmezés szerint be van jelölve. A nonzero kód egy lépéshibát jelez, amely esetben a rendszer hozzáfűzi a szkriptet a következőkkel:

if ((Test-Path -LiteralPath variable:\LASTEXITCODE)) { exit $LASTEXITCODE }

Ha nem szeretné ezt a viselkedést, adja meg a ignoreLASTEXITCODE: true.

ignoreLASTEXITCODE: boolean

steps:
- powershell: git nosuchcommand
  displayName: Ignore last exit code
  ignoreLASTEXITCODE: true

További információ a feltételekről és időtúllépésekről.

Példák

steps:
- powershell: Write-Host Hello $Env:name
  displayName: Say hello
  name: firstStep
  workingDirectory: $(build.sourcesDirectory)
  failOnStderr: true
  env:
    name: Microsoft

Lásd még