Azure Pipelines-Aufgabenreferenz

Eine Aufgabe führt eine Aktion in einer Pipeline aus. Beispielsweise kann eine Aufgabe eine App erstellen, mit Azure-Ressourcen interagieren, ein Tool installieren oder einen Test ausführen. Aufgaben sind die Bausteine zum Definieren der Automatisierung in einer Pipeline.

In den Artikeln in diesem Abschnitt werden die integrierten Aufgaben für Azure Pipelines beschrieben und die Semantik für Attribute angegeben, die für jede Aufgabe eine besondere Bedeutung haben.

Details zu den allgemeinen Attributen, die von Tasks unterstützt werden, finden Sie in der YAML-Referenz für steps.task .

Anleitungen und Tutorials zum Erstellen von Pipelines mithilfe von Aufgaben, einschließlich des Erstellens benutzerdefinierter Aufgaben, benutzerdefinierter Erweiterungen und Suchen von Aufgaben auf dem Visual Studio Marketplace, finden Sie unter Aufgabenkonzepte und Azure Pipelines-Dokumentation.

Wichtig

Um die Aufgabenreferenz für Aufgaben anzuzeigen, die für Ihre Plattform verfügbar sind, stellen Sie sicher, dass Sie die richtige Azure DevOps-Version aus der Versionsauswahl auswählen, die sich über dem Inhaltsverzeichnis befindet. Die Featureunterstützung variiert abhängig davon, ob Sie mit Azure DevOps Services oder einer lokalen Version von Azure DevOps Server arbeiten.
Informationen zur lokalen Version, die Sie verwenden, finden Sie unter Suchen nach Ihrer Azure DevOps-Plattform und -Version.

Buildaufgaben

Aufgabe	BESCHREIBUNG
.NET Core DotNetCoreCLI@2 DotNetCoreCLI@1 DotNetCoreCLI@0	Hiermit wird eine .NET-Anwendung erstellt, getestet paketiert oder veröffentlicht oder ein benutzerdefinierter .NET-Befehl ausgeführt.
AutoBuild für erweiterte Sicherheit AdvancedSecurity-Codeql-Autobuild@1	Versucht, das Repository zu erstellen, indem Projektdateien im Quellordner gesucht und erstellt werden.
Erweiterte Sicherheit: Initialisieren von CodeQL AdvancedSecurity-Codeql-Init@1	Initialisiert die CodeQL-Datenbank in Vorbereitung auf die Erstellung.
Erweiterte Sicherheit Ausführen der CodeQL-Analyse AdvancedSecurity-Codeql-Analyze@1	Schließt die CodeQL-Datenbank ab und führt die Analyseabfragen aus.
Android Build AndroidBuild@1	AndroidBuild@1 ist veraltet. Verwenden Sie Gradle.
Android-Signatur AndroidSigning@3 AndroidSigning@2 AndroidSigning@1	Signieren und Ausrichten von Android APK-Dateien.
Ant Ant@1	Erstellen sie mit Apache Ant.
Azure IoT Edge AzureIoTEdge@2	Erstellen und Bereitstellen eines Azure IoT Edge-Images
CMake CMake@1	Erstellen sie mit dem plattformübergreifenden CMake-Buildsystem.
Containerbuild ContainerBuild@0	Containerbuildtask.
Docker Docker@2 Docker@1 Docker@0	Erstellen oder Pushen von Docker-Images, Anmelden oder Abmelden, Starten oder Beenden von Containern oder Ausführen eines Docker-Befehls.
Docker Compose DockerCompose@0	Erstellen, Pushen oder führen Sie Docker-Anwendungen mit mehreren Containern aus. Aufgabe kann mit Docker oder Azure Container Registry verwendet werden.
Herunterladen von GitHub Nuget-Paketen DownloadGitHubNugetPackage@1	Stellen Sie Ihre Nuget-Pakete mithilfe der dotnet CLI wieder her.
Go Go@0	Rufen Sie eine Go-Anwendung ab, erstellen Oder testen Sie sie, oder führen Sie einen benutzerdefinierten Go-Befehl aus.
Gradle Gradle@3 Gradle@2 Gradle@1	Erstellen sie mithilfe eines Gradle-Wrapperskripts.
Grunt Grunt@0	Führen Sie den Grunt JavaScript-Aufgabenrunner aus.
Schluck gulp@1 gulp@0	Führen Sie das gulp Node.js streamingtaskbasiertes Buildsystem aus.
Indexquellen und Veröffentlichungssymbole PublishSymbols@2 PublishSymbols@1	Indizieren Sie Ihren Quellcode, und veröffentlichen Sie Symbole auf einer Dateifreigabe oder einem Azure Artifacts-Symbolserver.
Jenkins-Warteschlangenauftrag JenkinsQueueJob@2	Stellen Sie einen Auftrag auf einem Jenkins-Server in die Warteschlange.
Jenkins-Warteschlangenauftrag JenkinsQueueJob@1	Stellen Sie einen Auftrag auf einem Jenkins-Server in die Warteschlange.
Maven Maven@4 Maven@3 Maven@2 Maven@1	Erstellen, Testen und Bereitstellen mit Apache Maven.
MSBuild MSBuild@1	Erstellen sie mit MSBuild.
Vorbereiten der Analysekonfiguration SonarQubePrepare@5 SonarQubePrepare@4	Vorbereiten der SonarQube-Analysekonfiguration.
Veröffentlichen des Quality Gate-Ergebnisses SonarQubePublish@5 SonarQubePublish@4	Veröffentlichen Sie das Quality Gate-Ergebnis von SonarQube im Azure DevOps-Buildergebnis, das nach der tatsächlichen Analyse verwendet werden soll.
Ausführen der Codeanalyse SonarQubeAnalyze@5 SonarQubeAnalyze@4	Führen Sie den Scanner aus, und laden Sie die Ergebnisse auf den SonarQube-Server hoch.
Visual Studio-Build VSBuild@1	Erstellen Sie mit MSBuild, und legen Sie die Versioneigenschaft von Visual Studio fest.
Xamarin.Android XamarinAndroid@1	Erstellen sie eine Android-App mit Xamarin.
Xamarin.iOS XamariniOS@2 XamariniOS@1	Erstellen Sie eine iOS-App mit Xamarin unter macOS.
Xcode Xcode@5 Xcode@4	Erstellen, Testen oder Archivieren eines Xcode-Arbeitsbereichs unter macOS. Packen Sie optional eine App.
Xcode-Build Xcode@3 Xcode@2	Erstellen Sie einen Xcode-Arbeitsbereich unter macOS.
Xcode-Paket iOS XcodePackageiOS@0	Generieren Sie mithilfe von xcrun (Xcode 7 oder niedriger) eine IPA-Datei aus der Xcode-Buildausgabe.

