Mettre à jour ou supprimer dotnetup

Note

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

Cet article explique comment gérer l’outil dotnetup lui-même. Pour mettre à jour ou supprimer les SDK et runtimes .NET gérés par dotnetup, consultez Mettre à jour les installations.

Vérifier la version dotnetup

Afficher la version de dotnetup:

dotnetup --version

Pour afficher également le commit, l’architecture, l’identificateur d’exécution et les installations vérifiées, exécutez :

dotnetup --info

Mettre à jour dotnetup

Pour mettre à jour l’exécutable dotnetup autonome en place, exécutez :

dotnetup self update

Cette commande est disponible dans les versions préliminaires de dotnetup 0.3.0. Il sélectionne le canal de publication à partir de l’étiquette de version installée. Les builds quotidiennes officielles utilisent également l’étiquette preview . Spécifiez donc explicitement le canal pour rester sur les builds quotidiennes :

dotnetup self update --channel daily

Pour revenir d’une build quotidienne plus récente à la dernière préversion publique, exécutez :

dotnetup self update --channel preview --force

--force peut installer une version antérieure de l’exécutable ou le réinstaller. Pour connaître les options de commande et les restrictions, consultez dotnetup self update.

Une mise à jour de dotnetup ne modifie pas vos installations .NET, votre configuration de votre environnement ou vos spécifications d'installation suivies.

Mettre à jour une version antérieure ou récupérer l’exécutable

Si votre version ne reconnaît self updatepas ou si l’exécutable ne démarre plus, réexécutez le script de téléchargement. Le script remplace l’exécutable existant dans le répertoire d’installation sélectionné.

Sur macOS ou Linux, exécutez :

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

Sur Windows, exécutez :

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

Le script installe la dernière preview build par défaut. Si vous utilisez la version daily ou un répertoire d'installation personnalisé, passez les mêmes options que celles que vous avez utilisées pour la première installation. Par exemple, sur macOS ou Linux :

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

Sur Windows :

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

Configurer les notifications de mise à jour

Après l’exécution réussie des commandes interactives d’installation et de mise à jour, dotnetup peut vous avertir qu’une build plus récente est disponible. La notification n’installe pas la mise à jour.

Pour désactiver les notifications, exécutez :

dotnetup self update --update-notifications false

Pour réactiver les notifications, utilisez --update-notifications true. Pour connaître la fréquence de vérification et le comportement de sortie, consultez Notifications de mise à jour.

Supprimer dotnetup

Pour supprimer dotnetup et tout ce qu’il gère, effectuez ces étapes dans l’ordre.

1. Recherchez vos répertoires racine d’installation

Répertoriez les racines d’installation suivies par dotnetup :

dotnetup list

Enregistrez chaque racine d’installation qui n’est pas dans le répertoire de données dotnetup. Vous supprimez ces dossiers dans une étape ultérieure.

2. Supprimer la configuration de l’environnement

Supprimez les modifications PATH et DOTNET_ROOT que dotnetup a apportées :

dotnetup env clear

En shell mode, exécutez cette commande à partir de l’interpréteur de commandes dont le profil dotnetup a changé, ou sélectionnez cet interpréteur de commandes avec l’option --shell . En mode everywhere sur Windows, cette commande modifie le PATH du système et nécessite une élévation.

Cette commande ne supprime ni les SDK ni les runtimes. Pour plus d’informations, consultez Supprimer la configuration de l’environnement.

3. Supprimer les répertoires racine d’installation et le répertoire de données

Supprimez chaque racine d’installation que vous avez enregistrée à l’étape 1.

Supprimez ensuite le répertoire de données dotnetup. Ce répertoire contient la racine d’installation par défaut, le manifeste, le fichier de configuration et le cache de téléchargement.

Système d'exploitation Répertoire par défaut des données
Windows %LOCALAPPDATA%\dotnetup
macOS ~/Library/Application Support/dotnetup
Linux $XDG_DATA_HOME/dotnetup, ou ~/.local/share/dotnetup quand XDG_DATA_HOME n’est pas défini

Si vous définissez la variable d'environnement DOTNET_DOTNETUP_DATA_DIR, supprimez plutôt ce répertoire, puis retirez-la.

4. Supprimer l’exécutable dotnetup

Supprimez le répertoire qui contient l’exécutable dotnetup . Par défaut, le script de téléchargement installe dotnetup dans ~/.dotnetup. Si vous avez ajouté ce répertoire à PATH manuellement, supprimez cette entrée de votre profil shell ou de vos variables d'environnement utilisateur.

Ouvrez un nouveau terminal pour utiliser l’environnement mis à jour.

Voir aussi

  • Dernière mise à jour :