UseDotNet@2 - Usare l'attività dotnet v2

Usa questo compito per acquisire una versione specifica del .NET Core SDK dall'internet o dalla cache locale e aggiungerla al PATH. Usa questo compito per cambiare la versione di .NET Core che viene utilizzata nei compiti successivi. Questa attività fornisce anche il supporto proxy.

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

pacchetto per installare
. Valori consentiti: , (SDK (contiene runtime)). Valore predefinito: .

Specifica se installare solo il runtime .NET o l'SDK.

Usare json globale
. Opzionale. Usare quando . Valore predefinito: .

Installa tutti gli SDK da file. Questi file vengono cercati da . È possibile modificare il percorso radice di ricerca impostando l'input della directory di lavoro.

Il formato e (usando come carattere jolly) descritto nell'input è da usare nell'input nell'attività, non nel parametro in .

Se viene visualizzato un messaggio di errore come e si usa , controllare il nel .

Per maggiori informazioni su global.json, vedi Seleziona la versione .NET da utilizzare.

directory di lavoro
. Opzionale. Usare quando .

Specifica il percorso da cui eseguire la ricerca dei file quando si usa . Se il valore è vuoto, verrà considerato come percorso radice.

versione
. Opzionale. Usare quando .

Specifica la versione o runtime dell'SDK Core .NET da installare. I formati dei valori di versione vengono visualizzati con esempi:

• : installa l'SDK o il runtime più recente con la versione principale specificata, .
• : installa l'SDK o il runtime più recenti con le versioni principali e secondarie specificate, e .
• : installa l'SDK o la versione di runtime specificata, .

I valori della versione per le installazioni SDK o runtime si trovano nel file . Il collegamento alla di una versione principale/secondaria si trova nel file release-index . Ad esempio, il collegamento al file releases.json per la versione 3.1.

vsVersion - Versione Visual Studio compatibile
.

Specifica una versione compatibile di Visual Studio per una corrispondente installazione .NET Core SDK. Il valore deve essere un numero di versione completo, ad esempio , che contiene una versione principale, una versione secondaria e un numero di patch.

I valori della versione per le installazioni SDK o runtime, usati per la stringa , si trovano nel file . Il collegamento alla di una versione principale/secondaria si trova nel file release-index . Ad esempio, il collegamento al file releases.json per la versione 3.1.

Controlla l'installazione esistente
. Valore predefinito: .

Seleziona se vuoi rilevare se la versione specificata è già installata prima di tentare di scaricare. Usa solo quando installationPath è vuoto, cioè impostato al valore predefinito.

includi versioni di anteprima
. Opzionale. Usare quando . Valore predefinito: .

Se impostato su , include le versioni di anteprima quando l'attività cerca le versioni più recenti di runtime/SDK, ad esempio la ricerca di o . Questa impostazione viene ignorata se si specifica una versione esatta, ad esempio .

percorso per installare .Net Core
. Valore predefinito: .

Specifica dove deve essere installato il .NET Core SDK/runtime. Percorsi diversi possono avere il seguente impatto sul comportamento di .NET.

• : l'uso di questo percorso memorizza nella cache l'installazione nell'agente, perché questa directory non viene pulita tra le pipeline. Tutte le pipeline in esecuzione nell'agente hanno accesso alle versioni installate in precedenza.
• $(Agent.TempDirectory): Utilizzare questo percorso garantisce che una pipeline non utilizzi una versione cachedata di .NET Core, poiché questa cartella viene pulita dopo ogni pipeline.
• Un altro percorso: è possibile usare qualsiasi percorso se il processo dell'agente ha accesso al percorso. Questo modificherà lo stato del computer e influirà su tutti i processi in esecuzione su di esso.

eseguire di ricerca a più livelli
. Valore predefinito: .

Configura il comportamento del processo host .NET quando cerca un framework condiviso adatto. I valori sono:

• : il processo host cerca solo le versioni presenti nella cartella specificata dall'attività.
• : il processo host cercherà in posizioni globali predefinite usando la ricerca a più livelli. Le posizioni globali predefinite sono:
  • (processi a 64 bit)
  • (processi a 32 bit)

Altre informazioni su ricerca SharedFX a più livelli.

Impostare il timeout per la richiesta di download del pacchetto
. Valore predefinito: .

Fornire un valore di timeout per le richieste HTTP effettuate dal compito per ottenere il pacchetto .NET. Il valore è espresso in millisecondi. Il valore predefinito è 300000 millisecondi (5 minuti). Non può essere superiore a 600000 millisecondi (10 minuti).

Nessuno.