dotnet tool install

  • Article

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

Nom

dotnet tool install - Installe l’outil .NET spécifié sur votre ordinateur.

Synopsis

dotnet tool install <PACKAGE_NAME> -g|--global
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> --tool-path <PATH>
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> [--local]
    [--allow-downgrade] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--create-manifest-if-needed] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install -h|--help

Description

La commande dotnet tool install vous offre un moyen d’installer des outils .NET sur votre machine. Pour utiliser la commande, vous spécifiez l’une des options d’installation suivantes :

  • Pour installer un outil global à l’emplacement par défaut, utilisez l’option --global.
  • Pour installer un outil global à l’emplacement personnalisé, utilisez l’option --tool-path.
  • Pour installer un outil local, omettez les options --tool-path et --global.

Emplacements d’installation

Outils globaux

Les outils globaux sont installés par défaut dans les répertoires suivants quand vous spécifiez l’option -g ou --global :

Système d''exploitation Chemin d’accès
Linux/mac OS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Les exécutables sont générés dans ces dossiers pour chaque outil installé globalement, bien que les fichiers binaires d’outils réels soient imbriqués profondément dans le répertoire .store frère.

Outils --tool-path

Les outils avec des chemins d’outils explicites sont stockés là où vous avez spécifié que le paramètre --tool-path pointait. Ils sont stockés de la même manière que les outils globaux : un binaire exécutable avec les fichiers binaires réels dans un répertoire .store frère.

Outils locaux

Les outils locaux sont stockés dans le répertoire global NuGet, là où vous avez défini qu’il se trouvait. Il existe des fichiers shim dans $HOME/.dotnet/toolResolverCache pour chaque outil local qui pointent là où les outils se trouvent à cet emplacement.

Les références aux outils locaux sont ajoutées à un fichier dotnet-tools.json dans un répertoire .config sous le répertoire actif. Si un fichier manifeste n’existe pas encore, créez-le en utilisant l’option --create-manifest-if-needed ou en exécutant la commande suivante :

dotnet new tool-manifest

Pour plus d’informations, consultez Installer un outil local.

Arguments

  • PACKAGE_NAME

    Nom/ID du package NuGet qui contient l’outil .NET à installer.

Options

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

  • -a|--arch <ARCHITECTURE>

    Spécifie l’architecture cible. Il s’agit d’une syntaxe abrégée pour définir l’identificateur d’exécution (RID), où la valeur fournie est combinée avec le RID par défaut. Par exemple, sur une machine win-x64, la spécification de --arch x86 définit le RID sur win-x86.

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

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

  • --create-manifest-if-needed

    S’applique aux outils locaux. Disponible à partir du SDK .NET 8. Pour rechercher un manifeste, l’algorithme de recherche parcourt l’arborescence de répertoires à la recherche de dotnet-tools.json ou d’un dossier .config qui contient un fichier dotnet-tools.json.

    Si un manifeste d’outils est introuvable et que l’option --create-manifest-if-needed a la valeur false, l’erreur CannotFindAManifestFile se produit.

    Si un manifeste d’outils est introuvable et que l’option --create-manifest-if-needed a la valeur true, l’outil crée automatiquement un manifeste. Il choisit un dossier pour le manifeste comme suit :

    • Il parcourt l’arborescence de répertoires à la recherche d’un répertoire contenant un sous-dossier .git. S’il en trouve un, il crée le manifeste dans ce répertoire.
    • Si l’étape précédente ne trouve pas de répertoire, parcourez l’arborescence de répertoires qui recherche un répertoire contenant un ou .git un .sln fichier. S’il en trouve un, il crée le manifeste dans ce répertoire.
    • Si aucune des deux étapes précédentes n’a permis de trouver un répertoire, l’outil crée le manifeste dans le répertoire de travail actuel.

    Pour plus d’informations sur la localisation des manifestes, consultez Installer un outil local.

  • --disable-parallel

    Empêche la restauration de plusieurs projets en parallèle.

  • --framework <FRAMEWORK>

    Spécifie le framework cible pour lequel installer l’outil. Par défaut, le SDK .NET essaie de choisir le framework cible le plus approprié.

  • -g|--global

    Spécifie que l’installation est à l’échelle de l’utilisateur. Non combinable avec l’option --tool-path. Omettre à la fois --global et --tool-path spécifie une installation d’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 met pas en cache les packages et les requêtes HTTP.

  • --prerelease

    Incluez les packages de préversion.

  • --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. Si le chemin n’existe pas, la commande essaie de le créer. Omettre à la fois --global et --tool-path spécifie une installation d’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_NUMBER>

    Version de l’outil à installer. Par défaut, la dernière version stable du package est installée. Utilisez cette option pour installer la préversion ou des versions antérieures de l’outil.

    À compter de .NET 8.0, --version Major.Minor.Patch fait référence à une version majeure/mineure/corrective spécifique, y compris des versions non répertoriées. Pour obtenir plutôt la dernière version d’une version majeure/mineure particulière, utilisez --version Major.Minor.*.

Exemples

  • dotnet tool install -g dotnetsay

    Installe dotnetsay en tant qu’outil global à l’emplacement par défaut.

  • dotnet tool install dotnetsay --tool-path c:\global-tools

    Installe dotnetsay en tant qu’outil global dans un répertoire Windows spécifique.

  • dotnet tool install dotnetsay --tool-path ~/bin

    Installe dotnetsay en tant qu’outil global dans un répertoire Linux/macOS.

  • dotnet tool install -g dotnetsay --version 2.0.0

    Installe la version 2.0.0 de dotnetsay en tant qu’outil global.

  • dotnet tool install dotnetsay

    Installe dotnetsay en tant qu’outil local pour le répertoire actif.

  • dotnet tool install -g --verbosity minimal

    Installe dotnetsay en tant qu’outil global avec une verbosité minimale. L’outil global dispose d’une verbosité silencieuse par défaut.

Voir aussi