Azure Pipelines task reference

工作會在管線中執行動作。 例如，任務可以建置應用程式、與 Azure 資源互動、安裝工具或執行測試。 工作是在管線中定義自動化的建置組塊。

本節文章描述 Azure Pipelines 內建任務，並規定每個任務具有特殊意義屬性的語意。

如需工作所支援之一般屬性的詳細資訊，請參閱 YAML 參考 steps.task。

關於使用任務撰寫管線的操作與教學，包括建立自訂任務、自訂擴充功能，以及在 Visual Studio Marketplace 尋找任務，請參見 Tasks concepts 及 Azure Pipelines documentation。

重要

要查看您平台上可用的任務參考，請確保您從目錄上方的版本選擇器中選擇正確的 Azure DevOps 版本。 功能支援會依你是使用 Azure DevOps Services 還是本地版的 Azure DevOps Server 工作而有所不同。
想了解你使用的是哪個本地版本，請參考 查詢你的Azure DevOps平台和版本。

建置工作

任務	描述
.NET 核心 DotNetCoreCLI@2 DotNetCoreCLI@1 DotNetCoreCLI@0	建立、測試、打包或發布 .NET 應用程式，或執行自訂的 .NET CLI 指令。
進階安全性初始化 CodeQL 高級安全-Codeql-Init@1	初始化 CodeQL 資料庫，以準備建置。
進階安全性執行 CodeQL 分析 高級安全-Codeql-Analyze@1	完成 CodeQL 資料庫並執行分析查詢。
進階安全性發佈結果 AdvancedSecurity-Publish@1	結合程式代碼掃描工具所產生的 SARIF 檔案、增強合併的 SARIF 檔案，並將增強的 SARIF 檔案發佈至進階安全性服務。
Android 組建 AndroidBuild@1	AndroidBuild@1已被取代。 使用 Gradle。
Android 簽署 AndroidSigning@3 AndroidSigning@2 AndroidSigning@1	簽署並對齊Android APK檔案。
螞蟻 Ant@1	使用 Apache Ant 建置。
Azure IoT Edge AzureIoTEdge@2	建立並部署 Azure IoT Edge 映像。
CMake CMake@1	使用 CMake 跨平臺建置系統進行建置。
容器組建 ContainerBuild@0	容器建置工作。
碼頭工人 Docker@2 Docker@1 Docker@0	建置或推送 Docker 映射、登入或註銷、啟動或停止容器，或執行 Docker 命令。
Docker 撰寫 DockerCompose@1 DockerCompose@0	建置、推送或執行多容器 Docker 應用程式。 Task 可以搭配 Docker 或 Azure 容器登錄檔使用。
下載 GitHub NuGet DownloadGitHubNugetPackage@1	已棄用：此任務不再維護。 建議用NuGetCommand@2或DotNetCoreCLI@2任務來搭配GitHub服務連結。
前進 Go@0	取得、建置或測試 Go 應用程式，或執行自訂 Go 命令。
格拉德爾 Gradle@4 Gradle@3 Gradle@2 Gradle@1	使用 Gradle 包裝函式腳本建置。
格魯特 Grunt@0	執行 Grunt JavaScript 工作執行器。
吞掉 gulp@1 gulp@0	執行 gulp Node.js 串流工作型建置系統。
索引來源和發佈符號 PublishSymbols@2 PublishSymbols@1	將原始碼索引，並將符號發佈到檔案分享或 Azure Artifacts 符號伺服器。
Jenkins 佇列工作 JenkinsQueueJob@2 JenkinsQueueJob@1	將 Jenkins 伺服器上的作業排入佇列。
Maven Maven@4 Maven@3 Maven@2 Maven@1	使用 Apache Maven 建置、測試及部署。
MSBuild MSBuild@1	使用 MSBuild 建置。
準備分析組態 SonarQubePrepare@8 SonarQubePrepare@7 SonarQubePrepare@6 SonarQubePrepare@5 SonarQubePrepare@4	準備 SonarQube 伺服器分析組態。
發佈品質網關結果 SonarQubePublish@8 SonarQubePublish@7 SonarQubePublish@6 SonarQubePublish@5 SonarQubePublish@4	將 SonarQube Server 的 Quality Gate 結果發佈在 Azure DevOps 建置結果上，供實際分析後使用。
運行 Code Analysis SonarQubeAnalyze@8 SonarQubeAnalyze@7 SonarQubeAnalyze@6 SonarQubeAnalyze@5 SonarQubeAnalyze@4	執行掃描器並將結果上傳至 SonarQube 伺服器。
Visual Studio 建置 VSBuild@1	用 MSBuild 編譯並設定 Visual Studio 版本屬性。
Xcode 代碼 Xcode@5 Xcode@4	在macOS上建置、測試或封存 Xcode 工作區。 選擇性地封裝應用程式。
Xcode 組建 Xcode@3 Xcode@2	在macOS上建置 Xcode 工作區。
Xcode 套件 iOS XcodePackageiOS@0	使用 xcrun 從 Xcode 組建輸出產生 .ipa 檔案（Xcode 7 或以下版本）。

