Descripción general de dotnetup

Note

dotnetup está en versión preliminar pública. Sus características y comportamiento pueden cambiar antes de la disponibilidad general.

dotnetup es un gestor de cadenas de herramientas multiplataforma para instalaciones de .NET de nivel de usuario. Instala .NET SDK y entornos de ejecución sin escribir en un directorio de .NET administrado por el sistema. También realiza un seguimiento de los requisitos de instalación que seleccione para que el software pueda actualizar o quitar los archivos relacionados más adelante.

Use dotnetup para:

  • Instale versiones estables, preliminares, diarias o exactas de .NET.
  • Mantenga varios requisitos de SDK y entorno de ejecución en una instalación administrada.
  • Instale el SDK requerido por el archivo global.json más cercano.
  • Actualice los canales rastreados sin cambiar los requisitos de versión exacta.
  • Configure la forma en que los terminales y las aplicaciones encuentran el dotnet administrado.
  • Ejecute el elemento administrado dotnet sin cambiar PATH.

Start

Ejecute la configuración interactiva:

> dotnetup init
Welcome to dotnetup!

SDK Channel: latest
Mode: Terminal Mode (Suggested)

Would you like to install .NET with the recommended settings?
> Yes, proceed with defaults and install

Downloading SDK <resolved-version>
Installing SDK <resolved-version>
Installed SDK <resolved-version>
Setup complete!

El programa de instalación pregunta qué canal del SDK se va a instalar y cómo desea acceder al comando administrado dotnet .

Para una configuración concisa y no interactiva, instale un SDK y configure el shell actual:

> dotnetup install latest
Downloading SDK <resolved-version>
Installing SDK <resolved-version>
Installed SDK <resolved-version>

> dotnetup env set shell
dotnet and dotnetup are on your PATH.
To apply the change to this terminal now, run:
<shell-specific command>
Or open a new terminal.

> dotnetup list
Installations (managed by dotnetup):

  <default-installation-root>

    Tracked channels:
      SDK latest  (source: explicit)

    Installed versions:
      SDK <resolved-version>  (<architecture>)

Total: 1

> dotnet --version
<resolved-version>

Si no desea cambiar el perfil de shell, use el comando de reenvío:

> dotnetup install latest
Downloading SDK <resolved-version>
Installing SDK <resolved-version>
Installed SDK <resolved-version>

> dotnetup env set none
dotnetup is on your PATH. dotnet is not — run it with 'dotnetup dotnet <command>'.
Open a new terminal for the change to take effect.

> dotnetup dotnet --version
<resolved-version>

El modo, la versión resuelta, la arquitectura, la ruta de instalación y el comando shell dependen del sistema y de las versiones disponibles.

Cómo dotnetup gestiona .NET

dotnetup hace un seguimiento de las instalaciones del SDK que solicita. Este seguimiento permite dotnetup actualizar muchas instalaciones al mismo tiempo. También permite dotnetup quitar de forma segura instalaciones sin usar o fuera de soporte técnico.

Para obtener más información, consulte Funcionamiento de dotnetup.

Objetivo Artículo
Decidir si dotnetup se ajusta a su escenario Cuándo usar dotnetup
Instala dotnetup y ejecuta la configuración inicial Comenzar con dotnetup
Comprender canales, raíces de instalación y seguimiento Funcionamiento de dotnetup
Usar el global.json de un repositorio Administración de los requisitos del SDK del repositorio
Instalar SDKs y entornos de ejecución Instalar componentes de .NET
Actualizar o quitar instalaciones Actualizar instalaciones
Actualizar o quitar dotnetup en sí Actualizar o quitar dotnetup
Configuración de PATH y DOTNET_ROOT Administrar el entorno dotnetup
Prueba las versiones preliminares o diarias Usa versiones preliminares y compilaciones diarias
Corrección de problemas comunes Solucionar problemas de dotnetup
Conozca qué datos recopila dotnetup. telemetría dotnetup
Consultar la sintaxis de comandos Referencia del comando dotnetup

Availability

dotnetup está disponible como versión preliminar pública. Los comandos, las opciones y el comportamiento pueden cambiar entre versiones preliminares, y el ciclo de vida de soporte técnico de la versión disponible con carácter general aún no se ha definido.

Para instalar dotnetup, consulte Primeros pasos con dotnetup. Después de instalarlo, ejecute dotnetup --version para confirmar la versión y dotnetup --help ver los comandos disponibles.