Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Cet article s’applique à : ✔️ SDK .NET Core 6 et versions ultérieures
Nom
dotnet tool update - Met à jour l’outil .NET spécifié sur votre ordinateur.
Synopsis
dotnet tool update <PACKAGE_ID> -g|--global
[--add-source <SOURCE>] [--all] [--allow-downgrade]
[--configfile <FILE>]
[--disable-parallel] [--framework <FRAMEWORK>]
[--ignore-failed-sources] [--interactive]
[--no-cache] [--prerelease] [--source <SOURCE>]
[-v|--verbosity <LEVEL>] [--version <VERSION>]
dotnet tool update <PACKAGE_ID> --tool-path <PATH>
[--add-source <SOURCE>] [--all] [--allow-downgrade]
[--configfile <FILE>]
[--disable-parallel] [--framework <FRAMEWORK>]
[--ignore-failed-sources] [--interactive]
[--no-cache] [--prerelease] [--source <SOURCE>]
[-v|--verbosity <LEVEL>] [--version <VERSION>]
dotnet tool update <PACKAGE_ID> --local
[--add-source <SOURCE>] [--all] [--allow-downgrade]
[--configfile <FILE>]
[--disable-parallel] [--framework <FRAMEWORK>]
[--ignore-failed-sources] [--interactive]
[--no-cache] [--prerelease] [--source <SOURCE>]
[--tool-manifest <PATH>]
[-v|--verbosity <LEVEL>] [--version <VERSION>]
dotnet tool update -h|--help
Descriptif
La dotnet tool update commande vous permet de mettre à jour les outils .NET sur votre ordinateur vers la dernière version stable du package. La commande désinstalle et réinstalle un outil, le mettant à jour efficacement. Pour utiliser la commande, vous spécifiez l’une des options suivantes :
- Pour mettre à jour un outil global installé à l’emplacement par défaut, utilisez l’option
--global - Pour mettre à jour un outil global installé dans un emplacement personnalisé, utilisez l’option
--tool-path. - Pour mettre à jour un outil local, utilisez l’option
--local.
Les arguments
PACKAGE_IDNom/ID du package NuGet qui contient l’outil global .NET à mettre à jour.
À compter du Kit de développement logiciel (SDK) .NET 10.0.100, utilisez le nom/l’ID et la version séparées par
@la mise à jour d’un outil .NET.Vous trouverez le nom du package à l’aide de la commande dotnet tool list .
Paramètres
-
--add-source <SOURCE>Ajoute une source de package NuGet supplémentaire à utiliser pendant l’installation. Les flux sont accessibles en parallèle, et non séquentiellement dans un certain ordre de priorité. Si le même package et la même version sont dans plusieurs flux, le flux le plus rapide gagne. Pour plus d’informations, consultez Processus d’installation d’un package NuGet.
--allMettez à jour tous les outils.
-
--allow-downgradeAutorisez la rétrogradation du package lors de l’installation ou de la mise à jour d’un package d’outils .NET. Supprime l’avertissement : « La version demandée x.x.x est inférieure à la version existante x.x.x ».
-
--configfile <FILE>Fichier de configuration NuGet (nuget.config) à utiliser. S’ils sont spécifiés, seuls les paramètres de ce fichier seront utilisés. Si elle n’est pas spécifiée, la hiérarchie des fichiers de configuration du répertoire actuel sera utilisée. Pour plus d’informations, consultez Configuration NuGet courantes.
-
--disable-parallelEmpêche la restauration de plusieurs projets en parallèle.
--framework <FRAMEWORK>Spécifie l’infrastructure cible pour laquelle mettre à jour l’outil.
-g|--globalSpécifie que la mise à jour concerne un outil à l’échelle de l’utilisateur. Non combinable avec l’option
--tool-path. Omettre les deux--globalet--tool-pathspécifie que l’outil à mettre à jour est un outil local.-
-?|-h|--helpImprime une description de l’utilisation de la commande.
--ignore-failed-sourcesConsidérez les échecs de la source du package comme des avertissements.
-
--interactivePermet à la commande de s’arrêter et d’attendre une action ou une entrée utilisateur. Par exemple, pour effectuer une authentification.
--localMet à jour l’outil et le manifeste d’outils locaux. Non combinable avec l’option
--globalou l’option--tool-path.--no-cacheNe cachez pas les packages et les requêtes HTTP.
--prereleaseIncluez des versions préliminaires.
-
--source <SOURCE>Spécifie la source des packages NuGet.
--tool-manifest <PATH>Chemin d’accès au fichier manifeste.
--tool-path <PATH>Spécifie l’emplacement où l’outil global est installé. Le chemin peut être absolu ou relatif. Non combinable avec l’option
--global. Omettre les deux--globalet--tool-pathspécifie que l’outil à mettre à jour est un outil local.-
-v|--verbosity <LEVEL>Définit le niveau de détail de la commande. Les valeurs autorisées sont
q[uiet],m[inimal],n[ormal],d[etailed]etdiag[nostic]. Pour plus d’informations, consultez LoggerVerbosity. --version <VERSION>Plage de versions du package d’outils à mettre à jour. Cela ne peut pas être utilisé pour rétrograder les versions, vous devez
uninstalld’abord les versions plus récentes.À compter de .NET 8.0,
--version Major.Minor.Patchfait référence à une version spécifique de major.minor.patch, y compris les versions non répertoriées. Pour obtenir la dernière version d’une version majeure.minor à la place, utilisez--version Major.Minor.*.
Exemples
dotnet tool update -g dotnetsayMet à jour l’outil global dotnetsay .
dotnet tool update dotnetsay --tool-path c:\global-toolsMet à jour l’outil global dotnetsay situé dans un répertoire Windows spécifique.
dotnet tool update dotnetsay --tool-path ~/binMet à jour l’outil global dotnetsay situé dans un répertoire Linux/macOS spécifique.
dotnet tool update dotnetsayMet à jour l’outil local dotnetsay installé pour le répertoire actif.
dotnet tool update -g dotnetsay --version 2.0.*Met à jour l’outil global dotnetsay vers la dernière version du correctif, avec une version majeure de
2, et une version mineure de0.dotnet tool update -g dotnetsay@2.1.7*Met à jour l’outil global dotnetsay vers la dernière version du correctif 2.1.7.
dotnet tool update -g dotnetsay --version (2.0.0,2.1.7)Met à jour l’outil global dotnetsay vers la version la plus basse de la plage
(> 2.0.0 && < 2.1.7)spécifiée, la version2.1.0est installée. Pour plus d’informations sur les plages de contrôle de version sémantique, consultez les plages de versions d’empaquetage NuGet.