部署工作

任務	描述
App Center 散發 AppCenterDistribute@3 AppCenterDistribute@2 AppCenterDistribute@1 AppCenterDistribute@0	透過 Visual Studio App Center 將應用程式建置分發給測試人員和使用者。
ARM 範本部署 AzureResourceManagerTemplateDeployment@3	將 Azure Resource Manager（ARM）範本部署到所有部署範圍。
Azure 應用程式組態 Export AzureAppConfigurationExport@10	將 Azure 應用程式組態 中的鍵值匯出到你的建置或部署管線中的任務變數。
Azure 應用程式組態 Import AzureAppConfigurationImport@10	透過建置或部署管線，將設定檔從設定檔匯入 Azure 應用程式組態。
Azure 應用程式組態 快照 AzureAppConfigurationSnapshot@1	透過建置或部署管線在 Azure 應用程式組態 中建立組態快照。
Azure App 服務 經典（已棄用） AzureWebPowerShellDeployment@1	使用 Azure PowerShell 建立或更新 Azure App 服務。
Azure App 服務 部署 AzureRmWebAppDeployment@5 AzureRmWebAppDeployment@4 AzureRmWebAppDeployment@3 AzureRmWebAppDeployment@2	部署到Azure App 服務網頁、行動裝置或 API 應用程式中，使用 Docker、Java、.NET、.NET Core、Node.js、PHP、Python 或 Ruby。
Azure App 服務 管理 AzureAppServiceManage@0	啟動、停止、重新啟動、交換槽位、刪除槽位、安裝網站擴充功能或啟用持續監控以支援 Azure App 服務。
Azure App 服務 設定 AzureAppServiceSettings@1	更新/新增 Linux 或 Windows 的 Azure 網頁應用程式設定。
Azure CLI AzureCLI@3 AzureCLI@2 AzureCLI@1	在 Linux agent 上執行 PowerShell Core/Shell 腳本，或在 Windows agent 上執行 PowerShell/PowerShell Core/Batch 腳本，對 Azure 訂閱執行 Azure CLI 指令。
Azure CLI 預覽 AzureCLI@0	用 Azure CLI 指令執行 Shell 或 Batch 腳本，針對 Azure 訂閱。
Azure 雲端服務部署 AzureCloudPowerShellDeployment@2 AzureCloudPowerShellDeployment@1	部署 a Azure Cloud Service。
Azure 容器應用程式 部署 AzureContainerApps@1 AzureContainerApps@0	An Azure DevOps Task to build and deploy Azure 容器應用程式.
適用於 MySQL 的 Azure 資料庫部署 AzureMysqlDeployment@2 AzureMysqlDeployment@1	執行腳本並對 適用於 MySQL 的 Azure 資料庫 Flexible Server 做修改。
Azure檔案副本 AzureFileCopy@6 AzureFileCopy@5 AzureFileCopy@4 AzureFileCopy@3 AzureFileCopy@2 AzureFileCopy@1	將檔案複製到 Azure Blob 儲存體 或虛擬機。
Azure Kubernetes 上的函數 AzureFunctionOnKubernetes@1 AzureFunctionOnKubernetes@0	Deploy Azure function to Kubernetes cluster.
Azure Functions 部署 AzureFunctionApp@2 AzureFunctionApp@1	用 .NET、Python、JavaScript、PowerShell、Java 網頁應用程式更新函式應用程式。
Azure Functions for container AzureFunctionAppContainer@1	使用 Docker 容器更新函式應用程式。
Azure Key Vault AzureKeyVault@2 AzureKeyVault@1	Download Azure Key Vault secrets.
Azure 監視器 警示（已棄用） AzureMonitorAlerts@0	為 Azure 資源（已棄用）配置可用指標的警報。
Azure PowerShell AzurePowerShell@5 AzurePowerShell@4 AzurePowerShell@3 AzurePowerShell@2 AzurePowerShell@1	在 Azure 環境中執行 PowerShell 腳本。
Azure 資源群組部署 AzureResourceGroupDeployment@2 AzureResourceGroupDeployment@1	將 Azure Resource Manager（ARM）範本部署到資源群組並管理虛擬機。
Azure Spring 應用程式 AzureSpringCloud@0	將應用程式部署到 Azure Spring 應用程式 並管理部署。
Azure SQL Database部署 SqlAzureDacpacDeployment@1	用 DACPAC 部署 Azure SQL Database，或用 SQLCMD 執行腳本。
Azure VM scale set deployment AzureVmssDeployment@1 AzureVmssDeployment@0	部署虛擬機擴展集映像。
Azure 網頁應用程式 AzureWebApp@1	部署一個 Linux 或 Windows 的 Azure 網頁應用程式。
Azure 容器網頁應用程式 AzureWebAppContainer@1	Deploy containers to Azure App 服務.
Bicep 部署 BicepDeploy@0	使用 Bicep 檔案部署和管理 Azure 資源。
建置機器映像 PackerBuild@1 PackerBuild@0	使用 Packer 建立機器映像檔，可用於 Azure 虛擬機擴展集部署。
檢查Azure 原則合規 AzurePolicyCheckGate@0	Azure 原則 的安全與合規評估。
主廚 Chef@1	藉由編輯環境屬性來部署至 Chef 環境。
廚師刀 ChefKnife@1	在 Chef 工作站上使用 Knife 命令執行腳本。
透過 SSH 複製檔案 CopyFilesOverSSH@0	透過 SSH 將檔案或組建成品複製到遠端電腦。
部署至 Kubernetes KubernetesManifest@1 KubernetesManifest@0	使用 Kubernetes 指令清單檔案來部署至叢集，或甚至製作使用 Helm 圖表進行部署的指令清單檔案。
IIS Web 應用程式部署 IISWebAppDeploymentOnMachineGroup@0	使用 Web Deploy 部署網站或 Web 應用程式。
IIS Web 應用程式部署 （已淘汰） IISWebAppDeployment@1	使用 MSDeploy 部署，然後建立/更新網站和應用程式集區。
IIS Web 應用程式管理 IISWebAppManagementOnMachineGroup@0	建立或更新網站、Web 應用程式、虛擬目錄或應用程式集區。
叫用 REST API InvokeRESTAPI@1 InvokeRESTAPI@0	叫用 REST API 作為管線的一部分。
kubectl Kubernetes@1 Kubernetes@0	透過執行 kubectl 指令，在 Azure Container Service 中部署、配置、更新 Kubernetes 叢集。
手動操作 ManualIntervention@8	暫停部署並等候手動介入。 僅適用於傳統發行管線。
手動驗證 ManualValidation@1 ManualValidation@0	暫停管線執行以等候手動互動。 僅適用於 YAML 管線。
MySQL 資料庫部署 MysqlDeploymentOnMachineGroup@1	執行文稿並變更 MySQL 資料庫。
封裝及部署 Helm 圖表 HelmDeploy@1 HelmDeploy@0	透過執行 helm 指令，在 Azure Container Service 中部署、配置、更新 Kubernetes 叢集。
目標機器上的PowerShell PowerShellOnTargetMachines@3 PowerShellOnTargetMachines@2 PowerShellOnTargetMachines@1	使用 PSSession 和 Invoke-Command 在遠端電腦上執行 PowerShell 腳本，以進行遠端處理。
Service Fabric 應用程式部署 ServiceFabricDeploy@1	部署一個 Azure Service Fabric 應用程式到叢集。
Service Fabric 組合部署 ServiceFabricComposeDeploy@0	將 Docker Compose 應用程式部署到 Azure Service Fabric 叢集。
SQL Server資料庫部署 SqlDacpacDeploymentOnMachineGroup@0	使用 DACPAC 或 SQL 腳本部署 SQL Server 資料庫。
SQL Server database deploy （Deprecated） SqlServerDacpacDeployment@1	使用 DACPAC 部署 SQL Server 資料庫。
SSH 公司 SSH@0	使用 SSH 在遠端電腦上執行殼層命令或腳稿。
Windows機器檔案複製 WindowsMachineFileCopy@2 WindowsMachineFileCopy@1	將檔案複製到遠端的 Windows 機器。

