UseDotNet@2 - Dotnet v2-taak gebruiken

Gebruik deze taak om een specifieke versie van de .NET Core SDK van internet of de lokale cache te verkrijgen en toe te voegen aan het PAD. Gebruik deze taak om de versie van .NET Core te wijzigen die in volgende taken wordt gebruikt. Deze taak biedt ook proxyondersteuning.

Syntaxis

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

Ingangen

packageType - pakket voor het installeren van
string. Toegestane waarden: runtime, sdk (SDK (bevat runtime)). Standaardwaarde: sdk.

Hiermee geeft u op of alleen de .NET-runtime of de SDK moet worden geïnstalleerd.

useGlobalJson - Algemene json- gebruiken
boolean. Facultatief. Gebruiken wanneer packageType = sdk. Standaardwaarde: false.

Installeert alle SDK's uit global.json bestanden. Deze bestanden worden doorzocht vanuit system.DefaultWorkingDirectory. U kunt het zoekhoofdpad wijzigen door de invoer van de werkmap in te stellen.

De 6.x- en 6.1.x-indeling (met behulp van .x als jokerteken) die in de UseDotNet@2.version-invoer wordt beschreven, is bedoeld voor gebruik in de version invoer in de taak, niet de parameter sdk.version in global.json.

Als u een foutbericht ontvangt zoals ##[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. en u global.jsongebruikt, controleert u de sdk.version in uw global.json.

Zie Selecteer de .NET-versie die u wilt gebruikenvoor meer informatie over global.json.

workingDirectory - werkmap
string. Facultatief. Gebruiken wanneer useGlobalJson = true.

Hiermee geeft u het pad van waar global.json bestanden moeten worden doorzocht bij gebruik van useGlobalJson. Als de waarde leeg is, wordt system.DefaultWorkingDirectory beschouwd als het hoofdpad.

version - versie
string. Facultatief. Gebruiken wanneer useGlobalJson = false || packageType = runtime.

Hiermee geeft u de versie van de .NET Core SDK of runtime die moet worden geïnstalleerd. De indelingen voor versiewaarden worden weergegeven met voorbeelden:

• 2.x: installeert de nieuwste SDK of runtime met de opgegeven primaire versie, 2.
• 3.1.x: installeert de nieuwste SDK of runtime met de opgegeven primaire en secundaire versies, 3 en 1.
• 3.1.402: installeert de opgegeven SDK- of runtimeversie, 3.1.402.

De versiewaarden voor SDK- of runtime-installaties bevinden zich in het releases.json-bestand. De koppeling naar de releases.json van een primaire/secundaire versie bevindt zich in het bestand releases-index. Bijvoorbeeld de koppeling naar het releases.json-bestand voor versie 3.1.

vsVersion - compatibele Visual Studio-versie
string.

Hiermee geeft u een compatibele Visual Studio-versie op voor een bijbehorende .NET Core SDK-installatie. De waarde moet een volledig versienummer zijn, zoals 16.6.4, dat een primaire versie, een secundaire versie en een patchnummer bevat.

De versiewaarden voor SDK- of runtime-installaties, die worden gebruikt voor de version tekenreeks, bevinden zich in het releases.json bestand. De koppeling naar de releases.json van een primaire/secundaire versie bevindt zich in het bestand releases-index. Bijvoorbeeld de koppeling naar het releases.json-bestand voor versie 3.1.

includePreviewVersions - Preview-versies opnemen
boolean. Facultatief. Gebruiken wanneer useGlobalJson = false || packageType = runtime. Standaardwaarde: false.

Als deze optie is ingesteld op true, bevat preview-versies wanneer de taak zoekt naar de nieuwste runtime-/SDK-versies, zoals zoeken naar 2.2.x of 3.1.x. Deze instelling wordt genegeerd als u een exacte versie opgeeft, zoals 3.0.100-preview3-010431.

installationPath - pad voor het installeren van .Net Core-
string. Standaardwaarde: $(Agent.ToolsDirectory)/dotnet.

Hiermee geeft u op waar de .NET Core SDK/Runtime moet worden geïnstalleerd. Verschillende paden kunnen de volgende gevolgen hebben voor . Het gedrag van NET.

• $(Agent.ToolsDirectory): Met dit pad wordt de installatie op de agent in de cache opgeslagen, omdat deze map niet wordt opgeschoond in pijplijnen. Alle pijplijnen die op de agent worden uitgevoerd, hebben toegang tot de eerder geïnstalleerde versies.
• $(Agent.TempDirectory): Met dit pad zorgt u ervoor dat een pijplijn geen cacheversie van .NET Core gebruikt, omdat deze map na elke pijplijn wordt opgeschoond.
• een ander pad: u kunt elk pad gebruiken als het agentproces toegang heeft tot het pad. Hiermee wijzigt u de status van de machine en heeft dit invloed op alle processen die erop worden uitgevoerd.

Notitie

U kunt de instelling zoeken op meerdere niveaus gebruiken, performMultiLevelLookup, om te configureren hoe de .NET-host naar versies zoekt.

performMultiLevelLookup - opzoeken op meerdere niveaus uitvoeren
boolean. Standaardwaarde: false.

Hiermee configureert u het gedrag van het .NET-hostproces wanneer wordt gezocht naar een geschikt gedeeld framework. De waarden zijn:

• false: het hostproces zoekt alleen naar versies die aanwezig zijn in de map die is opgegeven door de taak.
• true: het hostproces zoekt in vooraf gedefinieerde globale locaties met behulp van zoekacties op meerdere niveaus. De standaard algemene locaties zijn:
  • C:\Program Files\dotnet (64-bits processen)
  • C:\Program Files (x86)\dotnet (32-bits processen)

Meer informatie over sharedFX-zoekactie op meerdere niveaus.

Notitie

performMultiLevelLookup is alleen van toepassing op Windows-agents.

requestTimeout - Time-out voor pakketdownloadaanvraag instellen
string. Standaardwaarde: 300000.

Geef een time-outwaarde op voor HTTP-aanvragen die door de taak worden uitgevoerd om het .NET-pakket te verkrijgen. De waarde is in milliseconden. De standaardwaarde is 300000 milliseconden (5 minuten). Kan niet meer dan 600000 milliseconden (10 minuten) zijn.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

De .NET Core-taak .NET Core gebruikt een specifieke versie van .NET Core- van internet of de cache van hulpprogramma's en voegt deze toe aan het PAD van de Azure Pipelines-agent (gehost of privé). Gebruik deze taak om de versie van .NET Core te wijzigen die wordt gebruikt in volgende taken, zoals DotNetCoreCLI@2. Als u deze taak toevoegt vóór de DotNetCoreCLI@2 in een builddefinitie, zorgt u ervoor dat de versie beschikbaar is op het moment dat uw app wordt gebouwd, getest en gepubliceerd.

Met de methode voor het installatieprogramma van het hulpprogramma kunt u ook loskoppelen van de updatecycli van de agent. Als de .NET Core-versie die u zoekt ontbreekt in de Azure Pipelines-agent (gehost of privé), kunt u deze taak gebruiken om de juiste versie op de agent te installeren.

Eisen

Eis	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Geen
mogelijkheden	Het uitvoeren van deze taak voldoet aan de volgende vereist voor eventuele volgende taken in dezelfde taak: DotNetCore
opdrachtbeperkingen	Enig
variabelen instellen	Enig
Agentversie	2.144.0 of hoger
Taakcategorie	Werktuig