Compartir a través de

dotnet new install

  • Artículo

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

Nombre

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 el PATH o NUGET_ID proporcionado. Si desea instalar una versión específica o una versión preliminar de un paquete de plantilla, especifique la versión con el formato <package-name>::<package-version>. De forma predeterminada, dotnet new pasa * para la versión, que representa la versión más reciente del paquete estable. Para obtener más información, consulte la sección Ejemplos de.

Si ya se instaló una versión del paquete de plantilla al ejecutar este comando, el paquete de plantilla se actualizará 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 reinstalará. Si el argumento es un PATH y ya está instalado, no se reinstalará.

Antes del SDK de .NET 6.0.100, los paquetes de plantilla se administraban individualmente para cada versión del SDK de .NET, incluidas las versiones de revisión de . Por ejemplo, si instala el paquete de plantilla mediante dotnet new --install en el SDK de .NET 5.0.100, solo se instalará 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 el equipo.

A partir del SDK de .NET 6.0.100, los paquetes de plantilla instalados están disponibles en versiones posteriores del SDK de .NET instaladas en la máquina. Un paquete de plantilla instalado en el SDK de .NET 6.0.100 también estará disponible en el SDK de .NET 6.0.101, EL SDK de .NET 6.0.200, etc. Sin embargo, estos paquetes de plantilla no estarán disponibles en las versiones del SDK de .NET anteriores a .NET SDK 6.0.100. Para usar un paquete de plantilla 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 de dotnet new ha cambiado:

  • Las opciones --list, --search, --instally --uninstall se convirtieron en list, search, instally uninstall subcomandos.
  • La opción --update-apply se convirtió en el subcomando update.
  • Para usar --update-check, use el subcomando update con la opción --check-only.

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

Además, la finalización de tabulación ya está disponible para dotnet new. Admite la finalización de nombres de plantilla instalados y para las opciones que proporciona una plantilla seleccionada. Para activar la finalización de tabulación para el SDK de .NET, consulte Habilitar finalización de pestañas.

Ejemplos de sintaxis antigua:

  • Instale 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 la que 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 desea instalar una versión específica o una versión preliminar de un paquete de plantilla desde el origen de NuGet, especifique la versión con 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 desde el 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 del directorio actual, use dotnet nuget list source. Para obtener 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 de http. Si se pasa una fuente de http, no se consulta para 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 desde el SDK de .NET 7.0.100.

  • --force

    Permite instalar paquetes de plantilla desde los orígenes especificados incluso si invalidarían un paquete de plantilla de otro origen. Disponible desde el SDK de .NET 7.0.100.

  • -h|--help

    Imprime la ayuda para el comando de instalación. Disponible desde el SDK de .NET 7.0.100.

  • --interactive

    Permite que el comando se detenga y espere a la entrada o acción del usuario. Por ejemplo, para completar la autenticación. Disponible desde el 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 desde el SDK de .NET 7.0.100.

Ejemplos

  • Instale la versión más reciente de las plantillas de SPA para ASP.NET Core:

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

  • Instale la versión 2.0 de las plantillas de SPA para ASP.NET Core:

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

  • Instale la versión 2.0 de las plantillas de 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

Consulte también