DotNetCoreInstaller@1 - .NET Core SDK/執行時間安裝程式 v1 工作

使用此工作可從網際網路或本機快取取得特定版本的 .NET Core SDK，並將其新增至 PATH。

重要

此工作已被取代，且將于 2024 年 1 月 31 日淘汰。 使用 UseDotNet@2。

Syntax

# .NET Core SDK/runtime installer v1
# Acquire a specific version of the .NET Core SDK from the internet or local cache and add it to the PATH.
- task: DotNetCoreInstaller@1
  inputs:
    packageType: 'sdk' # 'runtime' | 'sdk'. Required. Package to install. Default: sdk.
    version: '2.2.x' # string. Required. Version. Default: 2.2.x.
    #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 (包含 runtime) ) 。 預設值：sdk。

指定只安裝 Runtime 或完整 SDK。

version - 版本
string. 必要。 預設值：2.2.x。

指定要安裝的 .NET Core SDK 或執行時間版本。

使用下列格式來指定版本：

• 2.x：在主要版本中安裝最新版本。
• 2.2.x：在主要和次要版本中安裝最新版本。
• 2.2.104：安裝確切的版本。

在releases-index 檔案中尋找 安裝 SDK/Runtime 的 值 version 。

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

指定是否要在搜尋最新版本時包含預覽版本。 如果您指定確切的版本，例如 3.0.100-preview3-010431 ，則會忽略此設定。

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

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

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

您也可以設定多層級查閱設定。 此設定可以將 .NET 主機設定為探查適合的版本。

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

此輸入僅適用于以 Windows 為基礎的代理程式。 此輸入會設定 .NET 主機進程的行為，以尋找適當的共用架構。 False 表示主機進程只會查看此工作所指定資料夾中的版本。 True 表示主機會嘗試使用多層級查閱來查看預先定義的全域位置。

針對 Windows，預設的全域位置為：

• C:\Program Files\dotnet (64 位進程)
• C:\Program Files (x86)\dotnet (32 位進程)

如需詳細資訊，請參閱 多層級 SharedFX 查閱。

工作控制選項

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

輸出變數

無。

備註

此工作已被取代。 使用 @UseDotNet2。

此工作版本的新功能。

• 支援並存安裝多個版本。
• 支援版本中的模式，以擷取次要/主要版本中的最新模式。
• 限制多層級查閱。

規格需求

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