Azure Pipelines 工作參考

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

本節中的文章描述 Azure Pipelines 的內建工作，並針對每個工作保留特殊意義的屬性指定語意。

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

如需使用工作撰寫管線的作法和教學課程，包括建立自定義工作、自定義延伸模組和在Visual Studio Marketplace 上尋找工作，請參閱 工作概念 和 Azure Pipelines 檔。

重要

若要檢視平臺可用的工作工作參考，請確定您從位於目錄上方的版本選取器中選取正確的 Azure DevOps 版本。 功能支援會根據您是使用 Azure DevOps Services 還是內部部署版本的 Azure DevOps Server 而有所不同。
若要瞭解您使用哪一個內部部署版本，請參閱 查閱您的 Azure DevOps 平臺和版本。

建置工作

任務	描述
.NET Core DotNetCoreCLI@2 DotNetCoreCLI@1 DotNetCoreCLI@0	建置、測試、封裝或發佈 .NET 應用程式，或執行自定義 .NET CLI 命令。
進階安全性自動建置 AdvancedSecurity-Codeql-Autobuild@1	在源資料夾中尋找和建置項目檔，以嘗試建置存放庫。
進階安全性初始化 CodeQL AdvancedSecurity-Codeql-Init@1	初始化 CodeQL 資料庫，以準備建置。
進階安全性執行 CodeQL 分析 AdvancedSecurity-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 Docker@2 Docker@1 Docker@0	建置或推送 Docker 映射、登入或註銷、啟動或停止容器，或執行 Docker 命令。
Docker Compose DockerCompose@1 DockerCompose@0	建置、推送或執行多容器 Docker 應用程式。 工作可以搭配 Docker 或 Azure Container Registry 使用。
下載 GitHub Nuget 套件 DownloadGitHubNugetPackage@1	使用 dotnet CLI 還原 nuget 套件。
Go Go@0	取得、建置或測試 Go 應用程式，或執行自訂 Go 命令。
Gradle Gradle@3 Gradle@2 Gradle@1	使用 Gradle 包裝函式腳本建置。
格魯特 Grunt@0	執行 Grunt JavaScript 工作執行器。
gulp gulp@1 gulp@0	執行 gulp Node.js 串流工作型建置系統。
索引來源和發佈符號 PublishSymbols@2 PublishSymbols@1	為您的原始程式碼編制索引，並將符號發佈至檔案共用或 Azure Artifacts 符號伺服器。
Jenkins 佇列工作 JenkinsQueueJob@2	將 Jenkins 伺服器上的作業排入佇列。
Jenkins 佇列工作 JenkinsQueueJob@1	將 Jenkins 伺服器上的作業排入佇列。
Maven Maven@4 Maven@3 Maven@2 Maven@1	使用 Apache Maven 建置、測試及部署。
MSBuild MSBuild@1	使用 MSBuild 建置。
準備分析組態 SonarQubePrepare@7 SonarQubePrepare@6 SonarQubePrepare@5 SonarQubePrepare@4	準備 SonarQube 伺服器分析組態。
發佈品質網關結果 SonarQubePublish@7 SonarQubePublish@6 SonarQubePublish@5 SonarQubePublish@4	在 Azure DevOps 建置結果上發佈 SonarQube Server 的品質閘道結果，以在實際分析之後使用。
執行程式代碼分析 SonarQubeAnalyze@7 SonarQubeAnalyze@6 SonarQubeAnalyze@5 SonarQubeAnalyze@4	執行掃描器並將結果上傳至 SonarQube 伺服器。
Visual Studio 組建 VSBuild@1	使用 MSBuild 建置並設定 Visual Studio 版本屬性。
Xamarin.Android XamarinAndroid@1	使用 Xamarin 建置 Android 應用程式。
Xamarin.iOS XamariniOS@2 XamariniOS@1	在macOS上使用 Xamarin 建置 iOS 應用程式。
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 應用程式組態導出 AzureAppConfigurationExport@10	從 Azure 應用程式組態將索引鍵/值匯出至工作變數。
Azure App Service 傳統版 （已淘汰） AzureWebPowerShellDeployment@1	使用 Azure PowerShell 建立或更新 Azure App Service。
Azure App Service 部署 AzureRmWebAppDeployment@4 AzureRmWebAppDeployment@3 AzureRmWebAppDeployment@2	使用 Docker、Java、.NET、.NET、.NET Core、Node.js、PHP、Python 或 Ruby，部署至 Azure App Service Web、行動或 API 應用程式。
Azure App Service 管理 AzureAppServiceManage@0	啟動、停止、重新啟動、位置交換、位置刪除、安裝網站延伸模組或啟用 Azure App Service 的持續監視。
Azure App Service 設定 AzureAppServiceSettings@1	更新/新增適用於Linux或 Windows 的 Azure Web 應用程式的應用程式設定。
Azure CLI AzureCLI@2 AzureCLI@1	在 Linux 代理程式上執行時，針對 PowerShell Core/Shell 腳本中的 Azure 訂用帳戶執行 Azure CLI 命令，或在 Windows 代理程式上執行時執行 PowerShell/PowerShell Core/Batch 腳本。
Azure CLI 預覽版 AzureCLI@0	使用 Azure CLI 命令對 Azure 訂用帳戶執行 Shell 或 Batch 腳本。
Azure 雲端服務部署 AzureCloudPowerShellDeployment@2 AzureCloudPowerShellDeployment@1	部署 Azure 雲端服務。
Azure Container Apps Deploy AzureContainerApps@1 AzureContainerApps@0	用來建置及部署 Azure Container Apps 的 Azure DevOps 工作。
適用於 MySQL 的 Azure 資料庫部署 AzureMysqlDeployment@1	執行腳本，並變更適用於 MySQL 的 Azure 資料庫。
Azure 檔案複製 AzureFileCopy@6 AzureFileCopy@5 AzureFileCopy@4 AzureFileCopy@3 AzureFileCopy@2 AzureFileCopy@1	將檔案複製到 Azure Blob 記憶體或虛擬機。
在 Kubernetes 上 Azure 函式 AzureFunctionOnKubernetes@1 AzureFunctionOnKubernetes@0	將 Azure 函式部署至 Kubernetes 叢集。
Azure Functions Deploy AzureFunctionApp@2 AzureFunctionApp@1	使用 .NET、Python、JavaScript、PowerShell、Java 型 Web 應用程式更新函式應用程式。
適用於容器 的 Azure Functions AzureFunctionAppContainer@1	使用 Docker 容器更新函式應用程式。
Azure Key Vault AzureKeyVault@2 AzureKeyVault@1	下載 Azure Key Vault 秘密。
Azure 監視器警示 AzureMonitorAlerts@0	針對 Azure 資源的可用計量設定警示（已淘汰）。
Azure PowerShell AzurePowerShell@5 AzurePowerShell@4 AzurePowerShell@3 AzurePowerShell@2 AzurePowerShell@1	在 Azure 環境中執行 PowerShell 腳本。
Azure 資源群組部署 AzureResourceGroupDeployment@2	將 Azure Resource Manager （ARM） 範本部署至資源群組並管理虛擬機。
Azure 資源群組部署 AzureResourceGroupDeployment@1	部署、啟動、停止、刪除 Azure 資源群組。
Azure Spring Apps AzureSpringCloud@0	將應用程式部署至 Azure Spring Apps 並管理部署。
Azure SQL Database 部署 SqlAzureDacpacDeployment@1	使用 DACPAC 部署 Azure SQL Database，或使用 SQLCMD 執行腳本。
Azure VM 擴展集部署 AzureVmssDeployment@0	部署虛擬機擴展集映像。
Azure Web 應用程式 AzureWebApp@1	部署適用於Linux或 Windows 的 Azure Web 應用程式。
適用於容器的 Azure Web 應用程式 AzureWebAppContainer@1	將容器部署至 Azure App Service。
建置機器映像 PackerBuild@1 PackerBuild@0	使用 Packer 建置機器映射，可用於 Azure 虛擬機擴展集部署。
檢查 Azure 原則合規性 AzurePolicyCheckGate@0	Azure 原則的安全性與合規性評定。
Chef 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	使用 PSSession 和 Invoke-Command 在遠端電腦上執行 PowerShell 腳本，以進行遠端處理。
目標機器上的PowerShell PowerShellOnTargetMachines@2 PowerShellOnTargetMachines@1	在遠端電腦上執行 PowerShell 腳本。
Service Fabric 應用程式部署 ServiceFabricDeploy@1	將 Azure Service Fabric 應用程式部署至叢集。
Service Fabric Compose 部署 ServiceFabricComposeDeploy@0	將 Docker Compose 應用程式部署至 Azure Service Fabric 叢集。
SQL Server 資料庫部署 SqlDacpacDeploymentOnMachineGroup@0	使用 DACPAC 或 SQL 腳本部署 SQL Server 資料庫。
SQL Server 資料庫部署 （已淘汰） SqlServerDacpacDeployment@1	使用 DACPAC 部署 SQL Server 資料庫。
SSH SSH@0	使用 SSH 在遠端電腦上執行殼層命令或腳稿。
Windows 電腦檔案複製 WindowsMachineFileCopy@2 WindowsMachineFileCopy@1	將檔案複製到遠端 Windows 電腦。