封裝工作

任務	描述
貨物驗證 （工作執行器） CargoAuthenticate@0	用於安裝貨物箱分配的貨物客戶端驗證工作。
可哥豆莢 CocoaPods@0	安裝 Swift 和 Objective-C Cocoa 專案的 CocoaPods 相依性。
Conda 環境 CondaEnvironment@1 CondaEnvironment@0	此工作已被取代。 直接在腳本中使用 conda 來處理 Anaconda 環境。
下載 Github Npm 套件 DownloadGithubNpmPackage@1	已棄用：此任務不再維護。 建議用Npm@1任務搭配GitHub服務連結。
Gradle Authenticate GradleAuthenticate@0	Authenticate Gradle build 使用 Azure Artifacts feeds ，使用 Workload Identity Federation 或 access token。
Maven 驗證 MavenAuthenticate@0	提供 Azure Artifacts feeds 及外部 maven 倉庫的憑證。
npm Npm@1 Npm@0	安裝及發佈 npm 套件，或執行 npm 命令。 支援 npmjs.com 及認證的登錄檔，如 Azure Artifacts。
npm 驗證 （適用於工作執行器） npmAuthenticate@0	如果您也使用 npm 工作，請勿使用此工作。 為您的存放庫中的 .npmrc 檔案提供 npm 認證，以取得組建範圍。 這可讓 gulp 和 Grunt 等 npm 工作執行器向私人登錄進行驗證。
NuGet NuGetCommand@2 NuGet@0	使用此任務來還原或打包 NuGet 套件，或執行 NuGet 指令。 支援 NuGet.org 及認證的訂閱源，如 Azure Artifacts 和 MyGet。 使用 NuGet.exe 並搭配.NET Framework應用程式。 對於 .NET Core 和 .NET Standard 應用程式，請使用 .NET Core 任務。
NuGet 驗證 NuGetAuthenticate@1 NuGetAuthenticate@0	設定 NuGet 工具以與 Azure Artifacts 及其他 NuGet 倉庫進行認證。 需要 NuGet >= 4.8.5385、dotnet >= 6 或 MSBuild >= 15.8.166.59604。
NuGet 安裝程式 NuGetInstaller@0	安裝或還原遺漏的 NuGet 套件。 針對最新功能使用NuGetAuthenticate@0工作。
NuGet 封裝器 NuGetPackager@0	已淘汰：請改用 「NuGet」 工作。 它可與新的工具安裝程序架構搭配使用，因此您可以輕鬆地使用新版本的 NuGet，而不需要等待工作更新、為這個組織/集合以外的已驗證摘要提供更好的支援，以及預設使用 NuGet 4。
NuGet 發行者 NuGetPublisher@0	已淘汰：請改用 「NuGet」 工作。 它可與新的工具安裝程序架構搭配使用，因此您可以輕鬆地使用新版本的 NuGet，而不需要等待工作更新、為這個組織/集合以外的已驗證摘要提供更好的支援，以及預設使用 NuGet 4。
NuGet 還原 NuGetRestore@1	還原 NuGet 套件，為 Visual Studio 建置步驟做準備。
PyPI 發行者 PyPIPublisher@0	使用 Twine 建立和上傳 sdist 或 wheel 至 PyPI 相容的索引。
Python pip authenticate PipAuthenticate@1 PipAuthenticate@0	用於安裝 Python 發行版的 PIP 用戶端的認證任務。
Python Twine 上傳 authenticate TwineAuthenticate@1 TwineAuthenticate@0	使用 Twine 上傳 Python 發行版時要進行認證。 將 '-r FeedName/EndpointName --config-file $（PYPIRC_PATH）' 新增至對應項上傳命令。 針對此組織中存在的摘要，請使用摘要名稱作為存放庫 （-r）。 否則，請使用服務連線中定義的端點名稱。
通用套件 UniversalPackages@1 UniversalPackages@0	下載或發佈通用套件。

