Sdílet prostřednictvím

Definice steps.pwsh

  • Článek

Tento pwsh krok spustí skript v PowerShellu Core ve Windows, macOS a Linuxu.

steps:
- pwsh: 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:
- pwsh: 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.

steps:
- pwsh: 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.
  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.

Definice, které odkazují na tuto definici: kroky

Vlastnosti

pwsh Řetězec. Požadováno jako první vlastnost.
Vložený skript PowerShellu

errorActionPreference Řetězec.
Pokud není uvedeno jinak, předvolba chybové akce se ve výchozím nastavení nastaví na hodnotu stop. Další informace naleznete v následující části.

failOnStderr Řetězec.
Selhání úlohy, pokud se výstup odešle do Stderr?

ignoreLASTEXITCODE Řetězec.
Zkontrolujte konečný ukončovací kód skriptu a zjistěte, jestli byl krok úspěšný.

workingDirectory Řetězec.
Spusťte skript s tímto pracovním adresářem.

condition Řetězec.
Vyhodnocením tohoto výrazu podmínky určete, zda se má tato úloha spustit.

continueOnErrorlogická hodnota.
Chcete pokračovat v provozu i při selhání?

displayName Řetězec.
Název úkolu čitelný pro člověka.

targetcíl.
Prostředí, ve kterém se má tato úloha spustit.

enabledlogická hodnota.
Spustit tuto úlohu při spuštění úlohy?

env slovník řetězců.
Proměnné, které se mají mapovat do prostředí procesu.

name Řetězec.
ID kroku Přijatelné hodnoty: [-_A-Za-z0-9]*.

timeoutInMinutes Řetězec.
Doba čekání na dokončení této úlohy, než ji server ukončí.

Poznámka

Kanály můžou být nakonfigurované s časovým limitem na úrovni úlohy. Pokud interval časového limitu na úrovni úlohy uplynou před dokončením kroku, spuštěná úloha (včetně vašeho kroku) se ukončí, i když je krok nakonfigurovaný s delším timeoutInMinutes intervalem. Další informace najdete v tématu Vypršení časových limitů.

retryCountOnTaskFailure Řetězec.
Počet opakovaných pokusů v případě selhání úlohy

Poznámky

Klíčové pwsh slovo je zkratka pro powershellovou úlohu , pokud je hodnota pwsh této úlohy nastavená na true. Úloha spustí skript v PowerShellu Core ve Windows, macOS a Linuxu.

Přečtěte si další informace o podmínkách a časových limitech.

Každá relace PowerShellu trvá jenom po dobu trvání úlohy, ve které se spouští. Úkoly, které závisí na tom, co bylo spuštěno, musí být ve stejné úloze jako bootstrap.

Příklady

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

Viz také