Actualizar las instalaciones de .NET registradas con dotnetup

Note

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

dotnetup almacena el canal solicitado por separado de la versión resuelta. Una actualización resuelve de nuevo cada canal continuo.

Selecciona el ámbito de actualización

Use uno de estos comandos:

# Update all tracked SDK and runtime requirements.
dotnetup update

# Update SDK requirements only.
dotnetup sdk update

# Update SDK and runtime requirements.
dotnetup sdk update --all

# Update runtime requirements only.
dotnetup runtime update

Las actualizaciones en tiempo de ejecución incluyen el entorno de ejecución principal de .NET y los entornos de ejecución de ASP.NET Core. En Windows, también incluyen requisitos del entorno de ejecución de Windows Desktop.

Limitar la raíz de instalación

De forma predeterminada, una actualización puede procesar los requisitos de todos los roots del manifiesto seleccionado. Use --install-path para limitar la operación:

dotnetup update --install-path D:\tools\dotnet

Actualizar archivos del repositorio

Los requisitos del SDK pueden usar global.json como origen. Para volver a escribir la versión del SDK recién resuelta en cada archivo de origen, ejecute:

dotnetup sdk update --update-global-json

Sin esta opción, dotnetup instala la actualización, pero no edita el archivo del repositorio.

Una actualización procesa los requisitos almacenados antes de que la recolección de basura actualice los orígenes modificados global.json. Después de cambiar global.json de un repositorio, ejecute dotnetup sdk install desde ese repositorio antes de actualizar sus requisitos almacenados. De lo contrario, la primera actualización podría seguir procesando el requisito anterior.

Comprender el comportamiento de la actualización

  • Se omiten las versiones exactas del SDK y del entorno de ejecución: se solicitaron explícitamente, por lo que nunca se pueden actualizar.
  • Cada requisito de instalación se procesa de forma independiente.
  • El procesamiento de todos los requisitos de instalación continúa después de un error individual.
  • El comando notifica un error después de procesar todos los requisitos de instalación restantes.
  • Las actualizaciones realizadas correctamente ejecutan la recolección de basura: un proceso de limpieza que quita los componentes instalados que ninguno de los requisitos de instalación configurados necesita realmente.
  • Una versión instalada permanece si otro requisito todavía lo necesita.

Revisión del resultado

Compruebe el estado registrado y las instalaciones en el disco:

dotnetup list

Para la salida legible por la máquina:

dotnetup list --format json

Consulte también