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 jeden Vorgang eine besondere Bedeutung enthalten.

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

Anleitungen und Lernprogramme zum Erstellen von Pipelines mithilfe von Aufgaben, einschließlich erstellen benutzerdefinierter Aufgaben, benutzerdefinierter Erweiterungen und Suchen von Aufgaben auf dem Visual Studio Marketplace, finden Sie unter Aufgabenkonzepte und Dokumentation zu Azure Pipelines.

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 oberhalb des Inhaltsverzeichnisses befindet. Die Featureunterstützung unterscheidet sich je nachdem, ob Sie von Azure DevOps Services oder einer lokalen Version von Azure DevOps Server arbeiten.
Informationen zur lokalen Version, die Sie verwenden, finden Sie unter Suchen Ihrer Azure DevOps-Plattform und -Version.

Erstellen von Aufgaben

Aufgabe	Beschreibung
.NET Core- DotNetCoreCLI@2 DotNetCoreCLI@1 DotNetCoreCLI@0	Erstellen, Testen, Verpacken oder Veröffentlichen einer .NET-Anwendung oder Ausführen eines benutzerdefinierten .NET CLI-Befehls.
Advanced Security AutoBuild- AdvancedSecurity-Codeql-Autobuild@1	Versucht, das Repository zu erstellen, indem Projektdateien im Quellordner gefunden und erstellt werden.
Advanced Security Initialize CodeQL- AdvancedSecurity-Codeql-Init@1	Initialisiert die CodeQL-Datenbank in Vorbereitung auf die Erstellung.
Advanced Security Perform CodeQL Analysis AdvancedSecurity-Codeql-Analyze@1	Schließt die CodeQL-Datenbank ab und führt die Analyseabfragen aus.
Advanced Security Publish Results AdvancedSecurity-Publish@1	Kombiniert SARIF-Dateien, die von Codescantool(n) erzeugt werden, die kombinierte SARIF-Datei verbessern und die erweiterte SARIF-Datei im Advanced Security-Dienst veröffentlicht.
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	Containerbuildaufgabe.
Docker- Docker@2 Docker@1 Docker@0	Erstellen oder Übertragen von Docker-Images, Anmelden oder Abmelden, Starten oder Beenden von Containern oder Ausführen eines Docker-Befehls.
Docker Compose DockerCompose@1 DockerCompose@0	Erstellen, Pushen oder Ausführen von Docker-Anwendungen mit mehreren Containern Die Aufgabe kann in der Docker- oder Azure Container-Registrierung verwendet werden.
GitHub Nuget-Pakete herunterladen 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 eine Go-Anwendung, 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-Taskrunner aus.
gulp gulp@1 gulp@0	Führen Sie das gulp Node.js Streaming-Task-basiertes Buildsystem aus.
Indexquellen und Veröffentlichen von Symbolen PublishSymbols@2 PublishSymbols@1	Indizieren Sie Ihren Quellcode, und veröffentlichen Sie Symbole auf einem Dateifreigabe- oder Azure Artifacts-Symbolserver.
Jenkins-Warteschlangenauftrag JenkinsQueueJob@2	Stellen Sie einen Auftrag auf einem Jenkins-Server in die Warteschlange.
Jenkins Queue Job 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@7 SonarQubePrepare@6 SonarQubePrepare@5 SonarQubePrepare@4	Vorbereiten der Konfiguration der SonarQube Server-Analyse.
Quality Gate-Ergebnis veröffentlichen SonarQubePublish@7 SonarQubePublish@6 SonarQubePublish@5 SonarQubePublish@4	Veröffentlichen Sie das Quality Gate-Ergebnis des SonarQube-Servers auf dem Azure DevOps-Buildergebnis, das nach der tatsächlichen Analyse verwendet werden soll.
Codeanalyse ausführen SonarQubeAnalyze@7 SonarQubeAnalyze@6 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 Visual Studio-Version-Eigenschaft 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. Optional packen Sie eine App.
Xcode Build- Xcode@3 Xcode@2	Erstellen Sie einen Xcode-Arbeitsbereich unter macOS.
Xcode-Paket-iOS- XcodePackageiOS@0	Generieren Sie eine IPA-Datei aus der Xcode-Buildausgabe mit xcrun (Xcode 7 oder darunter).