Bereitstellungsaufgaben

Aufgabe	BESCHREIBUNG
App Center verteilen AppCenterDistribute@3 AppCenterDistribute@2 AppCenterDistribute@1 AppCenterDistribute@0	Verteilen von App-Builds an Tester und Benutzer über Visual Studio App Center.
ARM-Vorlagenbereitstellung AzureResourceManagerTemplateDeployment@3	Stellen Sie eine ARM-Vorlage (Azure Resource Manager) für alle Bereitstellungsbereiche bereit.
Azure App Service Classic (veraltet) AzureWebPowerShellDeployment@1	Erstellen oder aktualisieren Sie Azure App Service mithilfe von Azure PowerShell.
Azure App Service Bereitstellen AzureRmWebAppDeployment@4 AzureRmWebAppDeployment@3 AzureRmWebAppDeployment@2	Bereitstellen für Azure App Service einer Web-, Mobil- oder API-App mithilfe von Docker, Java, .NET, .NET Core, Node.js, PHP, Python oder Ruby.
Azure App Service Verwalten AzureAppServiceManage@0	Starten, Beenden, Neustarten, Austauschen von Steckplätzen, Löschen von Steckplätzen, Installieren von Standorterweiterungen oder Aktivieren der kontinuierlichen Überwachung für eine Azure App Service.
Azure App Service Einstellungen AzureAppServiceSettings@1	Aktualisieren/Hinzufügen von App-Einstellungen für eine Azure-Web-App für Linux oder Windows.
Azure-Befehlszeilenschnittstelle AzureCLI@2 AzureCLI@1	Führen Sie Azure CLI-Befehle für ein Azure-Abonnement in einem PowerShell Core/Shell-Skript aus, wenn sie unter Linux-Agent oder PowerShell/PowerShell Core/Batch-Skript ausgeführt werden, wenn sie auf dem Windows-Agent ausgeführt werden.
Vorschau der Azure CLI AzureCLI@0	Führen Sie ein Shell- oder Batch-Skript mit Azure CLI-Befehlen für ein Azure-Abonnement aus.
Azure Cloud Service-Bereitstellung AzureCloudPowerShellDeployment@2 AzureCloudPowerShellDeployment@1	Stellen Sie einen Azure-Clouddienst bereit.
Bereitstellen von Azure Container Apps AzureContainerApps@1 AzureContainerApps@0	Eine Azure DevOps-Aufgabe zum Erstellen und Bereitstellen von Azure Container Apps.
Azure Database for MySQL Bereitstellung AzureMysqlDeployment@1	Führen Sie Ihre Skripts aus, und nehmen Sie Änderungen an Ihrer Azure Database for MySQL vor.
Kopieren einer Azure-Datei AzureFileCopy@6 AzureFileCopy@5 AzureFileCopy@4 AzureFileCopy@3 AzureFileCopy@2 AzureFileCopy@1	Kopieren von Dateien auf Azure Blob Storage oder virtuelle Computer.
Azure-Funktion in Kubernetes AzureFunctionOnKubernetes@1 AzureFunctionOnKubernetes@0	Bereitstellen der Azure-Funktion im Kubernetes-Cluster
Azure Functions Deploy AzureFunctionApp@2 AzureFunctionApp@1	Aktualisieren sie eine Funktions-App mit .NET, Python, JavaScript, PowerShell und Java-basierten Webanwendungen.
Azure Functions für Container AzureFunctionAppContainer@1	Aktualisieren einer Funktions-App mit einem Docker-Container.
Azure Key Vault AzureKeyVault@2 AzureKeyVault@1	Laden Sie Azure Key Vault-Geheimnisse herunter.
Azure Monitor-Warnungen (veraltet) AzureMonitorAlerts@0	Konfigurieren von Warnungen zu verfügbaren Metriken für eine Azure-Ressource (veraltet).
Azure PowerShell AzurePowerShell@5 AzurePowerShell@4 AzurePowerShell@3 AzurePowerShell@2 AzurePowerShell@1	Führen Sie ein PowerShell-Skript in einer Azure-Umgebung aus.
Bereitstellung von Azure-Ressourcengruppen AzureResourceGroupDeployment@2	Stellen Sie eine ARM-Vorlage (Azure Resource Manager) in einer Ressourcengruppe bereit, und verwalten Sie virtuelle Computer.
Azure-Ressourcengruppenbereitstellung AzureResourceGroupDeployment@1	Bereitstellen, Starten, Beenden und Löschen von Azure-Ressourcengruppen
Azure Spring Apps AzureSpringCloud@0	Bereitstellen von Anwendungen in Azure Spring Apps und Verwalten von Bereitstellungen
Bereitstellung von Azure SQL-Datenbank SqlAzureDacpacDeployment@1	Stellen Sie eine Azure SQL-Datenbank mithilfe von DACPAC bereit, oder führen Sie Skripts mithilfe von SQLCMD aus.
Bereitstellung einer Azure-VM-Skalierungsgruppe AzureVmssDeployment@0	Stellen Sie ein Vm-Skalierungsgruppenimage bereit.
Azure-Web-App AzureWebApp@1	Stellen Sie eine Azure-Web-App für Linux oder Windows bereit.
Azure-Web-App für Container AzureWebAppContainer@1	Stellen Sie Container für Azure App Service bereit.
Erstellen eines Computerimages PackerBuild@1 PackerBuild@0	Erstellen Sie mithilfe von Packer ein Computerimage, das für die Bereitstellung von Azure-VM-Skalierungsgruppen verwendet werden kann.
Überprüfung der Einhaltung der Azure-Richtlinien AzurePolicyCheckGate@0	Sicherheits- und Konformitätsbewertung für Azure Policy.
Chef Chef@1	Stellen Sie in Chef-Umgebungen bereit, indem Sie Umgebungsattribute bearbeiten.
Chef Knife ChefKnife@1	Führen Sie Skripts mit Knife-Befehlen auf Ihrer Chef-Arbeitsstation aus.
Kopieren von Dateien über SSH CopyFilesOverSSH@0	Kopieren Sie Dateien oder Buildartefakte über SSH auf einen Remotecomputer.
Bereitstellen in Kubernetes KubernetesManifest@1 KubernetesManifest@0	Verwenden Sie Kubernetes-Manifestdateien, um in Clustern bereitzustellen oder sogar die Manifestdateien zu backen, die für Bereitstellungen mithilfe von Helm-Diagrammen verwendet werden sollen.
IIS-Web-App bereitstellen IISWebAppDeploymentOnMachineGroup@0	Stellen Sie eine Website oder Webanwendung mithilfe von Web Deploy bereit.
IIS-Web-App-Bereitstellung (veraltet) IISWebAppDeployment@1	Stellen Sie mithilfe von MSDeploy bereit, und erstellen/aktualisieren Sie dann Websites und App-Pools.
IIS-Web-App verwalten IISWebAppManagementOnMachineGroup@0	Erstellen oder Aktualisieren von Websites, Web-Apps, virtuellen Verzeichnissen oder Anwendungspools
REST-API aufrufen InvokeRESTAPI@1 InvokeRESTAPI@0	Rufen Sie eine REST-API als Teil Ihrer Pipeline auf.
Kubectl Kubernetes@1 Kubernetes@0	Bereitstellen, Konfigurieren und Aktualisieren eines Kubernetes-Clusters in Azure Container Service durch Ausführen von kubectl-Befehlen.
Benutzereingriff ManualIntervention@8	Halten Sie die Bereitstellung an, und warten Sie auf einen manuellen Eingriff.
Manuelle Validierung ManualValidation@0	[VORSCHAU] Halten Sie eine Pipelineausführung an, um auf eine manuelle Interaktion zu warten. Funktioniert nur mit YAML-Pipelines.
Bereitstellen einer MySQL-Datenbank MysqlDeploymentOnMachineGroup@1	Führen Sie Skripts aus, und nehmen Sie Änderungen an einer MySQL-Datenbank vor.
Packen und Bereitstellen von Helm-Diagrammen HelmDeploy@0	Stellen Sie einen Kubernetes-Cluster in Azure Container Service bereit, konfigurieren und aktualisieren Sie sie, indem Sie helm-Befehle ausführen.
PowerShell auf Zielcomputern PowerShellOnTargetMachines@3	Führen Sie PowerShell-Skripts auf Remotecomputern mithilfe von PSSession und Invoke-Command für Remoting aus.
PowerShell auf Zielcomputern PowerShellOnTargetMachines@2 PowerShellOnTargetMachines@1	Führen Sie PowerShell-Skripts auf Remotecomputern aus.
Service Fabric-Anwendungsbereitstellung ServiceFabricDeploy@1	Stellen Sie eine Azure Service Fabric-Anwendung in einem Cluster bereit.
Service Fabric Compose-Bereitstellung ServiceFabricComposeDeploy@0	Bereitstellen einer Docker Compose-Anwendung in einem Azure Service Fabric-Cluster
SQL Server Datenbankbereitstellung SqlDacpacDeploymentOnMachineGroup@0	Stellen Sie eine SQL Server-Datenbank mithilfe von DACPAC- oder SQL-Skripts bereit.
SQL Server Datenbankbereitstellung (veraltet) SqlServerDacpacDeployment@1	Stellen Sie eine SQL Server-Datenbank mithilfe von DACPAC bereit.
SSH SSH@0	Führen Sie Shellbefehle oder ein Skript mithilfe von SSH auf einem Remotecomputer aus.
Kopieren der Windows-Computerdatei WindowsMachineFileCopy@2 WindowsMachineFileCopy@1	Kopieren von Dateien auf Windows-Remotecomputer.

