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

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] et diag[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 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 de la plage (> 2.0.0 && < 2.1.4)spécifiée, la version 2.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.

Voir aussi