Actualizar o quitar dotnetup

Note

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

En este artículo se describe cómo administrar la herramienta dotnetup en sí. Para actualizar o quitar los SDK y los entornos de ejecución de .NET que dotnetup administra, consulte Actualizar instalaciones.

Comprobación de la versión de dotnetup

Mostrar la versión de dotnetup:

dotnetup --version

Para mostrar también el commit, la arquitectura, el identificador del entorno de ejecución y las instalaciones comprobadas, ejecute:

dotnetup --info

Actualizar dotnetup

Para actualizar el ejecutable dotnetup independiente en su lugar, ejecute:

dotnetup self update

Este comando está disponible en las compilaciones preliminares de dotnetup 0.3.0. Selecciona el canal de lanzamiento de la etiqueta de la versión instalada. Las compilaciones diarias oficiales también usan la preview etiqueta , por lo que especifique el canal explícitamente para permanecer en compilaciones diarias:

dotnetup self update --channel daily

Para volver de una compilación diaria más reciente a la versión preliminar pública más reciente, ejecute:

dotnetup self update --channel preview --force

--force puede volver a una versión anterior o volver a instalar el archivo ejecutable. Para ver las opciones y restricciones de comandos, consulte dotnetup self update.

Una actualización de dotnetup no cambia las instalaciones de .NET, la configuración del entorno o las especificaciones de instalación con seguimiento.

Actualiza una versión anterior o recupera el ejecutable

Si la versión no reconoce self updateo el archivo ejecutable ya no se inicia, vuelva a ejecutar el script de descarga. El script reemplaza el archivo ejecutable existente en el directorio de instalación seleccionado.

En macOS o Linux, ejecute:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh | bash

En Windows, ejecute:

irm https://aka.ms/dotnetup/get-dotnetup.ps1 | iex

El script instala la compilación más reciente preview de forma predeterminada. Si usa la daily compilación o un directorio de instalación personalizado, pase las mismas opciones que usó para la primera instalación. Por ejemplo, en macOS o Linux:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh |
  bash -s -- --quality daily --install-dir /opt/dotnetup

En Windows:

iex "& { $(irm https://aka.ms/dotnetup/get-dotnetup.ps1) } -Quality daily -InstallDir C:\tools\dotnetup"

Configurar notificaciones de actualización

Después de que los comandos de instalación y actualización interactivos se realicen correctamente, dotnetup puede notificarle que hay disponible una compilación más reciente. La notificación no instala la actualización.

Para deshabilitar las notificaciones, ejecute:

dotnetup self update --update-notifications false

Para volver a habilitar las notificaciones, use --update-notifications true. Para conocer la frecuencia de comprobación y el comportamiento de salida, consulte Notificaciones de actualización.

Quitar dotnetup

Para quitar dotnetup y todo lo que administra, complete estos pasos en orden.

1. Busque sus directorios raíz de instalación

Enumere las raíces de instalación que dotnetup rastrea:

dotnetup list

Registre cada raíz de instalación que no esté en el directorio de datos dotnetup. Elimine estas carpetas en un paso posterior.

2. Quitar la configuración del entorno

Quite los cambios PATH y DOTNET_ROOT que dotnetup realizó:

dotnetup env clear

En shell modo, ejecute este comando desde el shell cuyo perfil dotnetup cambió o seleccione ese shell con la --shell opción . En modo everywhere en Windows, este comando cambia la configuración del sistema PATH y requiere elevación.

Este comando no quita los SDK ni los entornos de ejecución. Para obtener más información, consulte Eliminación de la configuración del entorno.

3. Eliminar las raíces de instalación y el directorio de datos

Elimine cada raíz de instalación que registró en el paso 1.

A continuación, elimine el directorio de datos dotnetup. Este directorio contiene la raíz de instalación predeterminada, el manifiesto, el archivo de configuración y la caché de descarga.

Sistema operativo Directorio de datos predeterminado
Windows %LOCALAPPDATA%\dotnetup
macOS ~/Library/Application Support/dotnetup
Linux $XDG_DATA_HOME/dotnetup, o ~/.local/share/dotnetup cuando XDG_DATA_HOME no se establece

Si establece la variable de entorno DOTNET_DOTNETUP_DATA_DIR, elimine ese directorio en su lugar y, a continuación, quite la variable.

4. Eliminar el ejecutable dotnetup

Elimine el directorio que contiene el dotnetup ejecutable. De forma predeterminada, el script de descarga instala dotnetup en ~/.dotnetup. Si ha agregado este directorio a PATH manualmente, quite esa entrada del perfil de shell o de las variables de entorno de usuario.

Abra un nuevo terminal para usar el entorno actualizado.

Consulte también

  • Darrera actualització el