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.

Syntax

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

Indata

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.

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.

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.

Anteckning

Du kan använda uppslagsinställningen performMultiLevelLookupför flera nivåer för att konfigurera hur .NET-värden söker efter versioner.

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.

Anteckning

performMultiLevelLookup gäller endast för Windows-baserade agenter.

Alternativ för aktivitetskontroll

Alla aktiviteter har kontrollalternativ utöver sina uppgiftsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Inga.

Kommentarer

Aktiviteten Använd .NET Core hämtar en specifik version av .NET Core från Internet eller verktygscacheminnet och lägger till den i PATH för Azure Pipelines-agenten (värdbaserad eller privat). Använd den här uppgiften om du vill ändra den version av .NET Core som används i efterföljande uppgifter som DotNetCoreCLI@2. Om du lägger till den här uppgiften innan DotNetCoreCLI@2 i en versionsdefinition ser du till att versionen blir tillgänglig när du skapar, testar och publicerar din app.

Med metoden för verktygsinstallation kan du också frikoppla från agentuppdateringscyklerna. Om den .NET Core-version du letar efter saknas i Azure Pipelines-agenten (värdbaserad eller privat) kan du använda den här uppgiften för att få rätt version installerad på agenten.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
Krav	Ingen
Funktioner	Om du kör den här uppgiften uppfyller du följande krav för efterföljande uppgifter i samma jobb: DotNetCore
Kommandobegränsningar	Valfri
Inställningsbara variabler	Valfri
Agentversion	2.144.0 eller senare
Uppgiftskategori	Verktyg