UseDotNet@2 - 使用 dotnet v2 工作

使用此工作可從網際網路或本機快取取得特定版本的 .NET Core SDK，並將其新增至 PATH。 使用此工作來變更後續工作中使用的 .NET Core 版本。 此工作也提供 Proxy 支援。

Syntax

# Use .NET Core v2
# Acquires a specific version of the .NET Core SDK from the internet or the local cache and adds it to the PATH. Use this task to change the version of .NET Core used in subsequent tasks. Additionally provides proxy support.
- task: UseDotNet@2
  inputs:
    #packageType: 'sdk' # 'runtime' | 'sdk'. Package to install. Default: sdk.
    #useGlobalJson: false # boolean. Optional. Use when packageType = sdk. Use global json. Default: false.
    #workingDirectory: # string. Optional. Use when useGlobalJson = true. Working Directory. 
    #version: # string. Optional. Use when useGlobalJson = false || packageType = runtime. Version. 
    #includePreviewVersions: false # boolean. Optional. Use when useGlobalJson = false  || packageType = runtime. Include Preview Versions. Default: false.
  # Advanced
    #vsVersion: # string. Compatible Visual Studio version. 
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.

輸入

packageType - 要安裝的套件
string. 允許的值： runtime 、 sdk (SDK (包含 runtime) ) 。 預設值：sdk。

指定是否只安裝 .NET 執行時間或 SDK。

useGlobalJson - 使用全域 json
boolean. 選擇性。 使用 時機 packageType = sdk 。 預設值：false。

從 global.json 檔案安裝所有 SDK。 系統會從 system.DefaultWorkingDirectory 搜尋這些檔案。 您可以藉由設定工作目錄輸入來變更搜尋根路徑。

6.x和 6.1.x 格式 (使用 .x 做為輸入中所述 UseDotNet@2.version 的萬用字元) ，用於 version 工作中輸入，而不是 sdk.version 中的 global.json 參數。

如果您收到類似 ##[error]Version 6.0.x is not allowed. Allowed version types are: majorVersion.x, majorVersion.minorVersion.x, majorVersion.minorVersion.patchVersion. More details: Only explicit versions and accepted, such as: 2.2.301. Version: 6.0.x is not valid. 的錯誤訊息，而且您正在使用 global.json ，請在 中 global.json 簽 sdk.version 入 。

如需 的詳細資訊 global.json ，請參閱 選取要使用的 .NET 版本。

workingDirectory - 工作目錄
string. 選擇性。 使用 時機 useGlobalJson = true 。

指定使用 useGlobalJson 時應該搜尋檔案的路徑 global.json 。 如果值是空的， system.DefaultWorkingDirectory 則會被視為根路徑。

version - 版本
string. 選擇性。 使用 時機 useGlobalJson = false || packageType = runtime 。

指定要安裝的 .NET Core SDK 或執行時間版本。 版本值格式會顯示範例：

• 2.x：使用指定的主要版本 2 ，安裝最新的 SDK 或執行時間。
• 3.1.x：使用指定的主要和次要版本和 ， 3 以及 1 安裝最新的 SDK 或執行時間。
• 3.1.402：安裝指定的 SDK 或執行時間版本 。 3.1.402

SDK 或執行時間安裝的版本值位於 檔案中 releases.json 。 主要/次要版本的連結 releases.json 位於 releases-index 檔案中。 例如， 3.1 版 releases.json 檔案的連結。

vsVersion - 相容的 Visual Studio 版本
string.

指定對應 .NET Core SDK 安裝的相容 Visual Studio 版本。 此值必須是完整的版本號碼，例如 16.6.4 ，其中包含主要版本、次要版本和修補程式編號。

用於字串的 SDK 或執行時間安裝 version 版本值位於 檔案中 releases.json 。 主要/次要版本的連結 releases.json 位於 releases-index 檔案中。 例如， 3.1 版 releases.json 檔案的連結。

includePreviewVersions - 包含預覽版本
boolean. 選擇性。 使用 時機 useGlobalJson = false || packageType = runtime 。 預設值：false。

如果設定為 true ，當工作搜尋最新的執行時間/SDK 版本時，包括預覽版本，例如搜尋 2.2.x 或 3.1.x 。 如果您指定確切的版本，例如 3.0.100-preview3-010431 ，則會忽略此設定。

installationPath - 安裝.Net Core的路徑
string. 預設值：$(Agent.ToolsDirectory)/dotnet。

指定應該安裝 .NET Core SDK/Runtime 的位置。 不同的路徑可能會對 產生下列影響。NET 的行為。

• $(Agent.ToolsDirectory)：使用此路徑會快取代理程式上的安裝，因為不會跨管線清除此目錄。 在代理程式上執行的所有管線都可以存取先前安裝的版本。
• $(Agent.TempDirectory)：使用此路徑可確保管線不會使用快取版本的 .NET Core，因為每個管線之後都會清除此資料夾。
• 另一個路徑：如果代理程式進程具有路徑的存取權，您可以使用任何路徑。 這會變更機器的狀態，並影響其上執行的所有進程。

注意

您可以使用 [多層級查閱] 設定 performMultiLevelLookup 來設定 .NET 主機搜尋版本的方式。

performMultiLevelLookup - 執行多層級查閱
boolean. 預設值：false。

設定 .NET 主機進程在搜尋適當的共用架構時的行為。 值如下：

• false：主機進程只會搜尋工作所指定資料夾中存在的版本。
• true：主機進程會使用多層級查閱，在預先定義的全域位置中搜尋。 預設全域位置為：
  • C:\Program Files\dotnet (64 位進程)
  • C:\Program Files (x86)\dotnet) (32 位進程

深入瞭解 多層級 SharedFX 查閱。

注意

performMultiLevelLookup 僅適用于以 Windows 為基礎的代理程式。

工作控制選項

除了工作輸入之外，所有工作都有控制選項。 如需詳細資訊，請參閱 控制項選項和一般工作屬性。

輸出變數

無。

備註

使用 .NET Core 工作會從網際網路或工具快取取得特定版本的 .NET Core ，並將它新增至裝載或私人) 的 Azure Pipelines (代理程式 PATH。 使用此工作來變更後續工作中使用的 .NET Core 版本 ，例如DotNetCoreCLI@2。 在組建定義中的 DotNetCoreCLI@2之前新增 此工作，可確保在建置、測試和發佈應用程式時可以使用版本。

工具安裝程式方法也可讓您與代理程式更新週期分離。 如果您要尋找的 .NET Core 版本遺失于 Azure Pipelines 代理程式 (裝載或私人) ，您可以使用這項工作來取得代理程式上安裝的正確版本。

規格需求

需求	描述
管線類型	YAML、傳統組建、傳統版本
在 上執行	Agent、DeploymentGroup
要求	無
Capabilities	執行此工作滿足相同作業中任何後續工作的下列 需求 ：DotNetCore
命令限制	任意
可設定變數	任意
代理程式版本	2.144.0 或更新版本
工作類別	工具