Lire en anglais

Partager via


dotnet tool update

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

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

Voir aussi