封裝工作

任務	描述
貨物驗證 （工作執行器） CargoAuthenticate@0	用於安裝貨物箱分配的貨物客戶端驗證工作。
CocoaPods CocoaPods@0	安裝 Swift 和 Objective-C Cocoa 專案的 CocoaPods 相依性。
Conda 環境 CondaEnvironment@1 CondaEnvironment@0	此工作已被取代。 直接在腳本中使用 conda 來處理 Anaconda 環境。
下載 Github Npm 套件 DownloadGithubNpmPackage@1	從 GitHub 安裝 npm 套件。
Maven 驗證 MavenAuthenticate@0	提供 Azure Artifacts 摘要和外部 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 套件，或執行 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 命令 NuGet@0	已淘汰：請改用 「NuGet」 工作。 它可與新的工具安裝程序架構搭配使用，因此您可以輕鬆地使用新版本的 NuGet，而不需要等待工作更新、為這個組織/集合以外的已驗證摘要提供更好的支援，以及預設使用 NuGet 4。
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 驗證 PipAuthenticate@1 PipAuthenticate@0	用於安裝 Python 散發套件之 pip 客戶端的驗證工作。
Python 對應項上傳驗證 TwineAuthenticate@1 TwineAuthenticate@0	使用對應項來上傳 Python 散發套件的驗證。 將 '-r FeedName/EndpointName --config-file $（PYPIRC_PATH）' 新增至對應項上傳命令。 針對此組織中存在的摘要，請使用摘要名稱作為存放庫 （-r）。 否則，請使用服務連線中定義的端點名稱。
通用套件 UniversalPackages@0	下載或發佈通用套件。
Xamarin 元件還原 XamarinComponentRestore@0	此工作已被取代。 請改用 『NuGet』。