測試工作

任務	描述
App Center 測試 AppCenterTest@1	用 Visual Studio App Center 測試應用程式套件。
Azure 負載測試 AzureLoadTest@1	用 Azure 負載測試 自動化效能回歸測試。
Azure 測試計畫 AzureTestPlan@0	針對不同的測試框架執行手動和自動化測試點，例如Java的Maven和Gradle、Python的PyTest和JavaScript的Jest。
容器結構測試 ContainerStructureTest@0	使用 container-structure-test （https://github.com/GoogleContainerTools/container-structure-test）根據四種測試類別來驗證影像的結構-命令測試、檔案存在測試、檔案內容測試和元數據測試。
Mobile Center測試 VSMobileCenterTest@0	測試使用 Visual Studio Mobile Center 的行動應用程式套件。
發佈程式代碼涵蓋範圍結果 PublishCodeCoverageResults@2 PublishCodeCoverageResults@1	從組建發佈任何程式代碼涵蓋範圍結果。
發佈測試結果 PublishTestResults@2 PublishTestResults@1	將測試結果發佈到 Azure Pipelines。
執行功能測試 RunVisualStudioTestsusingTestAgent@1	已棄用：此任務及其配套任務（Visual Studio Test Agent Deployment）已被棄用。 改用「Visual Studio 測試」任務。 VSTest 工作可以執行單元和功能測試。 使用多代理程式作業設定在一或多個代理程式上執行測試。 使用「Visual Studio 測試平台」任務來執行測試，無需代理程式上的 Visual Studio。 VSTest 工作也會帶來新功能，例如自動重新執行失敗的測試。
Visual Studio 測試 VSTest@3 VSTest@2 VSTest@1	使用 Visual Studio 測試（VsTest）執行器執行單元測試和功能測試（Selenium、Appium、Coded UI 測試等）。 可執行包含 Visual Studio 測試介面卡的測試框架，如 MsTest、xUnit、NUnit、Chutzpah（用於使用 QUnit、Mocha 和 Jasmine 進行 JavaScript 測試）等。 測試可以使用此工作在多個代理程式上散發（第 2 版和更新版本）。
Visual Studio 測試代理部署 DeployVisualStudioTestAgent@2 DeployVisualStudioTestAgent@1	DeployVisualStudioTestAgent@2已被取代。 使用 Visual Studio 測試任務來執行單元測試和功能測試。

