dotnet tool update

Article
03/19/2024

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>] [--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>] [--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>] [--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

Description

La commande dotnet tool update vous offre un moyen de mettre à jour des outils .NET sur votre ordinateur vers la dernière version stable du package. La commande désinstalle et réinstalle un outil en le mettant à jour. 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.

Arguments

PACKAGE_ID

Nom/ID du package NuGet qui contient l’outil global .NET à mettre à jour. Vous pouvez trouver le nom du package à l’aide de la commande dotnet tool list.

Options

--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.

--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 Configurations NuGet courantes.

--disable-parallel

Empêche la restauration de plusieurs projets en parallèle.
--framework <FRAMEWORK>

Spécifie le framework cible pour lequel 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 --global et --tool-path revient à indiquer que l’outil à mettre à jour est un outil local.

-?|-h|--help

Affiche 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 pas mettre en cache les packages et les requêtes HTTP.
--prerelease

Inclure les préversions.
--tool-manifest <PATH>

Chemin d’accès au fichier manifeste.
--tool-path <PATH>

Spécifie l’emplacement d’installation de l’outil global. Le chemin peut être absolu ou relatif. Non combinable avec l’option --global. Omettre --global et --tool-path revient à indiquer 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] et diag[nostic]. Pour plus d’informations, consultez LoggerVerbosity.

--version <VERSION>

Plage de versions du package d’outils à mettre à jour. Ne peut pas être utilisé pour passer à une version antérieure. Vous devez d’abord uninstall les versions plus récentes.

À compter de .NET 8.0, --version Major.Minor.Patch fait référence à une version majeure/mineure/corrective spécifique, dont des versions non répertoriées. Pour obtenir plutôt la dernière version d’une version majeure.mineure spécifique, 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 de correctif, avec une version majeure de 2, et une version mineure de 0.
dotnet tool update -g dotnetsay --version (2.0.*,2.1.4)

Met à jour l’outil global dotnetsay vers la version la plus basse dans la plage spécifiée (> 2.0.0 && < 2.1.4). La version 2.1.0 serait installée. Pour plus d’informations sur les plages de contrôle de version sémantique, consultez Plages de versions des packages NuGet.

Partage via