UseDotNet@2 - Dotnet v2-taak gebruiken

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

# 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.
    #checkForExistingVersion: false # boolean. Check for existing installation. Default: false.
    #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.
    #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.

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

Geeft aan of alleen de .NET runtime of de SDK geïnstalleerd moet worden.

useGlobalJson - Gebruik globale json
boolean. Facultatief. Gebruiken wanneer packageType = sdk. Standaardwaarde: false.

Installeert alle SDK's vanuit 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 taak leest ook de sdk.rollForward eigenschap uit global.json en installeert de nieuwste versie die voldoet aan het gespecificeerde roll-forward-beleid. Als je global.json bijvoorbeeld specificeert "version": "8.0.302" met "rollForward": "latestFeature", installeert de taak de nieuwste 8.0.x SDK in plaats van de exacte versie. Als sdk.rollForward niet aanwezig is, installeert de taak de exacte versie die in sdk.versionis gespecificeerd, die overeenkomt met het vorige gedrag. Voor meer informatie over ondersteunde rollForward waarden, zie de sectie Opmerkingen en het overzicht van deglobal.json.

Het en-formaat 6.1.x (met als .x wildcard) beschreven in de UseDotNet@2.version invoer is bedoeld voor gebruik in de version invoer van de taak, niet voor de sdk.version parameter in global.json.6.x

Als je een foutmelding 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 je gebruikt global.json, controleer dan de sdk.version in je global.json.

Voor meer informatie over global.json, zie Selecteer de .NET versie die gebruikt moet worden.

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

Specificeert het pad vanwaar global.json bestanden moeten worden doorzocht bij gebruik useGlobalJsonvan . Als de waarde leeg is, system.DefaultWorkingDirectory wordt beschouwd als het wortelpad.

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

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

• 2.x: Installeert de nieuwste SDK of runtime met de opgegeven hoofdversie, 2.
• 3.1.x: Installeert de nieuwste SDK of runtime met de opgegeven hoofd- en kleine versies, 3 en 1.
• 3.1.402: Installeert de gespecificeerde SDK of runtime-versie, 3.1.402.

De versiewaarden voor SDK- of runtime-installaties staan in het releases.json bestand. De link naar de van releases.json een hoofd-/minorversie bevindt zich in het releases-indexbestand . Bijvoorbeeld de link naar het releases.json-bestand voor versie 3.1.

vsVersion - Compatibele Visual Studio versie
string.

Specificeert een compatibele Visual Studio-versie voor een bijbehorende .NET Core SDK-installatie. De waarde moet een volledig versienummer zijn, zoals 16.6.4, dat een hoofdversie, een kleine versie en een patchnummer bevat.

De versiewaarden voor SDK- of runtime-installaties, die voor de version string worden gebruikt, staan in het releases.json bestand. De link naar de van releases.json een hoofd-/minorversie bevindt zich in het releases-indexbestand . Bijvoorbeeld de link naar het releases.json-bestand voor versie 3.1.

checkForExistingVersion - Controleer op bestaande installaties
boolean. Standaardwaarde: false.

Selecteer of je wilt ontdekken of de gespecificeerde versie al geïnstalleerd is voordat je probeert te downloaden. Gebruik alleen wanneer installationPath leeg is, dat wil zeggen ingesteld op standaardwaarde.

includePreviewVersions - Voeg previewversies toe
boolean. Facultatief. Gebruiken wanneer useGlobalJson = false || packageType = runtime. Standaardwaarde: false.

Als ingesteld op true, omvat voorbeeldversies 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 je een exacte versie specificeert, zoals 3.0.100-preview3-010431.

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

Geeft aan waar de .NET Core SDK/Runtime geïnstalleerd moet worden. Verschillende paden kunnen de volgende impact hebben op het gedrag van .NET.

• $(Agent.ToolsDirectory): Door dit pad te gebruiken cachet de installatie op de agent, omdat deze map niet wordt opgeschoond over de pijplijnen. Alle pijplijnen die op de agent worden uitgevoerd, hebben toegang tot de eerder geïnstalleerde versies.
• $(Agent.TempDirectory): Door dit pad te gebruiken, wordt ervoor gezorgd dat een pipeline geen gecachte versie van .NET Core gebruikt, omdat deze map na elke pipeline wordt opgeschoond.
• Een ander pad: je 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.

performMultiLevelLookup - Voer Multi-Level lookup uit
boolean. Standaardwaarde: false.

Configureert het gedrag van het .NET-hostproces wanneer het zoekt naar een geschikt gedeeld framework. De waarden zijn:

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

Lees meer over multi-level SharedFX-zoekopdrachten.

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

Geef een timeoutwaarde voor HTTP-verzoeken die de taak doet 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.

Geen.