工具工作

任務	描述
.NET Core SDK /執行時安裝程式 DotNetCoreInstaller@1 DotNetCoreInstaller@0	從網路或本地快取取得特定版本的 .NET Core SDK，並將其加入 PATH。
Docker CLI 安裝程式 DockerInstaller@0	在代理程式電腦上安裝 Docker CLI。
Duffle 工具安裝程式 DuffleInstaller@0	安裝指定的 Duffle 版本，以安裝和管理 CNAB 套件組合。
Go 工具安裝程式 GoTool@0	在快取中尋找或下載特定版本的 Go，並將它新增至 PATH。
Helm 工具安裝程式 HelmInstaller@1 HelmInstaller@0	在代理程式電腦上安裝 Helm。
安裝 Azure Func Core Tools FuncToolsInstaller@0	Install Azure Func Core Tools.
Java工具安裝器 JavaToolInstaller@1 JavaToolInstaller@0	從使用者提供的 Azure blob 或工具快取中取得特定版本的 Java，並設定 JAVA_HOME。
Kubectl 工具安裝程式 KubectlInstaller@0	在代理程式電腦上安裝 Kubectl。
Kubelogin 工具安裝程式 KubeloginInstaller@0	協助安裝 kubelogin。
NuGet 工具安裝程式 NuGetToolInstaller@1 NuGetToolInstaller@0	從因特網或工具快取取得特定版本的 NuGet，並將它新增至 PATH。 使用此工作來變更 NuGet 工作中使用的 NuGet 版本。
使用 .NET 核心 UseDotNet@2	從網路或本地快取取得特定版本的 .NET Core SDK，並將其加入 PATH。 使用此任務可更改後續任務中使用的 .NET 核心版本。 此外，也提供 Proxy 支援。
使用 Node.js 生態系統 UseNode@1 NodeTool@0	設定 Node.js 環境，並將它新增至PATH，同時提供 Proxy支援。
使用 Python 版本 UsePythonVersion@0	從工具快取中使用指定版本的 Python，並可選擇性地將其加入 PATH。
使用 Ruby 版本 UseRubyVersion@0	從工具快取使用指定的 Ruby 版本，選擇性地將其新增至 PATH。
Visual Studio test platform installer VisualStudioTestPlatformInstaller@1	從 nuget.org 或工具快取取得測試平臺。 滿足「vstest」需求，可用於執行測試並使用 Visual Studio 測試任務收集診斷資料。