Paketaufgaben

Aufgabe	BESCHREIBUNG
Cargo-Authentifizierung (für Aufgabenläufer) CargoAuthenticate@0	Authentifizierungsaufgabe für den Frachtclient, der zum Installieren der Verteilung von Frachtkisten verwendet wird.
CocoaPods CocoaPods@0	Installieren Sie CocoaPods-Abhängigkeiten für Swift- und Objective-C Cocoa-Projekte.
Conda-Umgebung CondaEnvironment@1 CondaEnvironment@0	Diese Aufgabe ist veraltet. Verwenden Sie conda direkt im Skript, um mit Anaconda-Umgebungen zu arbeiten.
Herunterladen des GitHub Npm-Pakets DownloadGithubNpmPackage@1	Installieren Sie npm-Pakete von GitHub.
Maven-Authentifizierung MavenAuthenticate@0	Stellt Anmeldeinformationen für Azure Artifacts-Feeds und externe Maven-Repositorys bereit.
npm Npm@1 Npm@0	Installieren und veröffentlichen Sie npm-Pakete, oder führen Sie einen npm-Befehl aus. Unterstützt npmjs.com und authentifizierte Registrierungen wie Azure Artifacts.
npm authenticate (für Aufgabenrunner) npmAuthenticate@0	Verwenden Sie diese Aufgabe nicht, wenn Sie auch die npm-Aufgabe verwenden. Stellt NPM-Anmelde Informationen für eine npmrc-Datei in Ihrem Repository für den Bereich des Builds bereit. Dies ermöglicht es npm-Aufgabenausführungen wie gulp und Grunt, sich bei privaten Registraturen zu authentifizieren.
NuGet NuGetCommand@2	Wiederherstellen, Packen oder Pushen von NuGet-Paketen oder Ausführen eines NuGet-Befehls. Unterstützt NuGet.org und authentifizierte Feeds wie Azure Artifacts und MyGet. Verwendet NuGet.exe und funktioniert mit .NET Framework Apps. Verwenden Sie für .NET Core- und .NET Standard-Apps die .NET Core-Aufgabe.
NuGet-Authentifizierung NuGetAuthenticate@1 NuGetAuthenticate@0	Konfigurieren Sie NuGet-Tools für die Authentifizierung mit Azure Artifacts und anderen NuGet-Repositories Erfordert NuGet >= 4.8.5385, dotnet >= 6 oder MSBuild >= 15.8.166.59604.
NuGet-Befehl NuGet@0	Veraltet: Verwenden Sie stattdessen die Aufgabe "NuGet". Es funktioniert mit dem neuen Tool Installer-Framework, sodass Sie problemlos neue Versionen von NuGet verwenden können, ohne auf ein Aufgabenupdate zu warten, bietet eine bessere Unterstützung für authentifizierte Feeds außerhalb dieser organization/Sammlung und verwendet Standardmäßig NuGet 4.
NuGet Installer NuGetInstaller@0	Installiert oder stellt fehlende NuGet-Pakete wieder her. Verwenden Sie NuGetAuthenticate@0 Aufgabe für die neuesten Funktionen.
NuGet-Packager NuGetPackager@0	Veraltet: Verwenden Sie stattdessen die Aufgabe "NuGet". Es funktioniert mit dem neuen Tool Installer-Framework, sodass Sie problemlos neue Versionen von NuGet verwenden können, ohne auf ein Aufgabenupdate zu warten, bietet eine bessere Unterstützung für authentifizierte Feeds außerhalb dieser organization/Sammlung und verwendet Standardmäßig NuGet 4.
NuGet-Herausgeber NuGetPublisher@0	Veraltet: Verwenden Sie stattdessen die Aufgabe "NuGet". Es funktioniert mit dem neuen Tool Installer-Framework, sodass Sie problemlos neue Versionen von NuGet verwenden können, ohne auf ein Aufgabenupdate zu warten, bietet eine bessere Unterstützung für authentifizierte Feeds außerhalb dieser organization/Sammlung und verwendet Standardmäßig NuGet 4.
NuGet-Wiederherstellung NuGetRestore@1	Stellt NuGet-Pakete als Vorbereitung für einen Visual Studio-Buildschritt wieder her.
PyPI-Herausgeber PyPIPublisher@0	Erstellen Sie mithilfe von Twine einen Sdist oder ein Rad, und laden Sie es in einen PyPI-kompatiblen Index hoch.
Python-PIP-Authentifizierung PipAuthenticate@1 PipAuthenticate@0	Authentifizierungsaufgabe für den pip-Client, der zum Installieren von Python-Verteilungen verwendet wird.
Authentifizieren des Python-Zwillingsuploads TwineAuthenticate@1 TwineAuthenticate@0	Authentifizieren Sie sich zum Hochladen von Python-Distributionen mithilfe von Twine. Fügen Sie "-r FeedName/EndpointName --config-file $(PYPIRC_PATH)" zum Befehl zum Hochladen von Twine hinzu. Verwenden Sie für Feeds, die in diesem organization vorhanden sind, den Feednamen als Repository (-r). Verwenden Sie andernfalls den in der Dienstverbindung definierten Endpunktnamen.
Universal Packages UniversalPackages@0	Laden Sie universelle Pakete herunter oder veröffentlichen Sie sie.
Xamarin-Komponentenwiederherstellung XamarinComponentRestore@0	Diese Aufgabe ist veraltet. Verwenden Sie stattdessen "NuGet".