Bereitstellen von Aufgaben

Aufgabe	Beschreibung
App Center verteilen AppCenterDistribute@3 AppCenterDistribute@2 AppCenterDistribute@1 AppCenterDistribute@0	Verteilen Sie App-Builds über Visual Studio App Center an Tester und Benutzer.
ARM-Vorlagenbereitstellung AzureResourceManagerTemplateDeployment@3	Stellen Sie eine Azure Resource Manager (ARM)-Vorlage für alle Bereitstellungsbereiche bereit.
Azure App Configuration Export AzureAppConfigurationExport@10	Exportieren Sie Schlüsselwerte in Vorgangsvariablen aus der Azure App-Konfiguration.
azure App Service Classic (veraltet) AzureWebPowerShellDeployment@1	Erstellen oder Aktualisieren von Azure App Service mit Azure PowerShell.
Azure App Service bereitstellen AzureRmWebAppDeployment@4 AzureRmWebAppDeployment@3 AzureRmWebAppDeployment@2	Stellen Sie eine Web-, Mobile- oder API-App mit Docker, Java, .NET, .NET Core, Node.js, PHP, Python oder Ruby für Azure App Service bereit.
Azure App Service verwalten AzureAppServiceManage@0	Starten, Beenden, Neustarten, Steckplatztausch, Löschen von Steckplätzen, Installieren von Websiteerweiterungen oder Aktivieren der kontinuierlichen Überwachung für einen Azure App Service.
Azure App Service-Einstellungen AzureAppServiceSettings@1	Aktualisieren/Hinzufügen von App-Einstellungen einer Azure Web App für Linux oder Windows.
Azure CLI 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.
Azure CLI Preview- AzureCLI@0	Führen Sie ein Shell- oder Batchskript mit Azure CLI-Befehlen für ein Azure-Abonnement aus.
Azure Cloud Service-Bereitstellung AzureCloudPowerShellDeployment@2 AzureCloudPowerShellDeployment@1	Stellen Sie einen Azure Cloud Service bereit.
Bereitstellen von Azure-Container-Apps AzureContainerApps@1 AzureContainerApps@0	Eine Azure DevOps-Aufgabe zum Erstellen und Bereitstellen von Azure-Container-Apps.
Azure-Datenbank für mySQL-Bereitstellung AzureMysqlDeployment@1	Führen Sie Ihre Skripts aus, und nehmen Sie Änderungen an Ihrer Azure-Datenbank für MySQL vor.
Azure-Dateikopie AzureFileCopy@6 AzureFileCopy@5 AzureFileCopy@4 AzureFileCopy@3 AzureFileCopy@2 AzureFileCopy@1	Kopieren Sie Dateien in Azure Blob Storage oder virtuelle Computer.
Azure-Funktion auf 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, Java-basierten Webanwendungen.
Azure Functions für container- AzureFunctionAppContainer@1	Aktualisieren Sie eine Funktions-App mit einem Docker-Container.
Azure Key Vault- AzureKeyVault@2 AzureKeyVault@1	Laden Sie geheime Azure Key Vault-Schlüssel herunter.
Azure Monitor-Warnungen (veraltet) AzureMonitorAlerts@0	Konfigurieren von Warnungen für verfügbare 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.
Azure-Ressourcengruppenbereitstellung AzureResourceGroupDeployment@2	Stellen Sie eine Azure Resource Manager (ARM)-Vorlage für eine Ressourcengruppe bereit und verwalten Sie virtuelle Computer.
Azure Resource Group Deployment AzureResourceGroupDeployment@1	Bereitstellen, Starten, Beenden, Löschen von Azure-Ressourcengruppen.
Azure Spring Apps AzureSpringCloud@0	Stellen Sie Anwendungen in Azure Spring Apps bereit und verwalten Sie Bereitstellungen.
Azure SQL-Datenbankbereitstellung SqlAzureDacpacDeployment@1	Stellen Sie eine Azure SQL-Datenbank mit DACPAC bereit, oder führen Sie Skripts mit SQLCMD aus.
Azure VM Scale Set-Bereitstellung AzureVmssDeployment@0	Stellen Sie ein Skalierungssetimage für virtuelle Computer 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	Bereitstellen von Containern in Azure App Service.
Erstellen eines Computerimages PackerBuild@1 PackerBuild@0	Erstellen Sie ein Computerimage mit Packer, das möglicherweise für die Bereitstellung von Skalierungsgruppen für virtuelle Azure-Computer verwendet werden kann.
Überprüfen der Azure-Richtliniencompliance AzurePolicyCheckGate@0	Sicherheits- und Compliancebewertung für Azure-Richtlinie.
Chefkoch Chef@1	Bereitstellen in Chef-Umgebungen durch Bearbeiten von Umgebungsattributen.
Chefmesser ChefKnife@1	Führen Sie Skripts mit Messerbefehlen auf Ihrer Chefarbeitsstation aus.
Kopieren von Dateien über SSH- CopyFilesOverSSH@0	Kopieren Sie Dateien oder Erstellen von Artefakten auf einen Remotecomputer über SSH.
Für Kubernetes bereitstellen KubernetesManifest@1 KubernetesManifest@0	Verwenden Sie Kubernetes-Manifestdateien, um sie in Clustern bereitzustellen oder sogar die Manifestdateien zu backen, die für Bereitstellungen mit Helm-Diagrammen verwendet werden sollen.
bereitstellen IIS Web App 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, Aktualisieren eines Kubernetes-Clusters im Azure-Containerdienst durch Ausführen von Kubectl-Befehlen.
manuelle Intervention ManualIntervention@8	Halten Sie die Bereitstellung an, und warten Sie auf manuelle Eingriffe.
manuelle Überprüfung ManualValidation@1 ManualValidation@0	Anhalten einer Pipelineausführung, um auf manuelle Interaktion zu warten. Funktioniert nur mit YAML-Pipelines.
MySQL-Datenbank bereitstellen MysqlDeploymentOnMachineGroup@1	Führen Sie Skripts aus, und nehmen Sie Änderungen an einer MySQL-Datenbank vor.
Packen und Bereitstellen von Helmdiagrammen HelmDeploy@1 HelmDeploy@0	Bereitstellen, Konfigurieren, Aktualisieren eines Kubernetes-Clusters im Azure-Containerdienst durch Ausführen von Helmbefehlen.
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 auf einem Cluster bereit.
Service Fabric Compose bereitstellen ServiceFabricComposeDeploy@0	Stellen Sie eine Docker Compose-Anwendung in einem Azure Service Fabric-Cluster bereit.
SQL Server-Datenbank bereitstellen SqlDacpacDeploymentOnMachineGroup@0	Stellen Sie eine SQL Server-Datenbank mit DACPAC- oder SQL-Skripts bereit.
SQL Server-Datenbankbereitstellung (veraltet) SqlServerDacpacDeployment@1	Bereitstellen einer SQL Server-Datenbank mit DACPAC.
SSH- SSH@0	Führen Sie Shellbefehle oder ein Skript auf einem Remotecomputer mit SSH aus.
Windows-Computerdateikopie WindowsMachineFileCopy@2 WindowsMachineFileCopy@1	Kopieren Sie Dateien auf Remotecomputer von Windows.