公用程式工作

任務	描述
進階安全性相依性掃描 高級安全依賴項Scanning@1	掃描你的原始碼中的 開放原始碼 依賴性漏洞。
封存盤案 ArchiveFiles@2 ArchiveFiles@1	將檔案壓縮成 .7z、.tar.gz 或 .zip。
Azure 網路 Load Balancer AzureNLBManagement@1	將 Azure 虛擬機的網路介面連接到 Load Balancer 的後端位址池。
Bash Bash@3	在 macOS、Linux 或 Windows 上執行 Bash 腳本。
Batch 腳本 BatchScript@1	執行 Windows 指令或批次腳本，並可選擇性地允許它改變環境。
快取 Cache@2	執行之間的快取檔案。
快取 （Beta） CacheBeta@1 CacheBeta@0	執行之間的快取檔案。
命令行 CmdLine@2 CmdLine@1	在 Linux 和 macOS 上用 Bash 執行命令列腳本，Windows 上用 cmd.exe。
複製和發佈組建成品 CopyPublishBuildArtifacts@1	CopyPublishBuildArtifacts@1已被取代。 請改用 [複製檔案] 工作和 [發佈組建成品] 工作。
複製檔案 CopyFiles@2 CopyFiles@1	使用符合檔案路徑的模式，將檔案從源資料夾複製到目標資料夾（而非資料夾路徑）。
cURL 上傳檔案 cURLUploader@2 cURLUploader@1	使用 cURL 支援的通訊協定來上傳檔案。
解密檔案 （OpenSSL） DecryptFile@1	使用 OpenSSL 解密檔案。
延遲 Delay@1	將工作流程的進一步執行延遲為固定時間。
刪除檔案 DeleteFiles@1	刪除符合模式的資料夾或檔案。
部署 Azure靜態網頁應用程式 AzureStaticWebApp@0	建立並部署一個 Azure 靜態網頁應用程式。
從檔案共享下載成品 DownloadFileshareArtifacts@1	從檔案共享下載成品，例如 \share\drop。
下載組建成品 DownloadBuildArtifacts@1 DownloadBuildArtifacts@0	下載已儲存為已完成組建成品的檔案。
下載 GitHub 版本 DownloadGitHubRelease@0	從倉庫下載 GitHub Release。
下載套件 DownloadPackage@1 DownloadPackage@0	從 Azure Artifacts 的套件管理訂閱源下載 package a package。
下載管線成品 DownloadPipelineArtifact@2 DownloadPipelineArtifact@1 DownloadPipelineArtifact@0	下載組建和管線成品。
下載安全檔案 DownloadSecureFile@1	將安全檔案下載到代理程式計算機。
擷取檔案 ExtractFiles@1	擷取各種封存和壓縮檔案，例如.7z、.rar、.tar.gz和 .zip。
檔案轉換 FileTransform@2 FileTransform@1	將令牌取代為 XML 或 JSON 組態檔中的變數值。
FTP 上傳 FtpUpload@2 FtpUpload@1	使用 FTP 上傳檔案。
GitHub 留言 GitHubComment@0	寫一則留言給你的 GitHub 實體，例如問題或拉取請求（PR）。
GitHub 釋放 GitHubRelease@1 GitHubRelease@0	建立、編輯或刪除 GitHub 發布。
安裝 Apple 憑證 InstallAppleCertificate@2 InstallAppleCertificate@1 InstallAppleCertificate@0	安裝在 macOS 代理程式電腦上建置所需的 Apple 憑證。
安裝 Apple 布建設定檔 InstallAppleProvisioningProfile@1 InstallAppleProvisioningProfile@0	安裝在 macOS 代理程式電腦上建置所需的 Apple 布建配置檔。
安裝 SSH 金鑰 InstallSSHKey@0	在建置或部署之前安裝SSH 金鑰。
Invoke Azure Function AzureFunction@2 AzureFunction@1 AzureFunction@0	Invoke an Azure Function.
Jenkins 下載成品 JenkinsDownloadArtifacts@2 JenkinsDownloadArtifacts@1	下載 Jenkins 作業所產生的成品。
Node.js 工作執行器安裝程式 NodeTaskRunnerInstaller@0	安裝特定 Node.js 版本以執行節點工作。
表示法 Notation@0	Azure Pipepine Task for set Notation CLI， sign and verify with Notation.
PowerShell PowerShell@2 PowerShell@1	在 Linux、macOS 或 Windows 上執行 PowerShell 腳本。
發佈組建成品 PublishBuildArtifacts@1	將建置工件發佈到 Azure Pipelines 或 Windows 檔案分享。
發佈管線成品 PublishPipelineArtifact@1 PublishPipelineArtifact@0	發佈 （upload） 檔案或目錄作為目前執行的具名成品。
發佈管線元數據 PublishPipelineMetadata@0	將管線元數據發佈至辨識項存放區。
發佈至Azure 服務匯流排 PublishToAzureServiceBus@2 PublishToAzureServiceBus@1 PublishToAzureServiceBus@0	透過 Azure Resource Manager 服務連線（無需代理）向 Azure 服務匯流排 發送訊息。
Python 指令碼 PythonScript@0	執行 Python 檔案或內嵌腳本。
查詢 Azure 監視器 alerts AzureMonitor@1	請觀察 Azure 監視器 對主動警報所設定的規則。
Query Classic Azure 監視器 alerts AzureMonitor@0	觀察設定的經典 Azure 監視器 對主動警報的規則。
查詢工作專案 queryWorkItems@0	執行工作項目查詢，並檢查傳回的項目數目。
檢閱應用程式 ReviewApp@0	在部署階段提供者下使用此工作，以動態方式建立資源。
Service Fabric PowerShell ServiceFabricPowerShell@1	在 Azure Service Fabric 叢集連線的情境中執行 PowerShell 腳本。
Shell 腳本 ShellScript@2	使用Bash執行殼層腳本。
更新 Service Fabric 應用程式版本 ServiceFabricUpdateAppVersions@1	自動更新已封裝的 Service Fabric 應用程式版本。
更新 Service Fabric 清單 ServiceFabricUpdateManifests@2	自動更新打包的 Azure Service Fabric 應用程式中部分應用程式與服務清單。

