dotnet new install

Artículo
03/21/2023

Este artículo se aplica a: ✔️ SDK de .NET Core 3.1 y versiones posteriores

Name

dotnet new install: instala un paquete de plantilla.

Sinopsis

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

Descripción

El comando dotnet new install instala un paquete de plantilla desde PATH o NUGET_ID proporcionado. Si quiere instalar una versión específica o la versión preliminar de un paquete de plantillas, especifique la versión en el formato <package-name>::<package-version>. De manera predeterminada, dotnet new pasa * para la versión, que representa la última versión estable del paquete. Para obtener más información, vea la sección Ejemplos.

Si ya hay instalada una versión del paquete de plantillas al ejecutar este comando, ese paquete se actualiza a la versión especificada. Si no se especifica ninguna versión, el paquete se actualiza a la versión estable más reciente. A partir del SDK de .NET 6.0.100, si el argumento especifica la versión y esa versión del paquete NuGet ya está instalada, no se vuelve a instalar. Si un argumento es PATH y ya está instalado, no se vuelve a instalar.

Antes del SDK de .NET 6.0.100, los paquetes de plantillas se administraban de forma individual para cada versión del SDK de .NET, incluidas las versiones de revisión. Por ejemplo, si se instala el paquete de plantillas mediante dotnet new --install en el SDK de .NET 5.0.100, solo se instala para el SDK de .NET 5.0.100. Las plantillas del paquete no estarán disponibles en otras versiones del SDK de .NET instaladas en la máquina.

A partir del SDK de .NET 6.0.100, los paquetes de plantillas instalados están disponibles en las versiones posteriores del SDK de .NET instalados en el equipo. Un paquete de plantillas instalado en el SDK de .NET 6.0.100 también está disponible en el SDK de .NET 6.0.101, el SDK de .NET 6.0.200, etc. Pero estos paquetes de plantillas no están disponibles en las versiones del SDK de .NET anteriores al SDK de .NET 6.0.100. Para usar un paquete de plantillas instalado en el SDK de .NET 6.0.100 o posterior en versiones anteriores del SDK de .NET, debe instalarlo mediante dotnet new install en esa versión del SDK de .NET.

Nota

A partir del SDK de .NET 7, la sintaxis dotnet new ha cambiado:

Las opciones --list, --search, --install y --uninstall se han convertido en los subcomandos list, search, install y uninstall.
La opción --update-apply se ha convertido en el subcomando update.
Para usar --update-check, utilice el subcomando update con la opción --check-only.

Otras opciones que estaban disponibles antes siguen estando disponibles para su uso con sus respectivos subcomandos. Hay ayuda independiente disponible para cada subcomando mediante la opción -h o --help: dotnet new <subcommand> --help enumera todas las opciones admitidas para el subcomando.

Además, la finalización con tabulación ya está disponible para dotnet new. Admite la finalización de nombres de plantillas instaladas y para las opciones que proporciona una plantilla seleccionada. Para activar la finalización con tabulación para el SDK de .NET, vea Habilitación de la finalización con tabulación.

Ejemplos de sintaxis antigua:

Instalar la versión más reciente del paquete de plantillas de proyecto de trabajos web de Azure:
```
dotnet new --install Microsoft.Azure.WebJobs.ProjectTemplates
```

Argumentos

<PATH|NUGET_ID>

La carpeta del sistema de archivos o el identificador del paquete NuGet desde donde instalar el paquete de plantilla. dotnet new intenta instalar el paquete NuGet desde los orígenes de NuGet disponibles para el directorio de trabajo actual y los orígenes especificados a través de la opción --add-source. Si quiere instalar una versión específica o la versión preliminar de un paquete de plantillas desde el origen de NuGet, especifique la versión en el formato <package-name>::<package-version>.

Opciones

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

De forma predeterminada, dotnet new install usa la jerarquía de archivos de configuración de NuGet del directorio actual para determinar el origen de NuGet desde el que se puede instalar el paquete. Si se especifica --nuget-source, el origen se agregará a la lista de orígenes que se van a comprobar.
Para comprobar los orígenes configurados para el directorio actual, use dotnet nuget list source. Para más información, consulte Configuraciones comunes de NuGet.

Nota

Después de la iniciativa Https Everywhere de NuGet, dotnet new está eliminando gradualmente las fuentes http. Si se pasa una fuente http, no se consultan los paquetes y se muestra una advertencia. La opción --force se puede usar para invalidar este comportamiento si es necesario.
-d|--diagnostics

Habilita la salida de diagnóstico. Disponible a partir del SDK de .NET 7.0.100.
--force

Permite instalar paquetes de plantillas desde los orígenes especificados, incluso si invalidarían un paquete de plantillas de otro origen. Disponible a partir del SDK de .NET 7.0.100.
-h|--help

Imprime la ayuda para el comando de instalación. Disponible a partir del SDK de .NET 7.0.100.

--interactive

Permite que el comando se detenga y espere una entrada o una acción del usuario. Por ejemplo, para completar la autenticación. Disponible a partir del SDK de .NET 5.0.

-v|--verbosity <LEVEL>

Establece el nivel de detalle del comando. Los valores permitidos son q[uiet], m[inimal], n[ormal] y diag[nostic]. Disponible a partir del SDK de .NET 7.0.100.

Ejemplos

Instalación de la versión más reciente de las plantillas de SPA para ASP.NET Core:
```
dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates
```
Instalación de la versión 2.0 de las plantillas de SPA de ASP.NET Core:
```
dotnet new install Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0
```

Instale la versión 2.0 de las plantillas SPA para ASP.NET Core desde un origen de NuGet personalizado mediante el modo interactivo:

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