steps.pwsh definition

  • Artikel

Der pwsh Schritt führt ein Skript in PowerShell Core unter Windows, macOS und Linux aus.

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.

Definitionen, die auf diese Definition verweisen: Schritte

Eigenschaften

pwsh Schnur. Erforderlich als erste Eigenschaft.
PowerShell-Inlineskript.

errorActionPreference Schnur.
Sofern nicht anders angegeben, wird für die Fehleraktionseinstellung standardmäßig der Wert stop verwendet. Weitere Informationen finden Sie in folgendem Abschnitt.

failOnStderr Schnur.
Fehler beim Task, wenn die Ausgabe an Stderr gesendet wird?

ignoreLASTEXITCODE Schnur.
Überprüfen Sie den endgültigen Exitcode des Skripts, um festzustellen, ob der Schritt erfolgreich war?

workingDirectory Schnur.
Starten Sie das Skript mit diesem Arbeitsverzeichnis.

condition Schnur.
Werten Sie diesen Bedingungsausdruck aus, um zu bestimmen, ob dieser Task ausgeführt werden soll.

continueOnErrorBoolescher Wert.
Die Ausführung auch bei Einem Fehler fortsetzen?

displayName Schnur.
Lesbarer Name für die Aufgabe.

targettarget.
Umgebung, in der dieser Task ausgeführt werden soll.

enabledBoolescher Wert.
Führen Sie diese Aufgabe aus, wenn der Auftrag ausgeführt wird?

env Zeichenfolgenwörterbuch.
Variablen, die der Umgebung des Prozesses zugeordnet werden sollen.

name Schnur.
ID des Schritts. Zulässige Werte: [-_A-Za-z0-9]*.

timeoutInMinutes Schnur.
Zeit, bis diese Aufgabe abgeschlossen ist, bevor sie vom Server beendet wird.

Hinweis

Pipelines können mit einem Timeout auf Auftragsebene konfiguriert werden. Wenn das Timeoutintervall auf Auftragsebene verstrichen ist, bevor der Schritt abgeschlossen ist, wird der ausgeführte Auftrag (einschließlich Ihres Schritts) beendet, auch wenn der Schritt mit einem längeren timeoutInMinutes Intervall konfiguriert ist. Weitere Informationen finden Sie unter Timeouts.

retryCountOnTaskFailure Schnur.
Anzahl von Wiederholungsversuchen, wenn der Task fehlschlägt.

Hinweise

Das pwsh-Schlüsselwort ist eine Verknüpfung für die PowerShell-Aufgabe, wenn der pwsh-Wert dieser Aufgabe auf TRUE festgelegt ist. Die Aufgabe führt ein Skript in PowerShell Core unter Windows, macOS und Linux aus.

Erfahren Sie mehr über Bedingungen und Timeouts.

Jede PowerShell-Sitzung bleibt nur für die Dauer des Auftrags, in dem sie ausgeführt wird, bestehen. Vorgänge, die davon abhängen, welches Bootstrapping stattgefunden hat, müssen sich im selben Auftrag wie der Bootstrap befinden.

Beispiele

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

Weitere Informationen