UseDotNet@2 - dotnet v2 タスクを使用する

このタスクを使用して、インターネットまたはローカル キャッシュから特定のバージョンの .NET Core SDK を取得し、PATH に追加します。 このタスクを使用して、後続のタスクで使用される .NET Core のバージョンを変更します。 このタスクでは、プロキシのサポートも提供されます。

構文

# 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. 使用できる値は 、 runtimesdk (SDK (ランタイムを含む))。 既定値: sdk。

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

useGlobalJson - グローバル json を使用する
boolean. 省略可能。 の場合は packageType = sdkを使用します。 既定値: false。

ファイルから global.json すべての SDK をインストールします。 これらのファイルは から system.DefaultWorkingDirectory検索されます。 作業ディレクトリ入力を設定することで、検索ルート パスを変更できます。

6.x入力でUseDotNet@2.version説明されている と 6.1.x の形式 (ワイルドカードとして使用.x) は、 の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している場合は、 sdk.version を確認します global.json。

の 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: 指定したメジャー バージョンとマイナー バージョンと を使用して、 31最新の 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パッチ番号を含む など、完全なバージョン番号である必要があります。

文字列に使用 version される SDK またはランタイム インストールのバージョン値は、 ファイルにあります releases.json 。 メジャー/マイナー バージョンの への releases.json リンクは、 releases-index ファイルにあります。 たとえば、 バージョン 3.1 の releases.json ファイルへのリンクです。

includePreviewVersions - プレビュー バージョンを含める
boolean. 省略可能。 の場合は useGlobalJson = false || packageType = runtimeを使用します。 既定値: false。

に設定されているtrue場合は、 や 3.1.xの検索など、タスクが最新のランタイム/SDK バージョンを検索2.2.xするときにプレビュー バージョンが含まれます。 など、正確なバージョンを指定した場合、 3.0.100-preview3-010431この設定は無視されます。

installationPath - インストール.Net Coreのパス
string. 既定値: $(Agent.ToolsDirectory)/dotnet。

.NET Core SDK/Runtime をインストールする場所を指定します。 異なるパスは、 に次の影響を与える可能性があります。NET の動作。

• $(Agent.ToolsDirectory): このパスを使用すると、このディレクトリはパイプライン間でクリーンアップされないため、エージェントへのインストールがキャッシュされます。 エージェントで実行されているすべてのパイプラインは、以前にインストールされたバージョンにアクセスできます。
• $(Agent.TempDirectory): このパスを使用すると、パイプラインの後にこのフォルダーがクリーンアップされるため、パイプラインでキャッシュされたバージョンの .NET Core が使用されないようにします。
• 別のパス: エージェント プロセスがパスにアクセスできる場合は、任意のパスを使用できます。 これにより、マシンの状態が変更され、マシン上で実行されているすべてのプロセスに影響します。

Note

[複数レベルの参照] 設定を使用して、performMultiLevelLookup.NET ホストがバージョンを検索する方法を構成できます。

performMultiLevelLookup - 複数レベルの参照を実行する
boolean. 既定値: false。

適切な共有フレームワークを検索するときの .NET ホスト プロセスの動作を構成します。 値は次のとおりです。

• false: ホスト プロセスは、タスクで指定されたフォルダーに存在するバージョンのみを検索します。
• true: ホスト プロセスは、複数レベルの検索を使用して、定義済みのグローバルな場所で検索します。 既定のグローバルな場所は次のとおりです。
  • C:\Program Files\dotnet (64 ビット プロセス)
  • C:\Program Files (x86)\dotnet (32 ビット プロセス)

複数レベルの SharedFX 参照の詳細については、こちらを参照してください。

Note

performMultiLevelLookup は、Windows ベースのエージェントにのみ適用されます。

タスク コントロール のオプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。

出力変数

[なし] :

解説

[.NET Core の使用] タスクは、インターネットまたはツール キャッシュから特定のバージョンの .NET Core を取得し、Azure Pipelines エージェント (ホストまたはプライベート) の PATH に追加します。 このタスクを使用して、DotNetCoreCLI@2などの後続のタスクで使用される .NET Core のバージョン を変更します。 ビルド定義で DotNetCoreCLI@2 の前にこのタスクを追加すると、アプリのビルド、テスト、発行時にバージョンを使用できるようになります。

ツール インストーラーアプローチを使用すると、エージェントの更新サイクルから切り離すこともできます。 探している .NET Core バージョンが Azure Pipelines エージェント (Hosted または Private) にない場合は、このタスクを使用して、エージェントに適切なバージョンをインストールできます。

必要条件

要件	説明
パイプラインの種類	YAML、クラシック ビルド、クラシック リリース
実行日	エージェント、DeploymentGroup
確認要求	なし
Capabilities	このタスクを実行すると、同じジョブ内の後続のタスクに対して次の 要求 が満たされます: DotNetCore
コマンドの制限	Any
設定可能な変数	Any
エージェントのバージョン	2.144.0 以上
タスクのカテゴリ	ツール