DotNetCoreInstaller@1 - .NET Core SDK/ランタイム インストーラー v1 タスク

このタスクを使用して、インターネットまたはローカル キャッシュから .NET Core SDK の特定のバージョンを取得し、PATH に追加します。

重要

このタスクは非推奨であり、2024 年 1 月 31 日に廃止されます。 UseDotNet@2を使用 します。

構文

# .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 (ランタイムを含む))。 既定値: sdk。

ランタイムのみをインストールするか、完全な SDK をインストールするかを指定します。

version - バージョン
string. 必須です。 既定値: 2.2.x。

インストールする .NET Core SDK またはランタイムのバージョンを指定します。

バージョンを指定するには、次の形式を使用します。

• 2.x: メジャー バージョンの最新バージョンをインストールします。
• 2.2.x: メジャー バージョンとマイナー バージョンの最新バージョンをインストールします。
• 2.2.104: 正確なバージョンをインストールします。

リリース インデックス ファイルで SDK/ランタイムをインストールするための の値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、クラシック ビルド、クラシック リリース
上で実行	エージェント、DeploymentGroup
確認要求	なし
Capabilities	このタスクの実行は、同じジョブ内の後続のタスクに対する次の 要求 を満たします: DotNetCore
コマンドの制限	Any
設定可能な変数	Any
エージェントのバージョン	サポートされているすべてのエージェント バージョン。
タスクのカテゴリ	ツール