dotnet nuevo instalar

Este artículo se aplica a: ✔️ .NET 6 SDK 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] [--prerelease]
    [-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>. (El separador de dos puntos :: ha quedado en desuso en favor del @ carácter en el SDK de .NET 9.0.200). De forma predeterminada, dotnet new pasa * para la versión, que representa la versión del paquete estable más reciente. 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 menos que especifique la --prerelease opción . 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

Advertencia

Las plantillas pueden ejecutar código de MSBuild y otro código arbitrario cuando se desencadena. No instale ni ejecute plantillas de .NET que no sean de confianza.

Comprobación de firma de paquete

Cuando la comprobación de firmas está habilitada, dotnet new install comprueba los paquetes de plantilla firmados descargados de orígenes de NuGet antes de la instalación. La comprobación se aplica a orígenes NuGet configurados y adicionales, pero no a los paquetes instalados directamente desde un archivo o carpeta local .nupkg .

La comprobación depende del sistema operativo:

Sistema operativo Comportamiento predeterminado Configuración
Windows Enabled No se puede deshabilitar con DOTNET_NUGET_SIGNATURE_VERIFICATION.
Linux Enabled Establézcalo DOTNET_NUGET_SIGNATURE_VERIFICATION=false en deshabilitar la comprobación.
macOS Disabled Establézcalo DOTNET_NUGET_SIGNATURE_VERIFICATION=true para habilitar la comprobación. Consulte Comprobación de paquetes firmados de NuGet para ver las limitaciones de la plataforma.

Cuando la comprobación está habilitada, los paquetes sin firmar se aceptan a menos que la configuración de NuGet aplicable establezca en signatureValidationModerequireo el origen declare que todos sus paquetes están firmados por el repositorio. Para obtener información sobre cómo configurar la directiva de cliente, vea signatureValidationMode.

Si se produce un error en la comprobación de firmas, el paquete no está instalado. La --force opción no omite la comprobación de firmas. Ejecute el comando con --diagnostics para ver los detalles de la comprobación. Para conocer los requisitos del almacén de certificados y la solución de problemas, consulte Comprobación del paquete firmado de NuGet. También puede comprobar un paquete descargado explícitamente con dotnet nuget verify.

La comprobación correcta no garantiza que una plantilla sea segura para ejecutarse. Para obtener más información sobre este cambio de comportamiento y las bandas de características afectadas del SDK, consulte Instalación de paquetes de plantilla que comprueba las firmas de NuGet.

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 --add-source opción . 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>. (El separador de dos puntos :: ha quedado en desuso en favor del @ carácter en el SDK de .NET 9.0.200).

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 los orígenes de NuGet para la operación. Especifique --nuget-source para usar un origen además de los orígenes configurados. Para comprobar los orígenes configurados para el 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.

    Esta opción no omite la comprobación de la firma del paquete.

  • -?|-h|--help

    Imprime una descripción de cómo usar el comando .

  • --interactive

    Permite que el comando se detenga y espere a la entrada o acción del usuario. Por ejemplo, para completar la autenticación.

  • --prerelease

    Selecciona la versión más reciente disponible, incluidas las versiones preliminares, cuando no se especifica una versión de paquete de plantilla. Si especifica una versión del paquete, como Contoso.Templates@2.0.0-preview.3, el comando selecciona esa versión exacta. Disponible desde .NET SDK 11.

  • -v|--verbosity <LEVEL>

    Establece el nivel de detalle del comando. Los valores permitidos son q[uiet], m[inimal], n[ormal], d[etailed] y diag[nostic]. Para obtener más información, consulte LoggerVerbosity.

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

  • Darrera actualització el