UseDotNet@2 – Använd dotnet v2-uppgift

Använd den här uppgiften för att hämta en specifik version av .NET Core SDK från Internet eller den lokala cachen och lägg till den i PATH. Använd den här uppgiften om du vill ändra den version av .NET Core som används i efterföljande uppgifter. Den här uppgiften ger också proxystöd.

# 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.

# 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
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.

# Use dotnet 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.
    #version: # string. Version. 
    #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 - Paket som ska installeras
string. Tillåtna värden: runtime, sdk (SDK (innehåller körning)). Standardvärde: sdk.

Anger om du bara vill installera .NET-körningen eller SDK:t.

useGlobalJson - Använda global json
boolean. Valfritt. Använd när packageType = sdk. Standardvärde: false.

Installerar alla SDK:er från global.json filer. Dessa filer genomsöks från system.DefaultWorkingDirectory. Du kan ändra sökrotsökvägen genom att ange arbetskatalogens indata.

Formatet 6.x och 6.1.x (som använder .x som jokertecken) som beskrivs i UseDotNet@2.version indata är för användning i version indata i aktiviteten, inte parametern sdk.version i global.json.

Om du får ett felmeddelande som ##[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. och du använder global.jsonkontrollerar sdk.version du i din global.json.

Mer information om global.jsonfinns i Välj den .NET-version som ska användas.

workingDirectory - Arbetskatalog
string. Valfritt. Använd när useGlobalJson = true.

Anger sökvägen där global.json filer ska sökas efter när du använder useGlobalJson. Om värdet är tomt system.DefaultWorkingDirectory betraktas det som rotsökvägen.

version - Version
string. Valfritt. Använd när useGlobalJson = false || packageType = runtime.

Anger vilken version av .NET Core SDK eller körning som ska installeras. Versionsvärdeformaten visas med exempel:

• 2.x: Installerar den senaste SDK:t eller körningen med den angivna huvudversionen. 2
• 3.1.x: Installerar den senaste SDK:en eller körningen med angivna huvudversioner och delversioner, 3 och 1.
• 3.1.402: Installerar angiven SDK eller körningsversion, 3.1.402.

Versionsvärdena för SDK eller körningsinstallationer finns i releases.json filen. Länken till en releases.json större/delversion finns i filen releases-index . Till exempel länken till filen releases.json för version 3.1.

version - Version
string.

Anger vilken version av .NET Core SDK eller körning som ska installeras. Versionsvärdeformaten visas med exempel:

• 2.x: Installerar den senaste SDK:t eller körningen med den angivna huvudversionen. 2
• 3.1.x: Installerar den senaste SDK:en eller körningen med angivna huvudversioner och delversioner, 3 och 1.
• 3.1.402: Installerar angiven SDK eller körningsversion, 3.1.402.

Versionsvärdena för SDK eller körningsinstallationer finns i releases.json filen. Länken till en releases.json större/delversion finns i filen releases-index . Till exempel länken till filen releases.json för version 3.1.

vsVersion - Kompatibel Visual Studio-version
string.

Anger en kompatibel Visual Studio-version för en motsvarande .NET Core SDK-installation. Värdet måste vara ett fullständigt versionsnummer, till exempel , som 16.6.4innehåller en huvudversion, en delversion och ett korrigeringsnummer.

Versionsvärdena för SDK eller körningsinstallationer, som används för strängen version , finns i releases.json filen. Länken till en releases.json större/delversion finns i filen releases-index . Till exempel länken till filen releases.json för version 3.1.

includePreviewVersions - Inkludera förhandsversioner
boolean. Valfritt. Använd när useGlobalJson = false || packageType = runtime. Standardvärde: false.

Om värdet är true, innehåller förhandsgranskningsversioner när aktiviteten söker efter de senaste runtime-/SDK-versionerna, till exempel sökning 2.2.x efter eller 3.1.x. Den här inställningen ignoreras om du anger en exakt version, till exempel 3.0.100-preview3-010431.

includePreviewVersions - Inkludera förhandsversioner
boolean. Standardvärde: false.

Om värdet är true, innehåller förhandsgranskningsversioner när aktiviteten söker efter de senaste runtime-/SDK-versionerna, till exempel sökning 2.2.x efter eller 3.1.x. Den här inställningen ignoreras om du anger en exakt version, till exempel 3.0.100-preview3-010431.

installationPath - Sökväg för att installera .Net Core
string. Standardvärde: $(Agent.ToolsDirectory)/dotnet.

Anger var .NET Core SDK/Runtime ska installeras. Olika sökvägar kan ha följande inverkan på . NET:s beteende.

• $(Agent.ToolsDirectory): Med den här sökvägen cachelagras installationen på agenten, eftersom den här katalogen inte rensas över pipelines. Alla pipelines som körs på agenten har åtkomst till tidigare installerade versioner.
• $(Agent.TempDirectory): Om du använder den här sökvägen ser du till att en pipeline inte använder en cachelagrad version av .NET Core, eftersom den här mappen rensas efter varje pipeline.
• En annan sökväg: Du kan använda valfri sökväg om agentprocessen har åtkomst till sökvägen. Detta ändrar datorns tillstånd och påverkar alla processer som körs på den.

performMultiLevelLookup - Utföra sökning på flera nivåer
boolean. Standardvärde: false.

Konfigurerar beteendet för .NET-värdprocessen när den söker efter ett lämpligt delat ramverk. Värdena är:

• false: Värdprocessen söker bara efter versioner som finns i mappen som anges av uppgiften.
• true: Värdprocessen söker på fördefinierade globala platser med hjälp av sökning på flera nivåer. De globala standardplatserna är:
  • C:\Program Files\dotnet (64-bitarsprocesser)
  • C:\Program Files (x86)\dotnet (32-bitarsprocesser)

Läs mer om SharedFX-sökning på flera nivåer.

Inga.