UseDotNet@2 – Använda 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ägga 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.
    #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.

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

packageType - paket för att installera
string. Tillåtna värden: runtime, sdk (SDK (innehåller körning)). Standardvärde: sdk.

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

useGlobalJson - Använd global json-
boolean. Valfri. 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ökvägen till sökroten genom att ange arbetskatalogindata.

Formatet 6.x och 6.1.x (med .x som jokertecken) som beskrivs i UseDotNet@2.version indata används 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 du sdk.version i global.json.

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

workingDirectory - Arbetskatalog
string. Valfri. 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 betraktas system.DefaultWorkingDirectory som rotsökväg.

version - version
string. Valfri. 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:t eller körningen med angivna större och mindre versioner, 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 filen releases.json. Länken till releases.json för en större/mindre version 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 16.6.4, som innehåller en huvudversion, en delversion och ett korrigeringsnummer.

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

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

Om värdet är inställt på true, innehåller förhandsversioner när uppgiften söker efter de senaste versionerna av runtime/SDK, till exempel sökning efter 2.2.x 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): Om du använder den här sökvägen cachelagras installationen på agenten, eftersom den här katalogen inte rensas mellan pipelines. Alla pipelines som körs på agenten har åtkomst till de tidigare installerade versionerna.
• $(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 uppslag 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 uppslag 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.

requestTimeout - Ange tidsgräns för pakethämtningsbegäran
string. Standardvärde: 300000.

Ange ett timeout-värde för HTTP-begäranden som aktiviteten gör för att hämta .NET-paketet. Värdet är i millisekunder. Standardvärdet är 300000 millisekunder (5 minuter). Får inte vara mer än 600 000 millisekunder (10 minuter).

Ingen.