dotnet new install

Article
01/29/2025

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 de l'PATH ou du NUGET_ID fourni. Si vous souhaitez installer une version spécifique ou une version préliminaire 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èles ont été gérés individuellement pour chaque version du Kit de développement logiciel (SDK) .NET, y compris les versions de correctifs . Par exemple, si vous installez le package de modèle à l’aide de dotnet new --install dans le Kit de développement logiciel (SDK) .NET 5.0.100, il est installé uniquement pour le Kit de développement logiciel (SDK) .NET 5.0.100. Les modèles du package ne seront pas disponibles dans d’autres versions du Kit de développement logiciel (SDK) .NET installées sur votre ordinateur.

À compter du Kit de développement logiciel (SDK) .NET 6.0.100, les packages de modèles 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 Kit de développement logiciel (SDK) .NET 6.0.100 sera également disponible dans .NET SDK 6.0.101, .NET SDK 6.0.200, et ainsi de suite. Toutefois, ces packages de modèles ne seront pas disponibles dans les versions du Kit de développement logiciel (SDK) .NET avant .NET SDK 6.0.100. Pour utiliser un package de modèle installé dans le Kit de développement logiciel (SDK) .NET 6.0.100 ou version ultérieure dans les versions antérieures du Kit de développement logiciel (SDK) .NET, vous devez l’installer à l’aide de dotnet new install dans cette version du Kit de développement logiciel (SDK) .NET.

Note

À compter du Kit de développement logiciel (SDK) .NET 7, la syntaxe dotnet new a changé :

Les options --list, --search, --installet --uninstall deviennent list, search, installet sous-commandes 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 --help : dotnet new <subcommand> --help répertorie toutes les options prises en charge pour la sous-commande.

En outre, la saisie semi-automatique de tabulation est désormais disponible pour dotnet new. Il prend en charge la saisie semi-automatique pour les noms de modèles installés et pour les options qu’un modèle sélectionné fournit. Pour activer la saisie semi-automatique des onglets pour le Kit de développement logiciel (SDK) .NET, consultez Activer la saisie semi-automatique des onglets.

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>

Dossier du système de fichiers ou de l’identificateur de package NuGet à partir duquel installer le package de modèle. 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 version préliminaire 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.

Note

Après 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 être utilisée pour remplacer ce comportement si nécessaire.
-d|--diagnostics

Active la sortie de diagnostic. Disponible depuis .NET SDK 7.0.100.
--force

Permet d’installer des packages de modèles à partir des sources spécifiées, même s’ils remplacent un package de modèle à partir d’une autre source. Disponible depuis .NET SDK 7.0.100.
-h|--help

Imprime l’aide pour la commande d’installation. Disponible depuis .NET SDK 7.0.100.

--interactive

Permet à la commande d’arrêter et d’attendre l’entrée ou l’action de l’utilisateur. Par exemple, pour terminer l’authentification. Disponible depuis le KIT 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 .NET SDK 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

Partager via