このタスクを使用して、インターネットまたはローカル キャッシュから特定のバージョンの .NET Core SDK を取得し、PATH に追加します。
重要
このタスクは非推奨となり、2024 年 1 月 31 日に廃止されます。 UseDotNet@2を使用します。
このタスクを使用して、インターネットまたはローカル キャッシュから特定のバージョンの .NET Core SDK を取得し、PATH に追加します。
重要
このタスクは非推奨です。 @UseDotNet2を使用します。
構文
# .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/Runtime をインストールするための version の値は、releases-index ファイルにあります。
プレビュー バージョンを含める includePreviewVersions -
boolean。 既定値: false.
最新バージョンを検索するときにプレビュー バージョンを含めるかどうかを指定します。
3.0.100-preview3-010431など、正確なバージョンを指定した場合、この設定は無視されます。
.Net Core をインストールするための
string。 既定値: $(Agent.ToolsDirectory)/dotnet.
.NET Core SDK/Runtime をインストールする場所を指定します。 パスが異なると、次のような影響を受けます。NET の動作:
- $(Agent.ToolsDirectory): このディレクトリはパイプライン間でクリーンアップされないため、エージェントにキャッシュされるバージョンが決定されます。 エージェントで実行されているすべてのパイプラインは、エージェントを使用して以前にインストールされたバージョンにアクセスできます。
- $(Agent.TempDirectory): これにより、パイプラインの後にこのフォルダーがクリーンアップされるため、キャッシュされたバージョンの .NET Core がパイプラインで使用されないようにすることができます。
- その他のパス: エージェント プロセスがパスにアクセスできる場合は、他の任意のパスを構成できます。 これにより、マシンの状態が変更され、マシン上で実行されているすべてのプロセスに影響が及びます。
複数レベルのルックアップ設定を構成することもできます。 この設定では、適切なバージョンをプローブするように .NET ホストを構成できます。
複数レベルの参照 を実行する
boolean。 既定値: false.
この入力は、Windows ベースのエージェントにのみ適用されます。 この入力により、適切な共有フレームワークを検索するための .NET ホスト プロセスの動作が構成されます。
False は、このタスクで指定されたフォルダーに存在するバージョンのみがホスト プロセスによって検索されることを意味します。
True は、ホストが複数レベルのルックアップを使用して定義済みのグローバルな場所を検索することを意味します。
Windows の場合、既定のグローバルな場所は次のとおりです。
-
C:\Program Files\dotnet(64 ビット プロセス) -
C:\Program Files (x86)\dotnet(32 ビット プロセス)
詳細については、「マルチレベル SharedFX Lookup」を参照してください。
タスク コントロールのオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。
出力変数
なし。
注釈
このタスクは非推奨です。 @UseDotNet2を使用します。
このタスク バージョンの新機能。
- 複数のバージョンを並べてインストールするためのサポート。
- マイナー/メジャー バージョンで最新のバージョンをフェッチするパターンのサポート。
- 複数レベルの検索を制限します。