Mettre à jour les installations de .NET suivies avec dotnetup

Note

dotnetup est disponible en préversion publique. Ses fonctionnalités et son comportement peuvent changer avant la disponibilité générale.

dotnetup stocke le canal demandé séparément de la version résolue. Une mise à jour résout à nouveau chaque canal glissant.

Choisir la portée de la mise à jour

Utilisez l’une des commandes suivantes :

# 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

Les mises à jour du runtime incluent le runtime .NET de base et les runtimes d’ASP.NET Core. Sous Windows, ils incluent également la configuration requise du runtime de bureau Windows.

Limiter la racine d’installation

Par défaut, une mise à jour peut traiter les dépendances de tous les projets racine du manifeste sélectionné. Utilisez --install-path pour limiter l’opération :

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

Mettre à jour les fichiers du référentiel

Les exigences du kit de développement logiciel (SDK) peuvent utiliser global.json comme source. Pour réécrire la version du SDK nouvellement résolue dans chaque fichier source, exécutez :

dotnetup sdk update --update-global-json

Sans cette option, dotnetup installe la mise à jour, mais ne modifie pas le fichier de référentiel.

Une mise à jour traite les exigences stockées avant que le ramasse-miettes actualise les sources modifiées global.json . Une fois que vous avez modifié le référentiel global.json, exécutez dotnetup sdk install à partir de ce référentiel avant de mettre à jour ses dépendances enregistrées. Sinon, la première mise à jour peut toujours traiter la condition précédente.

Comprendre le comportement de mise à jour

  • Les versions exactes du Kit de développement logiciel (SDK) et du runtime sont ignorées. Elles ont été explicitement demandées, de sorte qu’elles ne peuvent jamais être mises à jour.
  • Chaque exigence d’installation est traitée indépendamment.
  • Le traitement de toutes les exigences d’installation se poursuit après un échec isolé.
  • La commande signale l’échec après avoir traité toutes les exigences d’installation restantes.
  • Les mises à jour réussies exécutent le garbage collection : un processus de nettoyage qui supprime tous les composants installés dont aucune de vos exigences d’installation configurées n’a réellement besoin.
  • Une version installée reste si une autre exigence en a toujours besoin.

Passer en revue le résultat

Vérifiez l’état suivi et les installations sur disque :

dotnetup list

Pour la sortie lisible par machine:

dotnetup list --format json

Voir aussi

  • Dernière mise à jour :