Packen von Aufgaben

Aufgabe	Beschreibung
Cargo authentifizieren (für Aufgabenläufer) CargoAuthenticate@0	Authentifizierungsaufgabe für den Frachtclient, der für die Installation der Frachtkistenverteilung 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.
Github Npm Package herunterladen DownloadGithubNpmPackage@1	Installieren Sie npm-Pakete von GitHub.
Maven Authenticate 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-Authentifizierung (für Aufgabenläufer) npmAuthenticate@0	Verwenden Sie diese Aufgabe nicht, wenn Sie auch die npm-Aufgabe verwenden. Stellt npm-Anmeldeinformationen für eine NPMRC-Datei in Ihrem Repository für den Umfang des Builds bereit. Auf diese Weise können npm-Aufgabenläufer wie gulp und Grunt sich bei privaten Registrierungen authentifizieren.
NuGet- NuGetCommand@2	Stellen Sie NuGet-Pakete wieder her, packen Oder pushen Sie nuGet-Pakete, oder führen Sie einen NuGet-Befehl aus. 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 authentifizieren NuGetAuthenticate@1 NuGetAuthenticate@0	Konfigurieren Sie NuGet-Tools für die Authentifizierung mit Azure Artifacts und anderen NuGet-Repositorys. 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 warten zu müssen, bietet eine bessere Unterstützung für authentifizierte Feeds außerhalb dieser Organisation/Sammlung und verwendet NuGet 4 standardmäßig.
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 warten zu müssen, bietet eine bessere Unterstützung für authentifizierte Feeds außerhalb dieser Organisation/Sammlung und verwendet NuGet 4 standardmäßig.
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 warten zu müssen, bietet eine bessere Unterstützung für authentifizierte Feeds außerhalb dieser Organisation/Sammlung und verwendet NuGet 4 standardmäßig.
NuGet Restore NuGetRestore@1	Stellt NuGet-Pakete in Vorbereitung auf einen Visual Studio Build-Schritt wieder her.
PyPI-Herausgeber PyPIPublisher@0	Erstellen und Hochladen eines Sdist oder Rads in einen pyPI-kompatiblen Index mit Twine.
Python Pip authentifizieren PipAuthenticate@1 PipAuthenticate@0	Authentifizierungsaufgabe für den Pip-Client, der für die Installation von Python-Verteilungen verwendet wird.
Python Twine Upload authentifizieren TwineAuthenticate@1 TwineAuthenticate@0	Authentifizieren sie sich für das Hochladen von Python-Verteilungen mithilfe von Twine. Fügen Sie "-r FeedName/EndpointName --config-file $(PYPIRC_PATH)" zu Ihrem Twine-Uploadbefehl hinzu. Verwenden Sie für Feeds, die in dieser Organisation vorhanden sind, den Feednamen als Repository (-r). Verwenden Sie andernfalls den in der Dienstverbindung definierten Endpunktnamen.
Universelle Pakete UniversalPackages@0	Laden Sie universelle Pakete herunter, oder veröffentlichen Sie sie.
Xamarin-Komponentenwiederherstellung XamarinComponentRestore@0	Diese Aufgabe ist veraltet. Verwenden Sie stattdessen "NuGet".