測試工作

任務	描述
App Center 測試 AppCenterTest@1	使用 Visual Studio App Center 測試應用程式套件。
Azure Load Testing AzureLoadTest@1	使用 Azure 負載測試將效能回歸測試自動化。
容器結構測試 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@1	將測試結果發佈至 Azure Pipelines。
發佈測試結果 PublishTestResults@2	將測試結果發佈至 Azure Pipelines。
執行功能測試 RunVisualStudioTestsusingTestAgent@1	已淘汰：這項工作及其隨附工作 （Visual Studio Test Agent Deployment） 已被取代。 請改用 『Visual Studio Test』 工作。 VSTest 工作可以執行單元和功能測試。 使用多代理程式作業設定在一或多個代理程式上執行測試。 使用 「Visual Studio 測試平臺」工作來執行測試，而不需要代理程式上的Visual Studio。 VSTest 工作也會帶來新功能，例如自動重新執行失敗的測試。
Visual Studio Test VSTest@3 VSTest@2 VSTest@1	使用 Visual Studio Test （VsTest） 執行器來執行單元和功能測試（Selenium、Appium、自動程式化 UI 測試等）。 可以執行具有 Visual Studio 測試配接器的測試架構，例如 MsTest、xUnit、NUnit、Chutzpah（針對使用 QUnit、Mocha 和 Jasmine 的 JavaScript 測試）。。 測試可以使用此工作在多個代理程式上散發（第 2 版和更新版本）。
Visual Studio 測試代理程式部署 DeployVisualStudioTestAgent@2	DeployVisualStudioTestAgent@2已被取代。 使用 Visual Studio 測試工作來執行單元和功能測試。
Visual Studio 測試代理程式部署 DeployVisualStudioTestAgent@1	部署及設定測試代理程式，以在一組機器上執行測試。
Xamarin Test Cloud XamarinTestCloud@1	[已淘汰]使用 Xamarin.UITest 使用 Xamarin 測試雲端測試行動應用程式。 請改用「App Center 測試」工作。