開源

這些任務分別是開放原始碼 在GitHub。 歡迎意見反應和貢獻。 如需工作變更清單，請參閱 管線工作變更記錄，包括工作更新的歷程記錄。

FAQ

什麼是工作輸入別名？

工作的輸入是由 label、name識別，而且可能包含一或多個選擇性 aliases。 下列範例是 原始程式碼 摘錄 已知主機專案InstallSSHKey@0 工作的輸入。

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

在 2019 年引進 YAML 管線之前，管線是使用 UI 型管線編輯器來建立和編輯，而且管線作者只會使用 label 來參考工作輸入。

在 2019 年引進 YAML 管線時，使用 YAML 的管線作者開始使用工作輸入 name 來參考工作輸入。 在某些情況下，工作輸入名稱沒有描述性，因此已新增 aliases 以提供工作輸入的其他描述性名稱。

例如，InstallSSHKey@0 工作具有名為 hostName 輸入，其預期有來自 known_hosts 檔案的專案。 傳統管線設計工具中的 已知主機專案 標籤會清楚明瞭，但在 YAML 管線中使用 hostName 名稱時並不明確。 已引進工作輸入別名，讓工作作者為其先前撰寫的工作提供譯碼名稱，以及針對 InstallSSHKey@0 工作，新增了 knownHostsEntry別名，同時保留原始 hostName 名稱，以便與使用該名稱的現有管線相容。