Testen von Aufgaben

Aufgabe	Beschreibung
App Center-Test- AppCenterTest@1	Testen Sie App-Pakete mit Visual Studio App Center.
Azure Load Testing AzureLoadTest@1	Automatisieren Sie Leistungsregressionstests mit Azure Load Testing.
Containerstrukturtest ContainerStructureTest@0	Verwendet containerstrukturtest (https://github.com/GoogleContainerTools/container-structure-test) zum Überprüfen der Struktur eines Images basierend auf vier Testkategorien – Befehlstests, Dateiexistenztests, Dateiinhaltstests und Metadatentests.
Mobile Center Test- VSMobileCenterTest@0	Testen Sie mobile App-Pakete mit Visual Studio Mobile Center.
Ergebnisse der Codeabdeckung veröffentlichen PublishCodeCoverageResults@2 PublishCodeCoverageResults@1	Veröffentlichen Sie eines der Codeabdeckungsergebnisse aus einem Build.
Veröffentlichen von Testergebnissen PublishTestResults@1	Veröffentlichen Sie Testergebnisse in Azure Pipelines.
Veröffentlichen von Testergebnissen PublishTestResults@2	Veröffentlichen Sie Testergebnisse in Azure Pipelines.
Ausführen von Funktionstests RunVisualStudioTestsusingTestAgent@1	Veraltet: Diese Aufgabe und die Begleitaufgabe (Visual Studio Test Agent Deployment) sind veraltet. Verwenden Sie stattdessen die Aufgabe "Visual Studio Test". Die VSTest-Aufgabe kann Komponenten sowie Funktionstests ausführen. Führen Sie Tests für einen oder mehrere Agents mit der Einstellung für den Multi-Agent-Auftrag aus. Verwenden Sie die Aufgabe "Visual Studio Test Platform", um Tests auszuführen, ohne Visual Studio für den Agent zu benötigen. Die VSTest-Aufgabe 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, Codierter UI-Test usw.) mithilfe des Visual Studio Test (VsTest)-Läufers aus. Testframeworks mit einem Visual Studio-Testadapter wie MsTest, xUnit, NUnit, Chutzpah (für JavaScript-Tests mit QUnit, Mocha und Jasmine) können ausgeführt werden. Tests können mithilfe dieser Aufgabe auf mehrere Agents verteilt werden (Version 2 und höher).
Visual Studio-Test-Agent-Bereitstellung DeployVisualStudioTestAgent@2	DeployVisualStudioTestAgent@2 ist veraltet. Verwenden Sie die Visual Studio Test-Aufgabe, um Komponenten- und Funktionstests auszuführen.
Visual Studio Test Agent Deployment 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 mit Xamarin.UITest. Verwenden Sie stattdessen die Aufgabe "App Center-Test".

