Partager via

dotnet tool exec (exécuter un outil .NET)

Cet article s’applique à : ✔️ SDK .NET 10.0.100 et versions ultérieures

Nom

dotnet tool exec - Télécharge et appelle un outil .NET sans l’installer définitivement.

Synopsis

dotnet tool exec <PACKAGE_NAME>[@<VERSION>]
    [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-http-cache] [--prerelease] [--source <SOURCE>]
    [-v|--verbosity <LEVEL>]
    [--] [<tool-arguments>...]

dotnet tool exec -h|--help

Descriptif

La dotnet tool exec commande fournit un mode d’appel d’outil unique pour les outils .NET. Il télécharge automatiquement le package d’outils spécifié dans le cache NuGet et l’appelle sans modifier votre système PATH ou exiger une installation permanente.

Lorsque vous exécutez dotnet tool exec, la commande :

  1. Vérifie la version (ou la plage de versions) que vous spécifiez (ou la dernière version si aucune n’est spécifiée) par rapport à vos flux NuGet configurés pour décider quel package télécharger.
  2. Télécharge le package spécifié dans le cache NuGet (s’il n’est pas déjà présent).
  3. Appelle l’outil avec tous les arguments fournis.
  4. Retourne le code de sortie de l’outil.

dotnet tool exec fonctionne en toute transparence avec les outils globaux et locaux. Si vous disposez d’un manifeste d’outil local disponible, il utilise le manifeste pour déterminer la version de l’outil à exécuter.

Cette commande existe également sous deux autres formes pour faciliter l’utilisation

  • dotnet dnx - Un alias masqué pour dotnet tool exec celui-ci est utilisé comme moyen d’implémenter facilement le dnx script lui-même
  • dnx - Script d’interpréteur de commandes dotnet dnx qui appelle à partir du Kit de développement logiciel (SDK). Ce script est fourni par le programme d’installation et est disponible sur PATH. Il permet une utilisation très simple d’outils directement via dnx <toolname>.

Arguments

  • PACKAGE_NAME

    ID de package NuGet de l’outil .NET à exécuter. Vous pouvez éventuellement spécifier une version à l’aide de la @ syntaxe, par exemple dotnetsay@2.1.0.

  • tool-arguments

    Arguments à passer à l’outil en cours d’exécution. Tout après -- est passé directement à l’outil.

Options

  • --allow-roll-forward

    Autorisez l’outil à utiliser une version plus récente du runtime .NET si le runtime cible n’est pas installé.

  • --add-source <SOURCE>

    Ajoute une source de package NuGet supplémentaire à utiliser pendant l’installation. Les flux sont accessibles en parallèle, et non dans une séquence de cascade de secours. Si le même package et la même version sont disponibles dans plusieurs flux, le flux le plus rapide gagne. Pour plus d’informations, consultez Ce qui se passe quand un package NuGet est installé. Vous pouvez contrôler cela via l’utilisation du mappage de source de package NuGet. Pour plus d’informations, consultez Mappage de source de package.

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

  • --ignore-failed-sources

    Traite les échecs de 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.

  • --no-http-cache

    Ne met pas en cache les requêtes HTTP sur les flux NuGet configurés.

  • --prerelease

    Permet de sélectionner des packages de préversion lors de la résolution de la version à installer.

  • --source <SOURCE>

    Spécifie la source des packages NuGet.

  • -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]. La valeur par défaut est normal. Pour plus d’informations, consultez LoggerVerbosity.

  • -?|-h|--help

    Imprime une description de l’utilisation de la commande.

Examples

  • dotnet tool exec dotnetsay

    Télécharge (si nécessaire) et exécute la dernière version de l’outil dotnetsay .

  • dotnet tool exec dotnetsay@2.1.0

    Télécharge (si nécessaire) et exécute la version 2.1.0 de l’outil dotnetsay .

  • dotnet tool exec dotnetsay@2.*

    Télécharge (si nécessaire) et exécute la dernière version de l’outil dotnetsay dans la plage de versions 2.x.

  • dotnet tool exec dotnetsay -- Hello World

    Exécute l’outil dotnetsay et transmet « Hello World » en tant qu’arguments à l’outil.

  • dotnet tool exec --add-source https://api.nuget.org/v3/index.json mytool

    Télécharge et s’exécute à mytool l’aide de la source NuGet spécifiée.

Comparaison avec d’autres commandes

Cette commande est destinée à être un moyen unifié d’utiliser .NET Tools. Bien que les commandes d’installation de l’outil précédemment disponibles restent disponibles, dotnet tool exec offre une expérience plus simple et plus flexible pour la plupart des utilisateurs.

Command Objectif Installation Scope
dotnet tool exec Exécution d’un coup Aucun (mis en cache uniquement) Temporary
dotnet tool install -g Installation globale permanente Global À l’échelle du système
dotnet tool install Installation locale permanente Manifeste local Projet
dotnet tool run Exécuter un outil local déjà installé Nécessite une installation antérieure Projet

La dotnet tool install -g commande ne sert toujours qu’à des utilisateurs qui souhaitent installer définitivement un outil. Toutefois, pour les utilisateurs qui souhaitent essayer un outil ou l’exécuter dans un pipeline CI/CD, dotnet tool exec il est souvent préférable.

Voir aussi

  • Last updated on