dotnet new install

  • Article

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

Nom

dotnet new install - Installe un package de modèle.

Synopsis

dotnet new install <PATH|NUGET_ID>  [--interactive] [--add-source|--nuget-source <SOURCE>] [--force] 
    [-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]

Description

La commande dotnet new install installe un package de modèle à partir du PATH ou NUGET_ID fourni. Si vous souhaitez installer une version spécifique ou une préversion d’un package de modèle, spécifiez la version au format <package-name>::<package-version>. Par défaut, dotnet new passe * pour la version, qui représente la dernière version stable du package. Pour plus d’informations, consultez la section Exemples.

Si une version du package de modèle a déjà été installée lorsque vous exécutez cette commande, le package de modèle est mis à jour vers la version spécifiée. Si aucune version n’est spécifiée, le package est mis à jour vers la dernière version stable. À compter du SDK .NET 6.0.100, si l’argument spécifie la version et que cette version du package NuGet est déjà installée, elle ne sera pas réinstallée. Si l’argument est un PATH et qu’il est déjà installé, il ne sera pas réinstallé.

Avant le SDK .NET 6.0.100, les packages de modèle ont été gérés individuellement pour chaque version du SDK .NET, y compris les versions correctives. Par exemple, si vous installez le package de modèle à l’aide de dotnet new --install dans le SDK .NET 5.0.100, il n’est installé que pour le SDK .NET 5.0.100. Les modèles du package ne seront pas disponibles dans d’autres versions du SDK .NET installées sur votre ordinateur.

À compter du SDK .NET 6.0.100, les packages de modèle installés sont disponibles dans les versions ultérieures du SDK .NET installées sur votre ordinateur. Un package de modèle installé dans le SDK .NET 6.0.100 sera également disponible dans le SDK .NET 6.0.101, le SDK .NET 6.0.200, etc. Toutefois, ces packages de modèle ne seront pas disponibles dans les versions du SDK .NET avant le SDK .NET 6.0.100. Pour utiliser un package de modèle installé dans le SDK .NET 6.0.100 ou version ultérieure dans les versions antérieures du SDK .NET, vous devez l’installer à l’aide de dotnet new install dans cette version du SDK .NET.

Notes

À compter du SDK .NET 7, la syntaxe dotnet new a changé :

  • Les options --list, --search, --install et --uninstall sont devenues les sous-commandes list, search, install et uninstall.
  • L’option --update-apply est devenue la sous-commande update.
  • Pour utiliser --update-check, utilisez la sous-commande update avec l’option --check-only.

D’autres options disponibles avant sont toujours disponibles pour être utilisées avec leurs sous-commandes respectives. Une aide distincte pour chaque sous-commande est disponible via l’option -h ou l’option --help : dotnet new <subcommand> --help répertorie toutes les options prises en charge pour la sous-commande.

En outre, la saisie semi-automatique est désormais disponible pour dotnet new. Elle prend en charge la saisie semi-automatique pour les noms de modèles installés et pour les options fournies par le modèle sélectionné. Pour activer la saisie semi-automatique dans le SDK .NET, consultez Activer la saisie semi-automatique.

Exemples d’ancienne syntaxe :

  • Installez la dernière version du package de modèle de projet de travaux web Azure :

    dotnet new --install Microsoft.Azure.WebJobs.ProjectTemplates

Arguments

  • <PATH|NUGET_ID>

    Le dossier sur le système de fichiers ou l’identificateur du package NuGet à partir duquel installer le package. dotnet new tente d’installer le package NuGet à partir des sources NuGet disponibles pour le répertoire de travail actuel et les sources spécifiées via l’option --add-source. Si vous souhaitez installer une version spécifique ou une préversion d’un package de modèle à partir de la source NuGet, spécifiez la version au format <package-name>::<package-version>.

Options

  • --add-source|--nuget-source <SOURCE>

    Par défaut, dotnet new install utilise la hiérarchie des fichiers de configuration NuGet à partir du répertoire actif pour déterminer la source NuGet à partir de laquelle le package peut être installé. Si --nuget-source est spécifié, la source est ajoutée à la liste des sources à vérifier.
    Pour vérifier les sources configurées pour le répertoire actif, utilisez dotnet nuget list source. Pour plus d’informations, consultez Configurations NuGet courantes

    Notes

    À la suite de l’initiative Https Everywhere de NuGet, dotnet new supprime progressivement les flux http. Si un flux http est passé, il n’est pas interrogé pour les packages, et un avertissement s’affiche. L’option --force peut si nécessaire être utilisée pour remplacer ce comportement.

  • -d|--diagnostics

    Active la sortie de diagnostic. Disponible depuis le SDK .NET 7.0.100.

  • --force

    Permet d’installer des packages de modèles à partir des sources spécifiées, même si elles remplaceraient un package de modèles issu d’une autre source. Disponible depuis le SDK .NET 7.0.100.

  • -h|--help

    Affiche l’aide pour la commande install. Disponible depuis le SDK .NET 7.0.100.

  • --interactive

    Permet à la commande de s’arrêter et d’attendre une action ou une entrée utilisateur. Par exemple, pour effectuer une authentification. Disponible depuis le SDK .NET 5.0.

  • -v|--verbosity <LEVEL>

    Définit le niveau de détail de la commande. Les valeurs autorisées sont q[uiet], m[inimal], n[ormal] et diag[nostic]. Disponible depuis le SDK .NET 7.0.100.

Exemples

  • Installez la dernière version des modèles SPA pour ASP.NET Core :

    dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates

  • Installez la version 2.0 des modèles SPA pour ASP.NET Core :

    dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0

  • Installez la version 2.0 des modèles SPA pour ASP.NET Core à partir d’une source NuGet personnalisée en mode interactif :

    dotnet new --install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0 --add-source "https://api.my-custom-nuget.com/v3/index.json" --interactive

Voir aussi