Toolaufgaben

Aufgabe	Beschreibung
.NET Core SDK/Laufzeitinstallationsprogramm DotNetCoreInstaller@1 DotNetCoreInstaller@0	Erwerben Sie eine bestimmte Version des .NET Core SDK aus dem Internet oder lokalen Cache, und fügen Sie sie dem PATH hinzu.
Docker CLI-Installationsprogramm DockerInstaller@0	Installieren Sie Docker CLI auf dem Agentcomputer.
Duffle-Toolinstallationsprogramm DuffleInstaller@0	Installieren Sie eine angegebene Version von Duffle zum Installieren und Verwalten von CNAB-Bündeln.
Go-Toolinstallationsprogramm GoTool@0	Suchen Sie im Cache, oder laden Sie eine bestimmte Version von Go herunter, und fügen Sie sie dem PATH 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	Erwerben Sie eine bestimmte Version von Java aus einem vom Benutzer bereitgestellten Azure-Blob oder dem Toolcache und legt JAVA_HOME fest.
Kubectl-Toolinstallationsprogramm KubectlInstaller@0	Installieren Sie Kubectl auf dem Agentcomputer.
Kubelogin Tool Installer KubeloginInstaller@0	Hilft beim Installieren von Kubelogin.
NuGet-Toolinstallationsprogramm NuGetToolInstaller@1 NuGetToolInstaller@0	Erwirbt eine bestimmte Version von NuGet aus dem Internet oder den Toolscache und fügt sie dem PATH 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	Erwirbt eine bestimmte Version des .NET Core SDK aus dem Internet oder dem lokalen Cache und fügt sie dem PATH hinzu. Verwenden Sie diese Aufgabe, um die Version von .NET Core zu ändern, die in nachfolgenden Aufgaben verwendet wird. Stellt darüber hinaus Proxyunterstützung bereit.
Node.js Ökosystem verwenden UseNode@1 NodeTool@0	Richten Sie eine Node.js Umgebung ein, und fügen Sie sie dem PATH hinzu, und stellen Sie zusätzlich Proxyunterstützung bereit.
Verwenden der Python-Version UsePythonVersion@0	Verwenden Sie die angegebene Version von Python aus dem Toolcache, optional fügen Sie sie dem PATH hinzu.
Verwenden von Ruby-Version UseRubyVersion@0	Verwenden Sie die angegebene Version von Ruby aus dem Toolcache, optional fügen Sie sie dem PATH hinzu.
Visual Studio-Testplattforminstallationsprogramm VisualStudioTestPlatformInstaller@1	Erwerben Sie die Testplattform aus nuget.org oder dem Toolcache. Erfüllt die Nachfrage nach "vstest" und kann zum Ausführen von Tests und zum Sammeln von Diagnosedaten mithilfe der Visual Studio Test-Aufgabe verwendet werden.

