Notes
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 3.1 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]
[-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]
[-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]
[--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_ID
Nom/ID du package NuGet qui contient l’outil global .NET à mettre à jour. 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.
--all
Mettez à jour tous les outils.
--allow-downgrade
Autorisez 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-parallel
Empêche la restauration de plusieurs projets en parallèle.
--framework <FRAMEWORK>
Spécifie l’infrastructure cible pour laquelle mettre à jour l’outil.
-g|--global
Spécifie que la mise à jour concerne un outil à l’échelle de l’utilisateur. Non combinable avec l’option
--tool-path
. Omettre les deux--global
et--tool-path
spécifie que l’outil à mettre à jour est un outil local.
-?|-h|--help
Imprime une description de l’utilisation de la commande.
--ignore-failed-sources
Considérez les échecs de la source du package comme des avertissements.
--interactive
Permet à la commande de s’arrêter et d’attendre une action ou une entrée utilisateur. Par exemple, pour effectuer une authentification.
--local
Met à jour l’outil et le manifeste d’outils locaux. Non combinable avec l’option
--global
ou l’option--tool-path
.--no-cache
Ne cachez pas les packages et les requêtes HTTP.
--prerelease
Incluez des versions préliminaires.
--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--global
et--tool-path
spé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
uninstall
d’abord les versions plus récentes.À compter de .NET 8.0,
--version Major.Minor.Patch
fait 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 dotnetsay
Met à jour l’outil global dotnetsay .
dotnet tool update dotnetsay --tool-path c:\global-tools
Met à jour l’outil global dotnetsay situé dans un répertoire Windows spécifique.
dotnet tool update dotnetsay --tool-path ~/bin
Met à jour l’outil global dotnetsay situé dans un répertoire Linux/macOS spécifique.
dotnet tool update dotnetsay
Met à 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 --version (2.0.*,2.1.4)
Met à jour l’outil global dotnetsay vers la version la plus basse de la plage
(> 2.0.0 && < 2.1.4)
spécifiée, la version2.1.0
est installée. Pour plus d’informations sur les plages de contrôle de version sémantique, consultez les plages de versions d’empaquetage NuGet.