Installation de l’outil dotnet

Cet article s’applique à : ✔️ SDK .NET Core 6 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] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease] [--source <SOURCE>]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

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

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

dotnet tool install -h|--help

Descriptif

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 --global et --tool-path.

Avertissement

Vérifiez que le répertoire que vous spécifiez avec l’option --tool-path est sécurisé. Les outils installés dans cet emplacement peuvent être exécutés directement. Par conséquent, l’utilisation d’un chemin d’accès non approuvé ou partagé peut entraîner des risques de sécurité.

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`
Fenêtres	`%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.

Remarque

Sur Linux après avoir installé un outil en ligne de commande avec dotnet tool, l’outil ne peut être exécuté qu’à partir du chemin d’accès $HOME/.dotnet/tools . Pour rendre l’outil exécutable à partir de n’importe quel répertoire, mettez à jour la variable d’environnement PATH . Pour rendre la variable d’environnement mise à jour permanente dans votre interpréteur de commandes, mettez PATH à jour les paramètres de votre interpréteur de commandes. Pour Bash, il s’agit du $HOME/.bashrc fichier.

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. À compter de .NET 10, si un fichier manifeste n’existe pas encore, un fichier manifeste est créé automatiquement. Vous pouvez également en créer un manuellement en exécutant la commande suivante :

dotnet new tool-manifest

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

Les arguments

PACKAGE_NAME

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

À compter du Kit de développement logiciel (SDK) .NET 10.0.100, utilisez le nom/l’ID et la version séparées par @ l’installation d’un outil .NET.

Paramètres

--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 ».
--allow-roll-forward

Disponible à partir du Kit de développement logiciel (SDK) .NET 9.0. Autoriser l’outil à utiliser une version plus récente du runtime .NET si le runtime cible n’est pas installé.
-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. Si vous utilisez cette option, n’utilisez pas l’option -r|--runtime. Disponible depuis .NET 6 Preview 7.
--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

Disponible à partir du Kit de développement logiciel (SDK) .NET 8.

S’applique aux outils locaux. 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’outil est introuvable et que l’option --create-manifest-if-needed est définie falsesur , l’erreur CannotFindAManifestFile se produit.

Si aucun manifeste d’outil n’est trouvé et que l’option --create-manifest-if-needed est définie true sur (ou, dans .NET 10 et versions ultérieures, lorsqu’elle n’est pas spécifiée), 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 .sln un .git 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.

À compter de .NET 10, un manifeste est créé automatiquement si aucun manifeste d’outils n’est trouvé. Ce changement peut être un changement cassant. Vous pouvez désactiver en passant --create-manifest-if-needed=false.

Avertissement

N’exécutez pas de commandes d’outil à partir du dossier Téléchargements ou d’un emplacement partagé. L’interface CLI guide l’arborescence de répertoires pour rechercher un manifeste d’outil, ce qui peut entraîner l’utilisation d’un manifeste que vous ne vous attendez pas. Exécutez toujours les commandes de l’outil à partir d’un répertoire approuvé spécifique au projet.
--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.
--source <SOURCE>

Spécifie la source des packages NuGet.
-?|-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 ou --no-http-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, --version Major.Minor.Patch fait référence à une version majeure/mineure/corrective spécifique, y compris les 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 -g dotnetsay@2.1.7

Installe la version 2.1.7 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 dotnetsay@2.1.7

Installe la version 2.1.7 de dotnetsay en tant qu’outil local pour le répertoire actif.
dotnet tool install -g dotnetsay --verbosity minimal

Installe dotnetsay en tant qu’outil global avec une verbosité minimale. L’outil global dispose d’une verbosité silencieuse par défaut.
dotnet tool install -g dotnetsay --allow-roll-forward

Installe dotnetsay en tant qu’outil global et lui permet de s’exécuter sur des versions .NET plus récentes si le runtime cible n’est pas disponible.

Voir aussi

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-11-12