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

このタスクを使って、internetまたはローカルキャッシュから.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.
    #requestTimeout: '300000' # string. Set timeout for package download request. Default: 300000.
  # Advanced
    #vsVersion: # string. Compatible Visual Studio version. 
    #checkForExistingVersion: false # boolean. Check for existing installation. Default: false.
    #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.
    #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.

パッケージを して をインストールする
。 使用できる値: 、 (SDK (ランタイムを含む))。 既定値: .

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

グローバル json を使用する
。 随意。 するときに使用します。 既定値: .

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

入力で説明されている 形式と 形式 (ワイルドカードとして を使用) は、の パラメーターではなく、タスクの 入力で使用されます。

のようなエラー メッセージが表示され、を使用している場合は、の を確認します。

global.jsonの詳細については、Use .NETバージョンを選択する」をご覧ください。

作業ディレクトリの
。 随意。 するときに使用します。

を使用するときに ファイルを検索するパスを指定します。 値が空の場合、 はルート パスと見なされます。

バージョン
。 随意。 するときに使用します。

インストールすべき.NET Core SDKのバージョンやランタイムを指定します。 バージョン値の形式は、次の例で示されています。

• : 指定したメジャー バージョンの最新の SDK またはランタイムをインストール 。
• : 指定されたメジャー バージョンとマイナー バージョン、、を使用して、最新の SDK またはランタイムをインストールします。
• : 指定した SDK またはランタイム バージョンをインストール 。

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

vsVersion - 互換Visual Studioバージョン
。

対応する.NET Core SDKインストールに対応する互換性のあるVisual Studioバージョンを指定します。 値は、メジャー バージョン、マイナー バージョン、パッチ番号を含む などの完全なバージョン番号である必要があります。

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

既存の設置状況を確認してください
。 既定値: .

ダウンロードを試みる前に指定されたバージョンが既にインストールされているかどうかを検出したい場合を選択してください。 installationPathがEmpty、つまりデフォルト値に設定されている時のみ使用してください。

プレビュー バージョンを含める
。 随意。 するときに使用します。 既定値: .

に設定すると、タスクが最新のランタイム/SDK バージョン ( や の検索など) を検索するときのプレビュー バージョンが含まれます。 など、正確なバージョンを指定した場合、この設定は無視されます。

.Net Core をインストールするための パス
。 既定値: .

.NET Core SDK/ランタイムをどこにインストールすべきかを指定します。 異なる経路が.NETの挙動に以下のような影響を与えることがあります。

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

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

適切な共有フレームワークを探索する際に.NETホストプロセスの挙動を設定します。 値は次のとおりです。

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

複数レベルの SharedFX ルックアップの詳細を確認します。

パッケージダウンロード要求 のタイムアウトを設定する
。 既定値: .

タスクが.NETパッケージを取得するために行うHTTPリクエストに対してタイムアウト値を指定します。 値はミリ秒単位です。 既定値は 300000 ミリ秒 (5 分) です。 600000 ミリ秒 (10 分) を超えることはできません。

何一つ。