DotNetCoreInstaller@1 - taak .NET Core SDK/runtime installer v1

Gebruik deze taak om een specifieke versie van de .NET Core SDK op te halen uit de internet- of lokale cache en deze toe te voegen aan het PAD.

Belangrijk

Deze taak is afgeschaft en wordt op 31 januari 2024 buiten gebruik gesteld. Gebruik UseDotNet@2.

Syntax

# .NET Core SDK/runtime installer v1
# Acquire a specific version of the .NET Core SDK from the internet or local cache and add it to the PATH.
- task: DotNetCoreInstaller@1
  inputs:
    packageType: 'sdk' # 'runtime' | 'sdk'. Required. Package to install. Default: sdk.
    version: '2.2.x' # string. Required. Version. Default: 2.2.x.
    #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.

Invoerwaarden

packageType - Pakket om te installeren
string. Vereist. Toegestane waarden: runtime (Alleen Runtime), sdk (SDK (bevat runtime)). Standaardwaarde: sdk.

Hiermee geeft u op of alleen Runtime of de volledige SDK moet worden geïnstalleerd.

version - Versie
string. Vereist. Standaardwaarde: 2.2.x.

Hiermee geeft u de versie van .NET Core SDK of Runtime te installeren.

Gebruik de volgende indeling om de versie op te geven:

• 2.x: installeert de meest recente primaire versie.
• 2.2.x: installeert de meest recente primaire en secundaire versie.
• 2.2.104: Installeert de exacte versie.

Zoek de waarde van voor het installeren van version SDK/Runtime in het bestand releases-index.

includePreviewVersions - Preview-versies opnemen
boolean. Standaardwaarde: false.

Hiermee geeft u op of u preview-versies wilt opnemen tijdens het zoeken naar de nieuwste versies. Deze instelling wordt genegeerd als u een exacte versie opgeeft, zoals 3.0.100-preview3-010431.

installationPath - Pad om .NET Core te installeren
string. Standaardwaarde: $(Agent.ToolsDirectory)/dotnet.

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

• $(Agent.ToolsDirectory): Hiermee bepaalt u de versie die in de cache van de agent moet worden opgeslagen, omdat deze map niet wordt opgeschoond tussen pijplijnen. Alle pijplijnen die op de agent worden uitgevoerd, hebben toegang tot de versies die eerder zijn geïnstalleerd met behulp van de agent.
• $(Agent.TempDirectory): Dit kan ervoor zorgen dat een pijplijn geen cacheversie van .NET Core gebruikt, omdat deze map na elke pijplijn wordt opgeschoond.
• Elk ander pad: u kunt elk ander pad configureren, aangezien het agentproces toegang heeft tot het pad. Dit verandert de status van de machine en heeft invloed op alle processen die erop worden uitgevoerd.

U kunt ook de instelling Opzoeken op meerdere niveaus configureren. Met deze instelling kunt u de .NET-host configureren om te testen op een geschikte versie.

performMultiLevelLookup - Zoekactie met meerdere niveaus uitvoeren
boolean. Standaardwaarde: false.

Deze invoer is alleen van toepassing op Windows-agents. Met deze invoer configureert u het gedrag van .NET-hostprocessen voor het zoeken naar een geschikt gedeeld framework. False betekent dat alleen versies die aanwezig zijn in de map die in deze taak zijn opgegeven, door het hostproces worden bekeken. True betekent dat de host probeert te zoeken op vooraf gedefinieerde globale locaties met behulp van Zoeken op meerdere niveaus.

Voor Windows zijn de algemene standaardlocaties:

• C:\Program Files\dotnet (64-bits processen)
• C:\Program Files (x86)\dotnet (32-bits proces)

Zie SharedFX-lookup op meerdere niveaus voor meer informatie.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Besturingsopties en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

Deze taak is afgeschaft. Gebruik @UseDotNet2.

Wat is er nieuw in deze taakversie?

• Ondersteuning voor het naast elkaar installeren van meerdere versies.
• Ondersteuning voor patronen in versie om de meest recente secundaire/primaire versie op te halen.
• Zoekacties op meerdere niveaus beperken.

Vereisten

Vereiste	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
Eisen	Geen
Functies	Het uitvoeren van deze taak voldoet aan de volgende vereisten voor eventuele volgende taken in dezelfde taak: DotNetCore
Opdrachtbeperkingen	Alle
Instelbare variabelen	Alle
Agentversie	Alle ondersteunde agentversies.
Taakcategorie	Hulpprogramma