UseDotNet@2: uso de la tarea dotnet v2

Utiliza esta tarea para adquirir una versión específica del .NET Core SDK desde la internet o la caché local y añádela a la PATH. Utiliza esta tarea para cambiar la versión de .NET Core que se usa en tareas posteriores. Esta tarea también proporciona compatibilidad con 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.

Paquete para instalar
. Valores permitidos: , (SDK (contiene tiempo de ejecución). Valor predeterminado: .

Especifica si instalar solo el runtime .NET o el SDK.

Uso de json global
. Opcional. Use cuando . Valor predeterminado: .

Instala todos los SDK desde archivos. Estos archivos se buscan desde . Puede cambiar la ruta de acceso raíz de búsqueda estableciendo la entrada del directorio de trabajo.

El formato y (con como carácter comodín) descrito en la entrada se usa en la entrada de la tarea, no en el parámetro de .

Si recibe un mensaje de error como y usa , compruebe el en el .

Para más información sobre global.json, consulta Selecciona la versión .NET que vas a usar.

de directorio de trabajo de
. Opcional. Use cuando .

Especifica la ruta de acceso desde donde se deben buscar archivos al usar . Si el valor está vacío, se considerará como la ruta de acceso raíz.

versión
. Opcional. Use cuando .

Especifica la versión del SDK .NET Core o el tiempo de ejecución a instalar. Los formatos de valor de versión se muestran con ejemplos:

• : instala el SDK o el entorno de ejecución más recientes con la versión principal especificada, .
• : instala el SDK o el entorno de ejecución más recientes con las versiones principales y secundarias especificadas, y .
• : instala el SDK o la versión del entorno de ejecución especificados, .

Los valores de versión de las instalaciones del SDK o del entorno de ejecución se encuentran en el archivo . El vínculo a la de una versión principal o secundaria se encuentra en el archivo releases-index. Por ejemplo, el vínculo al archivo releases.json de la versión 3.1.

vsVersion - Compatible Visual Studio versión
.

Especifica una versión compatible de Visual Studio para una instalación correspondiente del SDK .NET Core. El valor debe ser un número de versión completo, como , que contiene una versión principal, una versión secundaria y un número de revisión.

Los valores de versión de las instalaciones del SDK o del entorno de ejecución, que se usan para la cadena de , se encuentran en el archivo . El vínculo a la de una versión principal o secundaria se encuentra en el archivo releases-index. Por ejemplo, el vínculo al archivo releases.json de la versión 3.1.

Comprueba si hay instalaciones existentes
. Valor predeterminado: .

Selecciona si quieres detectar si la versión especificada ya está instalada antes de intentar descargarla. Úsalo solo cuando installationPath esté vacío, es decir, se ponga en valor por defecto.

incluir versiones preliminares
. Opcional. Use cuando . Valor predeterminado: .

Si se establece en , incluye versiones preliminares cuando la tarea busca versiones más recientes del entorno de ejecución o del SDK, como buscar o . Esta configuración se omite si especifica una versión exacta, como .

ruta de acceso para instalar de .Net Core
. Valor predeterminado: .

Especifica dónde debe instalarse el SDK/Runtime Core de .NET. Diferentes caminos pueden tener el siguiente impacto en el comportamiento de .NET.

• : el uso de esta ruta de acceso almacena en caché la instalación en el agente, ya que este directorio no se limpia entre canalizaciones. Todas las canalizaciones que se ejecutan en el agente tienen acceso a las versiones instaladas anteriormente.
• $(Agent.TempDirectory): Usar esta ruta asegura que una pipeline no utilice una versión en caché de .NET Core, ya que esta carpeta se limpia tras cada pipeline.
• Otra ruta de acceso: puede usar cualquier ruta de acceso si el proceso del agente tiene acceso a la ruta de acceso. Esto cambiará el estado de la máquina y afectará a todos los procesos que se ejecutan en ella.

Realizar búsqueda de varios niveles
. Valor predeterminado: .

Configura el comportamiento del proceso host .NET cuando busca un framework compartido adecuado. Los valores son:

• : el proceso de host solo busca versiones presentes en la carpeta especificada por la tarea.
• : el proceso de host buscará en ubicaciones globales predefinidas mediante la búsqueda de varios niveles. Las ubicaciones globales predeterminadas son:
  • (procesos de 64 bits)
  • (procesos de 32 bits)

Obtenga más información sobre búsqueda de SharedFX de varios niveles.

Establecer el tiempo de espera de la solicitud de descarga de paquetes
. Valor predeterminado: .

Proporciona un valor de tiempo de espera para las solicitudes HTTP que realiza la tarea para obtener el paquete .NET. El valor está en milisegundos. El valor predeterminado es 300000 milisegundos (5 minutos). No puede tener más de 600000 milisegundos (10 minutos).

Ninguno.