Hilfsaufgaben

Aufgabe	Beschreibung
Advanced Security Dependency Scanning AdvancedSecurity-Dependency-Scanning@1	Suchen Sie nach Sicherheitsrisiken für Open Source-Abhängigkeiten in Ihrem Quellcode.
Archivdateien ArchiveFiles@2	Komprimieren Sie Dateien in .7z, .tar.gz oder .zip.
Archivdateien ArchiveFiles@1	Archivieren von Dateien mit Komprimierungsformaten wie .7z, .rar, .tar.gz und .zip.
Azure App-Konfigurationsimport- AzureAppConfigurationImport@10	Importieren Sie Schlüsselwerte in eine Azure App-Konfigurationsinstanz.
Azure App-Konfigurationsmomentaufnahme AzureAppConfigurationSnapshot@1	Erstellen Sie eine Momentaufnahme in einer Azure App-Konfigurationsinstanz.
Azure Network Load Balancer AzureNLBManagement@1	Verbinden oder Trennen der Netzwerkschnittstelle eines virtuellen Azure-Computers mit dem Back-End-Adresspool eines Lastenausgleichs.
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 Zwischenspeichern von Dateien.
Cache (Beta) CacheBeta@1 CacheBeta@0	Zwischenläufen zwischen Zwischenspeichern von Dateien.
Befehlszeilen- CmdLine@2 CmdLine@1	Führen Sie ein Befehlszeilenskript mit Bash unter Linux und macOS und cmd.exe unter Windows aus.
Kopieren und Veröffentlichen von Buildartefakten 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 übereinstimmenden Dateipfaden (nicht Ordnerpfade).
Dateien kopieren CopyFiles@1	Kopieren Sie Dateien aus dem Quellordner in den Zielordner mithilfe von Minimatch-Mustern (Die Miniübereinstimmungsmuster stimmen nur mit Dateipfaden überein, nicht mit Ordnerpfaden).
cURL-Uploaddateien cURLUploader@2 cURLUploader@1	Verwenden Sie die unterstützten Protokolle von cURL, um Dateien hochzuladen.
Entschlüsselungsdatei (OpenSSL) DecryptFile@1	Entschlüsseln sie eine Datei mit OpenSSL.
Verzögerung Delay@1	Verzögern Sie die weitere Ausführung eines Workflows um eine feste Zeit.
Löschen von Dateien DeleteFiles@1	Löschen Sie Ordner oder Dateien, die einem Muster entsprechen.
Bereitstellen von Azure Static Web App- AzureStaticWebApp@0	Erstellen und Bereitstellen einer statischen Azure Web App.
Herunterladen von Artefakten aus der Dateifreigabe DownloadFileshareArtifacts@1	Laden Sie Artefakte aus einer Dateifreigabe herunter, z. B. \freigabe\drop.
Herunterladen von Buildartefakten DownloadBuildArtifacts@1 DownloadBuildArtifacts@0	Laden Sie Dateien herunter, die als Artefakte eines abgeschlossenen Builds gespeichert wurden.
GitHub Release herunterladen DownloadGitHubRelease@0	Lädt eine GitHub-Version aus einem Repository herunter.
Paket herunterladen DownloadPackage@1 DownloadPackage@0	Laden Sie ein Paket aus einem Paketverwaltungsfeed in Azure Artifacts herunter.
Herunterladen von Pipelineartefakten DownloadPipelineArtifact@2 DownloadPipelineArtifact@1 DownloadPipelineArtifact@0	Laden Sie Build- und Pipelineartefakte herunter.
sichere Datei herunterladen DownloadSecureFile@1	Laden Sie eine sichere Datei auf den Agentcomputer 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 mit FTP hoch.
GitHub Comment GitHubComment@0	Schreiben Sie einen Kommentar in Ihre GitHub-Entität, d. h. ein Problem oder eine Pullanforderung (PR).
GitHub Release- GitHubRelease@1 GitHubRelease@0	Erstellen, Bearbeiten oder Löschen einer GitHub-Version.
Apple-Zertifikat installieren InstallAppleCertificate@2	Installieren Sie ein Apple-Zertifikat, das zum Erstellen auf einem macOS-Agentcomputer erforderlich ist.
Apple-Zertifikat installieren InstallAppleCertificate@1 InstallAppleCertificate@0	Installieren Sie ein Apple-Zertifikat, das zum Erstellen eines macOS-Agents erforderlich ist.
Installieren des Apple-Bereitstellungsprofils InstallAppleProvisioningProfile@1	Installieren Sie ein Apple-Bereitstellungsprofil, das zum Erstellen auf einem macOS-Agentcomputer erforderlich ist.
Installieren des Apple-Bereitstellungsprofils InstallAppleProvisioningProfile@0	Installieren Sie ein Apple-Bereitstellungsprofil, das zum Erstellen eines macOS-Agents erforderlich ist.
SSH-Schlüssel installieren 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 Herunterladen von Artefakten JenkinsDownloadArtifacts@1	Laden Sie Artefakte herunter, die von einem Jenkins-Auftrag erstellt wurden.
Node.js Aufgabenausführungsinstallationsprogramm NodeTaskRunnerInstaller@0	Installieren Sie bestimmte Node.js Version, um Knotenaufgaben auszuführen.
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 Nachweisspeicher.
In Azure Service Bus veröffentlichen PublishToAzureServiceBus@2 PublishToAzureServiceBus@1 PublishToAzureServiceBus@0	Sendet eine Nachricht mit einer Azure Resource Manager-Dienstverbindung an Azure Service Bus (kein Agent ist 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.
klassischen Azure Monitor-Warnungen AzureMonitor@0	Beachten Sie die konfigurierten klassischen Azure Monitor-Regeln für aktive Warnungen.
Abfragen von Arbeitsaufgaben queryWorkItems@0	Führen Sie eine Arbeitsaufgabenabfrage aus, und überprüfen Sie die Anzahl der zurückgegebenen Elemente.
App- überprüfen ReviewApp@0	Verwenden Sie diese Aufgabe unter bereitstellungsphasenanbieter, 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.
Update Service Fabric App-Versionen ServiceFabricUpdateAppVersions@1	Aktualisiert automatisch die Versionen einer gepackten Service Fabric-Anwendung.
Update Service Fabric-Manifeste ServiceFabricUpdateManifests@2	Automatisches Aktualisieren von Teilen von Anwendungs- und Dienstmanifesten in einer verpackten Azure Service Fabric-Anwendung.
Xamarin License XamarinLicense@1	[Veraltet] Upgrade auf die kostenlose Version von Xamarin: https://store.xamarin.com.

Quelloffen

Diese Aufgaben sind Open Source-auf GitHub-. Feedback und Beiträge sind willkommen. Eine Liste der Vorgangsänderungen, einschließlich eines historischen Datensatzes von Vorgangsaktualisierungen, finden Sie unter Änderungsprotokoll für Pipelineaufgaben.

Häufig gestellte Fragen

Was sind Aufgabeneingabealiasen?

Eingaben für einen Vorgang werden durch eine label, nameund können eine oder mehrere optionale aliasesenthalten. Das folgende Beispiel ist ein Auszug aus dem Quellcode für den Eintrag für bekannte Hosts Eingabe der InstallSSHKey@0 Aufgabe.

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

Bevor YAML-Pipelines 2019 eingeführt wurden, wurden Pipelines mit einem UI-basierten Pipeline-Editor erstellt und bearbeitet, und nur die label wurde von Pipelineautoren verwendet, um auf eine Aufgabeneingabe zu verweisen.

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

Beispielsweise verfügt die aufgabe InstallSSHKey@0 über einen Eintrag für bekannte Hosts Eingabe mit dem Namen hostName, der einen Eintrag aus einer known_hosts Datei erwartet. Der Eintrag für bekannte Hosts Bezeichnung im klassischen Pipeline-Designer macht dies deutlich, ist aber bei Verwendung des hostName Namens in einer YAML-Pipeline nicht so klar. Aufgabeneingabealiasen wurden eingeführt, damit Aufgabenautoren dekriptive Namen für ihre zuvor erstellten Aufgaben bereitstellen können, und für die InstallSSHKey@0 Aufgabe wurde ein knownHostsEntryAliashinzugefügt, während der ursprüngliche hostName Name zur Kompatibilität mit vorhandenen Pipelines mit diesem Namen beibehalten wurde.

Alle Elemente in der aliases einer Vorgangseingabe sind austauschbar mit dem name in einer YAML-Pipeline. Die folgenden beiden YAML-Codeausschnitte sind funktional identisch, wobei das erste Beispiel den knownHostsEntry Alias und das zweite Beispiel mit hostNameverwendet.

- 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-Editoreingeführt, der eine IntelliSense-Typfunktionalität bereitstellt.

Der YAML-Pipeline-Editor verwendet die Yamlschema - Abrufen REST-API, um das Schema abzurufen, das für die Überprüfung im Editor verwendet wird. Wenn eine Aufgabeneingabe über einen Alias verfügt, wird der Alias vom Schema zum primären YAML-Namen für die Aufgabeneingabe hergeleitet, und der Alias wird vom IntelliSense vorgeschlagen.

Das folgende Beispiel ist die Eingabe bekannter Hosts Vorgangseingabe für die aufgabe InstallSSHKey@0 aus dem YAML-Schema, wobei knownHostsEntry in der Namensposition und hostName in der aliases-Auflistung aufgeführt sind.

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

Da der IntelliSense im YAML-Pipeline-Editor knownHostsEntryanzeigt und das vom Aufgaben-Assistenten generierte YAMLknownHostsEntry im generierten YAML verwendet, zeigt der Aufgabenverweis die alias aus dem Aufgabenquellcode als YAML-Namen für eine Aufgabeneingabe an. Wenn eine Aufgabe mehrere Aliase enthält (es gibt ein paar Aliase, die zwei Aliase aufweisen), wird der erste Alias als Name verwendet.

Warum hat sich die Vorgangsreferenz 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 dem Azure Pipelines-Aufgaben open Source Repositorygeneriert.
• 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 auf dem neuesten Stand sind.
• Unterstützt Communitybeiträge mit integrierten Benutzerinhalten wie erweiterte Aufgabeneingabebeschreibungen, Anmerkungen und Beispiele.
• Bietet Aufgabenabdeckung für alle unterstützten Azure DevOps-Versionen.
• Jeder Sprint wurde aktualisiert, um die neuesten Updates abzudecken.

Informationen zum Beitragen finden Sie unter Beitragen zu den Aufgabeninhalten.

Wo kann ich schrittweise erfahren, wie ich meine App erstellen kann?

Erstellen Ihrer App-

Kann ich meine eigenen Buildaufgaben hinzufügen?

Ja: Hinzufügen einer Buildaufgabe

Was sind Installationsaufgaben?

Weitere Informationen zu Toolinstallationsaufgaben finden Sie unter Tool installers.