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.

Estas actualizaciones no actualizan el ejecutable dotnetup. Para actualizar la propia herramienta, use dotnetup self update.

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 todas las raíces 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 elementos no utilizados actualice los orígenes de global.json modificados. 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 elementos no utilizados: 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

Eliminar un requisito rastreado

Para quitar un requisito del SDK, pase su canal almacenado o la versión exacta:

dotnetup sdk uninstall 10.0.1xx

Desinstalar quita la dependencia y, a continuación, limpia las instalaciones no referenciadas a lo largo de la raíz seleccionada. Advierte si otro requisito mantiene la instalación solicitada o si la operación de limpieza quita instalaciones adicionales. Revise estas advertencias antes de confirmar la operación. En la automatización no interactiva, use --non-interactive para omitir la confirmación, no las advertencias.

Para los requisitos de tiempo de ejecución, use dotnetup runtime uninstall. Para más información, consulte Desinstalación del SDK y Desinstalación en tiempo de ejecución.

Consulte también

  • Darrera actualització el