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.

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

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

Algemene json- gebruiken
. Facultatief. Gebruiken wanneer . Standaardwaarde: .

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

De - en -indeling (met behulp van als jokerteken) die in de -invoer wordt beschreven, is bedoeld voor gebruik in de invoer in de taak, niet de parameter in .

Als u een foutbericht ontvangt zoals en u gebruikt, controleert u de in uw .

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

werkmap
. Facultatief. Gebruiken wanneer .

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

versie
. Facultatief. Gebruiken wanneer .

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

• : installeert de nieuwste SDK of runtime met de opgegeven primaire versie, .
• : installeert de nieuwste SDK of runtime met de opgegeven primaire en secundaire versies, en .
• : installeert de opgegeven SDK- of runtimeversie, .

De versiewaarden voor SDK- of runtime-installaties bevinden zich in het -bestand. De koppeling naar de 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
.

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

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

Controleer op bestaande installaties
. Standaardwaarde: .

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.

Preview-versies opnemen
. Facultatief. Gebruiken wanneer . Standaardwaarde: .

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

pad voor het installeren van .Net Core-
. Standaardwaarde: .

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

• : 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): 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: 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.

opzoeken op meerdere niveaus uitvoeren
. Standaardwaarde: .

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

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

Meer informatie over sharedFX-zoekactie op meerdere niveaus.

Time-out voor pakketdownloadaanvraag instellen
. Standaardwaarde: .

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.