Testaufgaben

Aufgabe	BESCHREIBUNG
App Center-Test AppCenterTest@1	Hiermit werden App-Pakete mit Visual Studio App Center getestet.
Azure-Auslastungstest AzureLoadTest@1	Automatisieren von Leistungsregressionstests mit Azure Load Testing
Containerstrukturtest ContainerStructureTest@0	Verwendet container-structure-test (https://github.com/GoogleContainerTools/container-structure-test), um die Struktur eines Images basierend auf vier Kategorien von Tests zu überprüfen: Befehlstests, Dateiexistenztests, Dateiinhaltstests und Metadatentests.
Mobile Center-Test VSMobileCenterTest@0	Testen Sie Mobile App-Pakete mit Visual Studio Mobile Center.
Veröffentlichen von Code Coverage-Ergebnissen PublishCodeCoverageResults@2 PublishCodeCoverageResults@1	Veröffentlichen Sie alle Code coverage-Ergebnisse aus einem Build.
Veröffentlichen von Testergebnissen PublishTestResults@1	Veröffentlichen sie Testergebnisse in Azure Pipelines.
Testergebnisse veröffentlichen PublishTestResults@2	Veröffentlichen sie Testergebnisse in Azure Pipelines.
Ausführen von Funktionstests RunVisualStudioTestsusingTestAgent@1	Veraltet: Diese Aufgabe und ihre Begleitaufgabe (Visual Studio Test Agent-Bereitstellung) sind veraltet. Verwenden Sie stattdessen die Aufgabe "Visual Studio Test". Der VSTest-Task kann sowohl Komponenten- als auch Funktionstests ausführen. Führen Sie Tests für einen oder mehrere Agents mithilfe der Auftragseinstellung für mehrere Agents aus. Verwenden Sie die Aufgabe "Visual Studio Test Platform", um Tests auszuführen, ohne Visual Studio auf dem Agent zu benötigen. Der VSTest-Task bietet auch neue Funktionen, z. B. das automatische Erneute Ausführen fehlgeschlagener Tests.
Visual Studio Test VSTest@3 VSTest@2 VSTest@1	Führen Sie Komponenten- und Funktionstests (Selenium, Appium, Test der programmierten UI usw.) mithilfe des Visual Studio Test (VsTest)-Runners aus. Es können Testframeworks mit einem Visual Studio-Testadapter wie MsTest, xUnit, NUnit, Chutzpah (für JavaScript-Tests mit QUnit, Mocha und Jasmine) usw. ausgeführt werden. Tests können mithilfe dieser Aufgabe (Version 2) auf mehrere Agents verteilt werden.
Visual Studio-Test-Agent-Bereitstellung DeployVisualStudioTestAgent@2	DeployVisualStudioTestAgent@2 ist veraltet. Verwenden Sie den Visual Studio-Testtask, um Komponenten- und Funktionstests auszuführen.
Visual Studio Test-Agent-Bereitstellung DeployVisualStudioTestAgent@1	Bereitstellen und Konfigurieren des Test-Agents zum Ausführen von Tests auf einer Reihe von Computern.
Xamarin Test Cloud XamarinTestCloud@1	[Veraltet] Testen Sie mobile Apps mit Xamarin Test Cloud mithilfe von Xamarin.UITest. Verwenden Sie stattdessen den Task "App Center-Test".

Toolaufgaben

Aufgabe	BESCHREIBUNG
Installationsprogramm für .NET Core SDK/Runtime DotNetCoreInstaller@1 DotNetCoreInstaller@0	Rufen Sie eine bestimmte Version des .NET Core SDK aus dem Internet oder lokalen Cache ab, und fügen Sie sie dem PFAD hinzu.
Docker CLI-Installationsprogramm DockerInstaller@0	Installieren Sie die Docker CLI auf dem Agent-Computer.
Duffle-Toolinstallationsprogramm DuffleInstaller@0	Installieren Sie eine angegebene Version von Duffle zum Installieren und Verwalten von CNAB-Bundles.
Go-Toolinstallationsprogramm GoTool@0	Suchen Sie im Cache, oder laden Sie eine bestimmte Version von Go herunter, und fügen Sie sie dem PFAD hinzu.
Helm-Toolinstallationsprogramm HelmInstaller@1 HelmInstaller@0	Installieren Sie Helm auf einem Agent-Computer.
Installieren von Azure Func Core Tools FuncToolsInstaller@0	Installieren Sie Azure Func Core Tools.
Java-Toolinstallationsprogramm JavaToolInstaller@0	Rufen Sie eine bestimmte Version von Java aus einem vom Benutzer bereitgestellten Azure-Blob oder dem Toolcache ab, und legen Sie JAVA_HOME fest.
Installer für Kubectl-Tool KubectlInstaller@0	Installieren Sie Kubectl auf dem Agent-Computer.
Kubelogin-Toolinstallationsprogramm KubeloginInstaller@0	Hilft bei der Installation von kubelogin.
NuGet-Toolinstallationsprogramm NuGetToolInstaller@1 NuGetToolInstaller@0	Ruft eine bestimmte Version von NuGet aus dem Internet oder dem Toolscache ab und fügt sie dem PFAD hinzu. Verwenden Sie diese Aufgabe, um die Version von NuGet zu ändern, die in den NuGet-Aufgaben verwendet wird.
Verwenden von .NET Core UseDotNet@2	Ruft eine bestimmte Version des .NET Core SDK aus dem Internet oder dem lokalen Cache ab und fügt sie dem PFAD hinzu. Verwenden Sie diese Aufgabe, um die Version von .NET Core zu ändern, die in nachfolgenden Aufgaben verwendet wird. Zusätzlich bietet Proxyunterstützung.
Verwenden Node.js Ökosystems UseNode@1 NodeTool@0	Richten Sie eine Node.js-Umgebung ein, und fügen Sie sie dem PFAD hinzu, um zusätzlich Proxyunterstützung bereitzustellen.
Verwenden der Python-Version UsePythonVersion@0	Verwenden Sie die angegebene Python-Version aus dem Toolcache, und fügen Sie sie optional dem PFAD hinzu.
Verwenden der Ruby-Version UseRubyVersion@0	Verwenden Sie die angegebene Version von Ruby aus dem Toolcache, und fügen Sie sie optional dem PFAD hinzu.
Visual Studio-Testplattforminstallationsprogramm VisualStudioTestPlatformInstaller@1	Rufen Sie die Testplattform aus nuget.org oder dem Toolcache ab. Erfüllt die "vstest"-Anforderung und kann zum Ausführen von Tests und Sammeln von Diagnosedaten mithilfe des Visual Studio-Testtasks verwendet werden.

Hilfsprogrammaufgaben

Aufgabe	BESCHREIBUNG
Erweiterte Überprüfung von Sicherheitsabhängigkeiten AdvancedSecurity-Dependency-Scanning@1	Suchen Sie im Quellcode nach Open Source Abhängigkeitsrisiken.
Archivdateien ArchiveFiles@2	Komprimieren Sie Dateien in .7z, .tar.gz oder .zip.
Archivieren von Dateien ArchiveFiles@1	Archivieren Sie Dateien mithilfe von Komprimierungsformaten wie .7z, .rar, .tar.gz und .zip.
Azure-Netzwerklastenausgleich AzureNLBManagement@1	Verbinden oder Trennen der Netzwerkschnittstelle eines virtuellen Azure-Computers mit dem Back-End-Adresspool eines Load Balancer.
Bash Bash@3	Führen Sie ein Bash-Skript unter macOS, Linux oder Windows aus.
Batchskript BatchScript@1	Führen Sie einen Windows-Befehl oder ein Batchskript aus, und erlauben Sie optional, die Umgebung zu ändern.
Cache Cache@2	Zwischenläufen zwischen Dateien zwischenspeichern.
Cache (Beta) CacheBeta@1 CacheBeta@0	Zwischenläufen zwischen Dateien zwischenspeichern.
Befehlszeile CmdLine@2 CmdLine@1	Ausführen eines Befehlszeilenskript unter Verwendung von Bash unter Linux und MacOS und cmd.exe unter Windows.
Buildartefakte kopieren und veröffentlichen CopyPublishBuildArtifacts@1	CopyPublishBuildArtifacts@1 ist veraltet. Verwenden Sie stattdessen die Aufgabe Dateien kopieren und die Aufgabe Buildartefakte veröffentlichen.
Kopieren von Dateien CopyFiles@2	Kopieren Sie Dateien aus einem Quellordner in einen Zielordner mithilfe von Mustern, die übereinstimmende Dateipfade (nicht Ordnerpfade).
Dateien kopieren CopyFiles@1	Kopieren Sie Dateien aus dem Quellordner in den Zielordner mithilfe von Minimatch-Mustern (Die Minimatch-Muster entsprechen nur Dateipfaden, nicht Ordnerpfaden).
Dateien mit cURL hochladen cURLUploader@2 cURLUploader@1	Verwenden Sie die von cURL unterstützten Protokolle, um Dateien hochzuladen.
Entschlüsselungsdatei (OpenSSL) DecryptFile@1	Entschlüsseln sie eine Datei mit OpenSSL.
Verzögern Delay@1	Verzögern Sie die weitere Ausführung eines Workflows um einen festen Zeitpunkt.
Löschen von Dateien DeleteFiles@1	Löschen Sie Ordner oder Dateien, die einem Muster entsprechen.
Bereitstellen einer statischen Azure-Web-App AzureStaticWebApp@0	Erstellen und Bereitstellen einer Azure Static Web App
Herunterladen von Artefakten aus der Dateifreigabe DownloadFileshareArtifacts@1	Laden Sie Artefakte aus einer Dateifreigabe wie \share\drop herunter.
Herunterladen von Buildartefakten DownloadBuildArtifacts@1 DownloadBuildArtifacts@0	Laden Sie Dateien herunter, die als Artefakte eines abgeschlossenen Builds gespeichert wurden.
Herunterladen von GitHub-Releases DownloadGitHubRelease@0	Lädt ein GitHub-Release aus einem Repository herunter.
Herunterladen des Pakets DownloadPackage@1 DownloadPackage@0	Laden Sie ein Paket aus einem Paketverwaltungsfeed in Azure Artifacts herunter.
Pipelineartefakte herunterladen DownloadPipelineArtifact@2 DownloadPipelineArtifact@1 DownloadPipelineArtifact@0	Laden Sie Build- und Pipelineartefakte herunter.
Sichere Datei herunterladen DownloadSecureFile@1	Laden Sie eine sichere Datei auf den Agent-Computer herunter.
Extrahieren von Dateien ExtractFiles@1	Extrahieren Sie eine Vielzahl von Archiv- und Komprimierungsdateien wie .7z, .rar, .tar.gz und .zip.
Dateitransformation FileTransform@2 FileTransform@1	Ersetzen Sie Token durch Variablenwerte in XML- oder JSON-Konfigurationsdateien.
FTP-Upload FtpUpload@2 FtpUpload@1	Laden Sie Dateien mithilfe von FTP hoch.
GitHub-Kommentar GitHubComment@0	Schreiben Sie einen Kommentar an Ihre GitHub-Entität, d. h. ein Problem oder einen Pull Request (PR).
GitHub Release GitHubRelease@1 GitHubRelease@0	Erstellen, Bearbeiten oder Löschen einer GitHub-Version.
Installieren des Apple-Zertifikats InstallAppleCertificate@2	Installieren Sie ein Apple-Zertifikat, das zum Erstellen auf einem macOS-Agent-Computer erforderlich ist.
Apple-Zertifikat installieren InstallAppleCertificate@1 InstallAppleCertificate@0	Installieren Sie ein Apple-Zertifikat, das zum Erstellen auf einem macOS-Agent erforderlich ist.
Installieren des Apple-Bereitstellungsprofils InstallAppleProvisioningProfile@1	Installieren Sie ein Apple-Bereitstellungsprofil, das zum Erstellen auf einem macOS-Agent-Computer erforderlich ist.
Apple-Bereitstellungsprofil installieren InstallAppleProvisioningProfile@0	Installieren Sie ein Apple-Bereitstellungsprofil, das für die Erstellung auf einem macOS-Agent erforderlich ist.
Installieren des SSH-Schlüssels InstallSSHKey@0	Installieren Sie einen SSH-Schlüssel vor einem Build oder einer Bereitstellung.
Aufrufen der Azure-Funktion AzureFunction@1 AzureFunction@0	Rufen Sie eine Azure-Funktion auf.
Jenkins-Downloadartefakte JenkinsDownloadArtifacts@1	Laden Sie Artefakte herunter, die von einem Jenkins-Auftrag erstellt wurden.
Node.js Aufgaben Runner-Installationsprogramm NodeTaskRunnerInstaller@0	Installieren Sie bestimmte Node.js Version zum Ausführen von Knotentasks.
Notation Notation@0	Azure Pipepine Task zum Einrichten der Notation CLI, Signieren und Überprüfen mit Notation.
PowerShell PowerShell@2 PowerShell@1	Führen Sie ein PowerShell-Skript unter Linux, macOS oder Windows aus.
Veröffentlichen von Buildartefakten PublishBuildArtifacts@1	Veröffentlichen Sie Buildartefakte in Azure Pipelines oder einer Windows-Dateifreigabe.
Veröffentlichen von Pipelineartefakten PublishPipelineArtifact@1 PublishPipelineArtifact@0	Veröffentlichen (Hochladen) einer Datei oder eines Verzeichnisses als benanntes Artefakt für die aktuelle Ausführung.
Veröffentlichen von Pipelinemetadaten PublishPipelineMetadata@0	Veröffentlichen Sie Pipelinemetadaten im Beweisspeicher.
Veröffentlichen in Azure Service Bus PublishToAzureServiceBus@1 PublishToAzureServiceBus@0	Sendet eine Nachricht an Azure Service Bus mithilfe einer Dienstverbindung (kein Agent erforderlich).
Python-Skript PythonScript@0	Führen Sie eine Python-Datei oder ein Inlineskript aus.
Abfragen von Azure Monitor-Warnungen AzureMonitor@1	Beachten Sie die konfigurierten Azure Monitor-Regeln für aktive Warnungen.
Abfragen von klassischen Azure Monitor-Warnungen AzureMonitor@0	Beachten Sie die konfigurierten klassischen Azure Monitor-Regeln für aktive Warnungen.
Abfragen von Arbeitselementen queryWorkItems@0	Führen Sie eine Arbeitselementabfrage aus, und überprüfen Sie die Anzahl der zurückgegebenen Elemente.
App überprüfen ReviewApp@0	Verwenden Sie diese Aufgabe unter Bereitstellungsphaseanbieter, um eine Ressource dynamisch zu erstellen.
Service Fabric PowerShell ServiceFabricPowerShell@1	Führen Sie ein PowerShell-Skript im Kontext einer Azure Service Fabric-Clusterverbindung aus.
Shellskript ShellScript@2	Führen Sie ein Shellskript mit Bash aus.
Service Fabric-App-Versionen aktualisieren ServiceFabricUpdateAppVersions@1	Aktualisiert automatisch die Versionen einer gepackten Service Fabric-Anwendung.
Aktualisieren von Service Fabric-Manifesten ServiceFabricUpdateManifests@2	Automatisches Aktualisieren von Teilen von Anwendungs- und Dienstmanifesten in einer gepackten Azure Service Fabric-Anwendung.
Xamarin-Lizenz XamarinLicense@1	[Veraltet] Upgrade auf kostenlose Version von Xamarin: https://store.xamarin.com.

Quelle öffnen

Diese Aufgaben sind Open Source auf GitHub. Feedback und Beiträge sind willkommen. Eine Liste der Aufgabenänderungen, einschließlich eines verlaufsbezogenen Datensatzes von Aufgabenupdates, finden Sie unter Änderungsprotokoll des Pipelinetasks .

Häufig gestellte Fragen

Was sind Aufgabeneingabealiasen?

Eingaben für eine Aufgabe werden durch , labelnameund identifiziert, und können eine oder mehrere optionale aliasesenthalten. Das folgende Beispiel ist ein Auszug aus dem Quellcode für die Eingabe des Eintrags für bekannte Hosts des InstallSSHKey@0 Task.

{
    "name": "hostName",
    "aliases": [
        "knownHostsEntry"
    ],
    "label": "Known Hosts Entry"
    ...
}

Vor der Einführung von YAML-Pipelines im Jahr 2019 wurden Pipelines mithilfe eines benutzeroberflächebasierten Pipeline-Editors erstellt und bearbeitet, und nur der label wurde von Pipelineautoren verwendet, um auf eine Aufgabeneingabe zu verweisen.

Als YAML-Pipelines im Jahr 2019 eingeführt wurden, begannen Pipelineautoren, die YAML verwenden, die Aufgabeneingabe name zu verwenden, um auf eine Aufgabeneingabe zu verweisen. In einigen Fällen waren die Aufgabeneingabenamen nicht beschreibend, daher aliases wurden hinzugefügt, um zusätzliche beschreibende Namen für Aufgabeneingaben bereitzustellen.

Der Task verfügt beispielsweise InstallSSHKey@0 über eine Eingabe für bekannte Hosts namens hostName , die einen Eintrag aus einer known_hosts-Datei erwartet. Die Bezeichnung "Eintrag für bekannte Hosts" im klassischen Pipeline-Designer macht dies deutlich, aber es ist nicht so eindeutig, wenn der hostName Name in einer YAML-Pipeline verwendet wird. Aufgabeneingabealiasen wurden eingeführt, damit Aufgabenautoren dekriptive Namen für ihre zuvor erstellten Aufgaben angeben können, und für die InstallSSHKey@0 Aufgabe wurde ein knownHostsEntryAlias hinzugefügt, wobei der ursprüngliche hostName Name aus Gründen der Kompatibilität mit vorhandenen Pipelines beibehalten wird, die diesen Namen verwenden.

Alle Elemente in einer Aufgabeneingabe aliases sind mit dem name in einer YAML-Pipeline austauschbar. Die folgenden beiden YAML-Codeausschnitte sind funktional identisch, wobei im ersten Beispiel der knownHostsEntry Alias und im zweiten Beispiel verwendet wird hostName.

- task: InstallSSHKey@0
  inputs:
    # Using knownHostsEntry alias
    knownHostsEntry: 'sample known hosts entry line'
    # Remainder of task inputs omitted

- task: InstallSSHKey@0
  inputs:
    # Using hostName name
    hostName: 'sample known hosts entry line'
    # Remainder of task inputs omitted

Ab Azure DevOps Server 2019.1 wurde der YAML-Pipeline-Editor eingeführt, der eine IntelliSense-Typfunktionalität bereitstellt.

Der YAML-Pipeline-Editor verwendet die Yamlschema - Get REST-API, um das schema abzurufen, das für die Validierung im Editor verwendet wird. Wenn eine Aufgabeneingabe über einen Alias verfügt, erhöht das Schema den Alias zum primären YAML-Namen für die Aufgabeneingabe, und der Alias wird von intellisense vorgeschlagen.

Das folgende Beispiel ist die Eingabe der Aufgabe "Known Hosts Entry" für den InstallSSHKey@0 Task aus dem YAML-Schema, wobei knownHostsEntry in der Namensposition und hostName in der aliases Auflistung aufgeführt ist.

"properties": {
    "knownHostsEntry": {
      "type": "string",
      "description": "Known Hosts Entry",
      "ignoreCase": "key",
      "aliases": [
        "hostName"
      ]
    },

Da intellisense im YAML-Pipeline-Editor angezeigt knownHostsEntrywird und die yaML- generiert wird, die von der Aufgabe generiert wird, die Assistent in der generierten YAML verwendetknownHostsEntry, zeigt der Taskverweis den alias aus dem Aufgabenquellcode als YAML-Namen für eine Aufgabeneingabe an. Wenn eine Aufgabe über mehr als einen Alias verfügt (es gibt einige, die zwei Aliase haben), wird der erste Alias als Name verwendet.

Warum hat sich der Aufgabenverweis geändert?

Die Referenzdokumentation zu Azure Pipelines-Aufgaben wurde an den aktuellen Speicherort verschoben, um die folgenden Verbesserungen zu unterstützen.

• Aufgabenartikel werden mithilfe des Aufgabenquellcodes aus den Azure Pipelines-Aufgaben Open Source Repository generiert.
• Aufgabeneingabenamen und Aliase werden aus der Aufgabenquelle generiert, sodass sie immer auf dem neuesten Stand sind.
• YAML-Syntaxblöcke werden aus der Aufgabenquelle generiert, sodass sie immer auf dem neuesten Stand sind.
• Unterstützung von Communitybeiträgen durch integrierte Benutzerinhalten wie optimierte Aufgabeneingabebeschreibungen, Anmerkungen und Beispiele.
• Bietet Aufgabenabdeckung für alle unterstützten Azure DevOps-Versionen.
• Aktualisierung in jedem Sprint, damit die neuesten Updates enthalten sind

Informationen zum Mitwirken finden Sie unter Beitragen zum Inhalt der Aufgaben.

Wo erfahre ich Schritt für Schritt, wie ich meine App erstellen kann?

Erstellen Sie Ihre App

Kann ich meine eigenen Buildaufgaben hinzufügen?

Ja: Hinzufügen einer Buildaufgabe

Was sind Installationsaufgaben?

Weitere Informationen zu Tool-Installationsprogramm-Aufgaben finden Sie unter Tool-Installationsprogramme.