工作輸入 aliases 中的任何專案都可與 YAML 管線中的 name 互換。 下列兩個 YAML 代碼段的功能相同，第一個範例使用 knownHostsEntry 別名，第二個範例則使用 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

自 2019.1 Azure DevOps Server 起，引入了 YAML 管線編輯器，提供 intellisense 類型的功能。

YAML 管線編輯器會使用 Yamlschema - 取得 REST API 來擷取編輯器中用於驗證的架構。 如果工作輸入有別名，架構會將別名升階為工作輸入的主要 YAML 名稱，而 intellisense 會建議別名。

下列範例是 YAML 架構中 工作的 InstallSSHKey@0 工作輸入，knownHostsEntry 列在 hostName 集合中的名稱位置和 aliases 中。

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

由於 YAML 管線編輯器中的 Intellisense 會顯示 knownHostsEntry，而 工作助理所產生的 YAML 會在產生的 YAML 中使用 knownHostsEntry，因此工作參考會顯示工作原始程式碼中的 alias 做為工作輸入的 YAML 名稱。 如果工作有多個別名（有幾個別名有兩個別名），則會使用第一個別名作為名稱。

為什麼工作參考會變更？

Azure Pipelines 任務參考文件已移至目前位置，以支援以下改進。

• 任務文章是利用任務原始碼產生的，來源是Azure Pipelines任務開放原始碼倉庫。
• 工作輸入名稱和別名是從工作來源產生，因此它們一律為最新狀態。
• YAML 語法區塊是從工作來源產生，因此它們是最新的。
• 支援社群貢獻與整合式用戶內容，例如增強的工作輸入描述、備註和範例。
• 提供所有支援的 Azure DevOps 版本的任務覆蓋。
• 已更新每個短期衝刺，以涵蓋最新的更新。

若要參與，請參閱 參與工作內容。

我可以在哪裡瞭解如何建置我的應用程式？

建置您的應用程式

我可以新增自己的建置工作嗎？

是：新增建置工作

什麼是安裝程式工作？

若要深入瞭解工具安裝程式工作，請參閱 工具安裝程式。

舊版

• Azure DevOps Server 2020.1 任務參考
• Azure DevOps Server 2020 年任務參考
• Azure DevOps Server 2019.1 任務參考
• Azure DevOps Server 2019 任務參考
• TFS 2018 任務參考