共用方式為

UseDotNet@2 - 使用 dotnet v2 工作

  • 發行項

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

語法

# 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.
    #requestTimeout: '300000' # string. Set timeout for package download request. Default: 300000.
  # 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.

# 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.

# 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
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.

# Use dotnet 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.
    #version: # string. Version. 
    #includePreviewVersions: false # boolean. Include Preview Versions. Default: false.
  # Advanced
    #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 （包含運行時間））。 預設值：sdk。

指定只安裝 .NET 運行時間或 SDK。


useGlobalJson - 使用全域 json
boolean。 自選。 packageType = sdk時使用 。 預設值：false。

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

UseDotNet@2.version 輸入中所述的 6.x 和 6.1.x 格式（使用 .x 做為通配符），用於工作中 version 輸入，而不是 global.json中的 sdk.version 參數。

如果您收到類似 ##[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：使用指定的主要版本安裝最新的 SDK 或執行時間，2。
  • 3.1.x：使用指定的主要和次要版本安裝最新的 SDK 或執行時間，3 和 1。
  • 3.1.402：安裝指定的 SDK 或執行時間版本，3.1.402。

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


version - 版本
string。

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

  • 2.x：使用指定的主要版本安裝最新的 SDK 或執行時間，2。
  • 3.1.x：使用指定的主要和次要版本安裝最新的 SDK 或執行時間，3 和 1。
  • 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，則會忽略此設定。


includePreviewVersions - 包含預覽版本
boolean。 預設值：false。

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


安裝 .Net Core的 installationPath - 路徑
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 型代理程式。


requestTimeout - 設定套件下載要求逾時
string。 預設值：300000。

為工作為取得 .NET 套件所做的 HTTP 要求提供逾時值。 此值以毫秒為單位。 默認值為300000毫秒（5分鐘）。 不能超過 600000 毫秒 （10 分鐘）。


工作控制選項

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

輸出變數

沒有。

言論

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

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

要求

要求 描述
管線類型 YAML、傳統組建、傳統版本
執行於 Agent、DeploymentGroup
需求 沒有
功能 執行此工作符合下列 要求， 相同作業中的任何後續工作：DotNetCore
命令限制 任何
Settable 變數 任何
代理程式版本 2.144.0 或更新
工作類別 工具
要求 描述
管線類型 YAML、傳統組建、傳統版本
執行於 Agent、DeploymentGroup
需求 沒有
功能 執行此工作符合下列 要求， 相同作業中的任何後續工作：DotNetCore
命令限制 任何
Settable 變數 任何
代理程式版本 所有支援的代理程式版本。
工作類別 工具