工具工作

任務	描述
.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	安裝 Azure Func Core Tools。
Java 工具安裝程式 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 Core UseDotNet@2	從因特網或本機快取取得特定版本的 .NET Core SDK，並將其新增至PATH。 使用此工作來變更後續工作中使用的 .NET Core 版本。 此外，也提供 Proxy 支援。
使用 Node.js 生態系統 UseNode@1 NodeTool@0	設定 Node.js 環境，並將它新增至PATH，同時提供 Proxy支援。
使用 Python 版本 UsePythonVersion@0	從工具快取使用指定的 Python 版本，選擇性地將其新增至 PATH。
使用 Ruby 版本 UseRubyVersion@0	從工具快取使用指定的 Ruby 版本，選擇性地將其新增至 PATH。
Visual Studio 測試平臺安裝程式 VisualStudioTestPlatformInstaller@1	從 nuget.org 或工具快取取得測試平臺。 滿足 『vstest』 需求，並可用於執行測試，並使用 Visual Studio 測試工作收集診斷數據。

公用程式工作

任務	描述
進階安全性相依性掃描 AdvancedSecurity-Dependency-Scanning@1	掃描原始碼相依性弱點。
封存盤案 ArchiveFiles@2	將檔案壓縮成 .7z、.tar.gz 或 .zip。
封存盤案 ArchiveFiles@1	使用壓縮格式封存盤案，例如.7z、.rar、.tar.gz和 .zip。
Azure 應用程式組態匯入 AzureAppConfigurationImport@10	將索引鍵/值匯入至 Azure 應用程式組態實例。
Azure 應用程式設定快照集 AzureAppConfigurationSnapshot@1	在 Azure 應用程式組態實例中建立快照集。
Azure 網路負載平衡器 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 靜態 Web 應用程式 AzureStaticWebApp@0	建置及部署 Azure 靜態 Web 應用程式。
從檔案共享下載成品 DownloadFileshareArtifacts@1	從檔案共享下載成品，例如 \share\drop。
下載組建成品 DownloadBuildArtifacts@1 DownloadBuildArtifacts@0	下載已儲存為已完成組建成品的檔案。
下載 GitHub 版本 DownloadGitHubRelease@0	從存放庫下載 GitHub Release。
下載套件 DownloadPackage@1 DownloadPackage@0	從 Azure Artifacts 中的套件管理摘要下載套件。
下載管線成品 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	安裝在 macOS 代理程式電腦上建置所需的 Apple 憑證。
安裝 Apple 憑證 InstallAppleCertificate@1 InstallAppleCertificate@0	安裝在macOS代理程式上建置所需的Apple 憑證。
安裝 Apple 布建設定檔 InstallAppleProvisioningProfile@1	安裝在 macOS 代理程式電腦上建置所需的 Apple 布建配置檔。
安裝 Apple 布建設定檔 InstallAppleProvisioningProfile@0	安裝在 macOS 代理程式上建置所需的 Apple 布建配置檔。
安裝 SSH 金鑰 InstallSSHKey@0	在建置或部署之前安裝SSH 金鑰。
叫用 Azure 函式 AzureFunction@1 AzureFunction@0	叫用 Azure 函式。
Jenkins 下載成品 JenkinsDownloadArtifacts@1	下載 Jenkins 作業所產生的成品。
Node.js 工作執行器安裝程式 NodeTaskRunnerInstaller@0	安裝特定 Node.js 版本以執行節點工作。
表示法 Notation@0	用於設定表示法 CLI 的 Azure Pipepine 工作，使用表示法簽署並驗證。
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 監視器警示 AzureMonitor@1	觀察已設定的作用中警示 Azure 監視器規則。
查詢傳統 Azure 監視器警示 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 應用程式中的應用程式和服務指令清單部分。
Xamarin 授權 XamarinLicense@1	[已淘汰]升級至 Xamarin 的免費版本：https://store.xamarin.com。

開源

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

常見問題

什麼是工作輸入別名？

工作的輸入是由 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

從 Azure DevOps Server 2019.1 開始，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 版本提供工作涵蓋範圍。
• 已更新每個短期衝刺，以涵蓋最新的更新。

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

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

建置您的應用程式

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

是：新增建置工作

什麼是安裝程式工作？

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