dotnet tool install

Cet article s’applique au Kit de développement logiciel (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
    [--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>
    [--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]
    [--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 -h|--help

Description

La dotnet tool install commande vous permet d’installer des outils .NET sur votre ordinateur. 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 dans un emplacement personnalisé, utilisez l’option --tool-path .
  • Pour installer un outil local, omettez les options et --tool-path les --global options.

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

Système d''exploitation Path
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

Les outils locaux sont ajoutés à un fichier dotnet-tools.json dans un répertoire .config sous le répertoire actuel. Si un fichier manifeste n’existe pas encore, créez-le 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

  • --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 ordre de priorité. Si le même package et la même version se trouve dans plusieurs flux, le flux le plus rapide gagne. Pour plus d’informations, consultez Que se passe-t-il lorsqu’un package NuGet est installé ?.

  • --configfile <FILE>

    Fichier de configuration NuGet (nuget.config) à utiliser. Si spécifié, seuls les paramètres de ce fichier seront utilisés. Si ce n’est pas spécifié, la hiérarchie des fichiers de configuration du répertoire actuel est utilisée. Pour plus d’informations, consultez Configurations NuGet courantes.

  • --disable-parallel

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

  • --framework <FRAMEWORK>

    Spécifie le framework cible pour lequel installer l’outil. Par défaut, le Kit de développement logiciel (SDK) .NET tente 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 les deux --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

    Traitez les échecs de source de package en tant qu’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

    Mettez à jour l’outil et le manifeste d’outil local. Impossible de combiner l’option --global ou l’option --tool-path .

  • --no-cache

    Ne pas mettre en cache les packages et les requêtes HTTP.

  • --prerelease

    Inclure des 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 les deux --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.

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 spécifique.

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

Voir aussi