dotnet new install
Este artículo se aplica a: ✔️ SDK de .NET Core 3.1 y versiones posteriores
dotnet new install
: instala un paquete de plantilla.
dotnet new install <PATH|NUGET_ID> [--interactive] [--add-source|--nuget-source <SOURCE>] [--force]
[-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]
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 subcomandoslist
,search
,install
yuninstall
. - La opción
--update-apply
se ha convertido en el subcomandoupdate
. - Para usar
--update-check
, utilice el subcomandoupdate
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
<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>
.
--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, usedotnet 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 fuenteshttp
. Si se pasa una fuentehttp
, 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]
ydiag[nostic]
. Disponible a partir del SDK de .NET 7.0.100.
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
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: