steps.task definition

Ein task Schritt führt eine Aufgabe aus.

Alle Aufgaben unterstützen die folgenden allgemeinen Eigenschaften.

steps:
- task: string # Required as first property. Name of the task to run.
  inputs: # Inputs for the task.
    string: string # Name/value pairs
  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.

Definitionen, die auf diese Definition verweisen: Schritte

Eigenschaften

task Zeichenfolge. Erforderlich als erste Eigenschaft.
Name der auszuführenden Aufgabe.

inputs Zeichenfolgenwörterbuch.
Eingaben für den Vorgang.

condition Zeichenfolge.
Diesen Bedingungsausdruck auswerten, um zu bestimmen, ob diese Aufgabe ausgeführt werden soll.

continueOnError booleschen.
Auch bei Fehlern weiter ausgeführt werden?

displayName Zeichenfolge.
Lesbarer Name für den Vorgang.

target Ziel-.
Umgebung, in der diese Aufgabe ausgeführt werden soll.

enabled booleschen.
Diese Aufgabe ausführen, wenn der Auftrag ausgeführt wird?

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

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

timeoutInMinutes Zeichenfolge.
Zeit, bis diese Aufgabe abgeschlossen ist, bevor der Server beendet wird. Verwenden Sie z. B. timeoutInMinutes: 10, um ein Timeout von 10 Minuten zu konfigurieren.

Hinweis

Pipelines können mit einem Timeout auf Auftragsebene konfiguriert werden. Wenn das Zeitüberschreitungsintervall auf Auftragsebene vor Abschluss des Schritts verstrichen 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 Zeichenfolge.
Anzahl der Wiederholungen, wenn der Vorgang fehlschlägt. Auf Azure DevOps Server 2022, 2022.1 und 2022.2 werden Wiederholungen nur für Agentaufträge unterstützt. Weitere Informationen finden Sie unter Azure DevOps-Dienstupdate vom 16. November 2021 – Automatische Wiederholungen für eine Aufgabe und Azure DevOps-Dienstupdate vom 14. Juni 2025 – Wiederholungen für Serveraufgaben.

Bemerkungen

Aufgaben sind die Bausteine einer Pipeline. Es gibt einen Katalog mit Aufgaben zur Auswahl stehen.

Wenn Sie keinen Befehlsmodus angeben, können Sie die target Struktur auf Folgendes kürzen:

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

Allgemeine Aufgabeneigenschaften

Alle Aufgaben unterstützen zusätzlich zu name und inputseine Reihe allgemeiner Eigenschaften. Eine Liste der allgemeinen Aufgabeneigenschaften finden Sie im vorherigen abschnitt Eigenschaften. Weitere Informationen zum Konfigurieren dieser Eigenschaften finden Sie unter Aufgabensteuerungsoptionen und Variablen der Taskumgebung.

Erfahren Sie mehr über Bedingungen, Timeoutsund Schrittziele.

Beispiele

steps:
- task: VSBuild@1
  displayName: Build
  timeoutInMinutes: 120
  inputs:
    solution: '**\*.sln'

Siehe auch

• Aufgaben
• Aufgabenkatalog