dotnet newdotnet new

Este artículo se aplica a: ✔️ SDK de .NET Core 2.0 y versiones posterioresThis article applies to: ✔️ .NET Core 2.0 SDK and later versions

NOMBREName

dotnet new: crea un nuevo proyecto, archivo de configuración o solución según la plantilla especificada.dotnet new - Creates a new project, configuration file, or solution based on the specified template.

SinopsisSynopsis

dotnet new <TEMPLATE> [--dry-run] [--force] [-i|--install {PATH|NUGET_ID}]
    [-lang|--language {"C#"|"F#"|VB}] [-n|--name <OUTPUT_NAME>]
    [--nuget-source <SOURCE>] [-o|--output <OUTPUT_DIRECTORY>]
    [-u|--uninstall] [--update-apply] [--update-check] [Template options]

dotnet new <TEMPLATE> [-l|--list] [--type <TYPE>]

dotnet new -h|--help

DescripciónDescription

El comando dotnet new crea un proyecto de .NET Core u otros artefactos basados en una plantilla.The dotnet new command creates a .NET Core project or other artifacts based on a template.

El comando llama al motor de plantillas para crear los artefactos en el disco basándose en las opciones y la plantilla especificadas.The command calls the template engine to create the artifacts on disk based on the specified template and options.

Restauración implícitaImplicit restore

No es necesario ejecutar dotnet restore porque lo ejecutan implícitamente todos los comandos que necesitan que se produzca una restauración, como dotnet new, dotnet build, dotnet run, dotnet test, dotnet publish y dotnet pack.You don't have to run dotnet restore because it's run implicitly by all commands that require a restore to occur, such as dotnet new, dotnet build, dotnet run, dotnet test, dotnet publish, and dotnet pack. Para deshabilitar la restauración implícita, use la opción --no-restore.To disable implicit restore, use the --no-restore option.

El comando dotnet restore sigue siendo válido en algunos escenarios donde tiene sentido realizar una restauración explícita, como las compilaciones de integración continua en Azure DevOps Services o en los sistemas de compilación que necesitan controlar explícitamente cuándo se produce la restauración.The dotnet restore command is still useful in certain scenarios where explicitly restoring makes sense, such as continuous integration builds in Azure DevOps Services or in build systems that need to explicitly control when the restore occurs.

Para obtener información sobre cómo administrar fuentes de NuGet, vea la documentación de dotnet restore.For information about how to manage NuGet feeds, see the dotnet restore documentation.

ArgumentosArguments

  • TEMPLATE

    La plantilla de la que se va a crear una instancia cuando se invoca el comando.The template to instantiate when the command is invoked. Cada plantilla puede tener opciones específicas que puede pasar.Each template might have specific options you can pass. Para obtener más información, vea Opciones de plantilla.For more information, see Template options.

    Puede ejecutar dotnet new --list o dotnet new -l para ver una lista de todas las plantillas instaladas.You can run dotnet new --list or dotnet new -l to see a list of all installed templates. Si el valor TEMPLATE no es una coincidencia exacta con el texto de la columna Plantillas o Nombre corto de la tabla devuelta, se realiza una coincidencia de subcadena con esas dos columnas.If the TEMPLATE value isn't an exact match on text in the Templates or Short Name column from the returned table, a substring match is performed on those two columns.

    A partir del SDK de .NET Core 3.0, la CLI busca plantillas en NuGet.org al invocar el comando dotnet new en las siguientes condiciones:Starting with .NET Core 3.0 SDK, the CLI searches for templates in NuGet.org when you invoke the dotnet new command in the following conditions:

    • Si la CLI no encuentra ninguna coincidencia de plantilla al invocar dotnet new, ni siquiera parcial.If the CLI can't find a template match when invoking dotnet new, not even partial.
    • Si hay disponible una versión más reciente de la plantilla.If there's a newer version of the template available. En este caso, se crea el proyecto o el artefacto, pero la CLI le advierte de que hay una versión actualizada de la plantilla.In this case, the project or artifact is created but the CLI warns you about an updated version of the template.

    En la tabla siguiente se muestran las plantillas que vienen preinstaladas en el SDK de .NET Core.The following table shows the templates that come pre-installed with the .NET Core SDK. El lenguaje predeterminado de la plantilla se muestra entre corchetes.The default language for the template is shown inside the brackets. Haga clic en el vínculo del nombre corto para ver las opciones específicas de la plantilla.Click on the short name link to see the specific template options.

PlantillasTemplates Nombre cortoShort name LenguajeLanguage EtiquetasTags InclusiónIntroduced
Aplicación de consolaConsole Application consoleconsole [C#], F#, VB[C#], F#, VB Común/ConsolaCommon/Console 1.01.0
Biblioteca de clasesClass library classlibclasslib [C#], F#, VB[C#], F#, VB Común/BibliotecaCommon/Library 1.01.0
Aplicación WPFWPF Application wpfwpf [C#], VB[C#], VB Común/WPFCommon/WPF 3.0 (5.0 para VB)3.0 (5.0 for VB)
Biblioteca de clases de WPFWPF Class library wpflibwpflib [C#], VB[C#], VB Común/WPFCommon/WPF 3.0 (5.0 para VB)3.0 (5.0 for VB)
Biblioteca de controles personalizados WPFWPF Custom Control Library wpfcustomcontrollibwpfcustomcontrollib [C#], VB[C#], VB Común/WPFCommon/WPF 3.0 (5.0 para VB)3.0 (5.0 for VB)
Biblioteca de controles de usuario de WPFWPF User Control Library wpfusercontrollibwpfusercontrollib [C#], VB[C#], VB Común/WPFCommon/WPF 3.0 (5.0 para VB)3.0 (5.0 for VB)
Aplicación de Windows Forms (WinForms)Windows Forms (WinForms) Application winformswinforms [C#], VB[C#], VB Común/WinFormsCommon/WinForms 3.0 (5.0 para VB)3.0 (5.0 for VB)
Biblioteca de clases de Windows Forms (WinForms)Windows Forms (WinForms) Class library winformslibwinformslib [C#], VB[C#], VB Común/WinFormsCommon/WinForms 3.0 (5.0 para VB)3.0 (5.0 for VB)
Servicio WorkerWorker Service workerworker [C#][C#] Común/Worker/WebCommon/Worker/Web 3.03.0
Proyecto de prueba unitariaUnit Test Project mstestmstest [C#], F#, VB[C#], F#, VB Prueba/MSTestTest/MSTest 1.01.0
Proyecto de prueba de NUnit 3NUnit 3 Test Project nunitnunit [C#], F#, VB[C#], F#, VB Prueba/NUnitTest/NUnit 2.1.4002.1.400
Elemento de prueba de NUnit 3NUnit 3 Test Item nunit-test [C#], F#, VB[C#], F#, VB Prueba/NUnitTest/NUnit 2.22.2
Proyecto de prueba de xUnitxUnit Test Project xunitxunit [C#], F#, VB[C#], F#, VB Prueba/xUnitTest/xUnit 1.01.0
Componente RazorRazor Component razorcomponent [C#][C#] Web/ASP.NETWeb/ASP.NET 3.03.0
Página de RazorRazor Page pagepage [C#][C#] Web/ASP.NETWeb/ASP.NET 2.02.0
MVC ViewImportsMVC ViewImports viewimportsviewimports [C#][C#] Web/ASP.NETWeb/ASP.NET 2.02.0
MVC ViewStartMVC ViewStart viewstart [C#][C#] Web/ASP.NETWeb/ASP.NET 2.02.0
Blazor Aplicación de servidorBlazor Server App blazorserverblazorserver [C#][C#] Web/BlazorWeb/Blazor 3.03.0
Aplicación de Blazor WebAssemblyBlazor WebAssembly App blazorwasm [C#][C#] Web/Blazor/WebAssemblyWeb/Blazor/WebAssembly 3.1.3003.1.300
Vacío de ASP.NET CoreASP.NET Core Empty webweb [C#], F#[C#], F# Web/VacíoWeb/Empty 1.01.0
Aplicación web de ASP.NET Core (Model-View-Controller)ASP.NET Core Web App (Model-View-Controller) mvcmvc [C#], F#[C#], F# Web/MVCWeb/MVC 1.01.0
Aplicación web de ASP.NET CoreASP.NET Core Web App webapp, razorwebapp, razor [C#][C#] Web/MVC/Razor PagesWeb/MVC/Razor Pages 2.2, 2.02.2, 2.0
ASP.NET Core con AngularASP.NET Core with Angular angularangular [C#][C#] Web/MVC/SPAWeb/MVC/SPA 2.02.0
ASP.NET Core con React.jsASP.NET Core with React.js reactreact [C#][C#] Web/MVC/SPAWeb/MVC/SPA 2.02.0
ASP.NET Core con React.js y ReduxASP.NET Core with React.js and Redux reactreduxreactredux [C#][C#] Web/MVC/SPAWeb/MVC/SPA 2.02.0
Biblioteca de clases de RazorRazor Class Library razorclasslibrazorclasslib [C#][C#] Web/Razor/Biblioteca/Biblioteca de clases de RazorWeb/Razor/Library/Razor Class Library 2.12.1
API web de ASP.NET CoreASP.NET Core Web API webapiwebapi [C#], F#[C#], F# Web/WebAPIWeb/WebAPI 1.01.0
Servicio gRPC de ASP.NET CoreASP.NET Core gRPC Service grpcgrpc [C#][C#] Web/gRPCWeb/gRPC 3.03.0
Archivo dotnet gitignoredotnet gitignore file gitignore ConfiguraciónConfig 3.03.0
archivo global.jsonglobal.json file globaljsonglobaljson ConfiguraciónConfig 2.02.0
Configuración de NuGetNuGet Config nugetconfig ConfiguraciónConfig 1.01.0
Archivo de manifiesto de la herramienta local dotnetDotnet local tool manifest file tool-manifest ConfiguraciónConfig 3.03.0
Configuración webWeb Config webconfig ConfiguraciónConfig 1.01.0
Archivo de soluciónSolution File sln SolucionesSolution 1.01.0
Archivo de búfer de protocoloProtocol Buffer File protoproto Web/gRPCWeb/gRPC 3.03.0

OpcionesOptions

  • --dry-run

    Muestra un resumen de lo que sucedería si se ejecutara el comando determinado y el resultado fuera la creación de una plantilla.Displays a summary of what would happen if the given command were run if it would result in a template creation. Disponible a partir del SDK de .NET Core 2.2.Available since .NET Core 2.2 SDK.

  • --force

    Fuerza la generación de contenido incluso aunque se vayan a cambiar los archivos existentes.Forces content to be generated even if it would change existing files. Es necesario si la plantilla elegida invalidará los archivos existentes en el directorio de salida.This is required when the template chosen would override existing files in the output directory.

  • -h|--help

    Imprime la ayuda para el comando.Prints out help for the command. Puede invocarse para el propio comando dotnet new o para cualquier plantilla.It can be invoked for the dotnet new command itself or for any template. Por ejemplo: dotnet new mvc --help.For example, dotnet new mvc --help.

  • -i|--install <PATH|NUGET_ID>

    Instala un paquete de plantillas desde los parámetros PATH o NUGET_ID proporcionados.Installs a template pack from the PATH or NUGET_ID provided. Si quiere instalar una versión preliminar de un paquete de plantilla, tendrá que especificar la versión en el formato de <package-name>::<package-version>.If you want to install a prerelease version of a template package, you need to specify the version in the format of <package-name>::<package-version>. De forma predeterminada, dotnet new pasa * para la versión, que representa la última versión estable del paquete.By default, dotnet new passes * for the version, which represents the latest stable package version. Vea un ejemplo en la sección Ejemplos.See an example in the Examples section.

    Si ya hay instalada una versión de la plantilla al ejecutar este comando, la plantilla se actualizará a la versión especificada o a la versión estable más reciente si no se ha especificado ninguna versión.If a version of the template was already installed when you run this command, the template will be updated to the specified version, or to the latest stable version if no version was specified.

    Para obtener información sobre cómo crear plantillas personalizadas, consulte Plantillas personalizadas para dotnet new.For information on creating custom templates, see Custom templates for dotnet new.

  • -l|--list

    Muestra las plantillas que contienen el nombre especificado.Lists templates containing the specified name. Si no se especifica ningún nombre, enumera todas las plantillas.If no name is specified, lists all templates.

  • -lang|--language {C#|F#|VB}

    El lenguaje de la plantilla que se va a crear.The language of the template to create. El lenguaje aceptado cambia según la plantilla (vea los valores predeterminados en la sección argumentos).The language accepted varies by the template (see defaults in the arguments section). No es válido para algunas plantillas.Not valid for some templates.

    Nota

    Algunos shells interpretan # como un carácter especial.Some shells interpret # as a special character. En esos casos, incluya el valor del parámetro de lenguaje entre comillas.In those cases, enclose the language parameter value in quotes. Por ejemplo: dotnet new console -lang "F#".For example, dotnet new console -lang "F#".

  • -n|--name <OUTPUT_NAME>

    El nombre de la salida creada.The name for the created output. Si no se especifica ningún nombre, se usa el nombre del directorio actual.If no name is specified, the name of the current directory is used.

  • --nuget-source <SOURCE>

    Especifica un origen de NuGet para usarlo durante la instalación.Specifies a NuGet source to use during install. Disponible a partir del SDK de .NET Core 2.1.Available since .NET Core 2.1 SDK.

  • -o|--output <OUTPUT_DIRECTORY>

    La ubicación para colocar la salida generada.Location to place the generated output. El valor predeterminado es el directorio actual.The default is the current directory.

  • --type <TYPE>

    Filtra plantillas en función de los tipos disponibles.Filters templates based on available types. Los valores predefinidos son project, item y other.Predefined values are project, item, and other.

  • -u|--uninstall [PATH|NUGET_ID]

    Desinstala un paquete de plantillas en los parámetros PATH o NUGET_ID proporcionados.Uninstalls a template pack at the PATH or NUGET_ID provided. Si no se especifica el valor <PATH|NUGET_ID>, se muestran todos los paquetes de plantillas instalados actualmente y sus plantillas asociadas.When the <PATH|NUGET_ID> value isn't specified, all currently installed template packs and their associated templates are displayed. Al especificar NUGET_ID, no incluya el número de versión.When specifying NUGET_ID, don't include the version number.

    Si no especifica un parámetro en esta opción, el comando muestra las plantillas instaladas y detalles sobre ellas.If you don't specify a parameter to this option, the command lists the installed templates and details about them.

    Nota

    Para desinstalar una plantilla mediante PATH, debe usar el nombre completo de la ruta de acceso.To uninstall a template using a PATH, you need to fully qualify the path. Por ejemplo, C:/Users/<USER>/Documents/Templates/GarciaSoftware.ConsoleTemplate.CSharp funcionará, pero ./GarciaSoftware.ConsoleTemplate.CSharp desde la carpeta contenedora no lo hará.For example, C:/Users/<USER>/Documents/Templates/GarciaSoftware.ConsoleTemplate.CSharp will work, but ./GarciaSoftware.ConsoleTemplate.CSharp from the containing folder will not. No incluya ninguna barra diagonal para finalizar el directorio en la ruta de acceso a la plantilla.Don't include a final terminating directory slash on your template path.

  • --update-apply

    Comprueba si hay actualizaciones disponibles de los paquetes de plantillas instalados actualmente y las instala.Checks if there are updates available for the template packs that are currently installed and installs them. Disponible desde el SDK de .NET Core 3.0.Available since .NET Core 3.0 SDK.

  • --update-check

    Comprueba si hay actualizaciones disponibles de los paquetes de plantillas instalados actualmente.Checks if there are updates available for the template packs that are currently installed. Disponible desde el SDK de .NET Core 3.0.Available since .NET Core 3.0 SDK.

Opciones de plantillaTemplate options

Cada plantilla de proyecto puede tener opciones adicionales disponibles.Each project template may have additional options available. Las plantillas principales tienen las siguientes opciones adicionales:The core templates have the following additional options:

consolaconsole

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino.Specifies the framework to target. Disponible desde el SDK de .NET Core 3.0.Available since .NET Core 3.0 SDK.

    En la tabla siguiente se enumeran los valores predeterminados según el número de versión del SDK que esté usando:The following table lists the default values according to the SDK version number you're using:

    Versión del SDKSDK version Valor predeterminadoDefault value
    3.13.1 netcoreapp3.1
    3.03.0 netcoreapp3.0
  • --langVersion <VERSION_NUMBER>

    Establece la propiedad LangVersion en el archivo del proyecto creado.Sets the LangVersion property in the created project file. Por ejemplo, use --langVersion 7.3 para emplear C# 7.3.For example, use --langVersion 7.3 to use C# 7.3. No es compatible con F#.Not supported for F#. Disponible a partir del SDK de .NET Core 2.2.Available since .NET Core 2.2 SDK.

    Para obtener una lista de las versiones predeterminadas de C#, vea Valores predeterminados.For a list of default C# versions, see Defaults.

  • --no-restore

    Si se especifica, no se ejecuta ninguna restauración implícita durante la creación del proyecto.If specified, doesn't execute an implicit restore during project creation. Disponible a partir del SDK de .NET Core 2.2.Available since .NET Core 2.2 SDK.


classlibclasslib

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino.Specifies the framework to target. Valores: netcoreapp<version> para crear una biblioteca de clases de .NET Core o netstandard<version> para crear una biblioteca de clases de .NET Standard.Values: netcoreapp<version> to create a .NET Core Class Library or netstandard<version> to create a .NET Standard Class Library. El valor predeterminado es netstandard2.0.The default value is netstandard2.0.

  • --langVersion <VERSION_NUMBER>

    Establece la propiedad LangVersion en el archivo del proyecto creado.Sets the LangVersion property in the created project file. Por ejemplo, use --langVersion 7.3 para emplear C# 7.3.For example, use --langVersion 7.3 to use C# 7.3. No es compatible con F#.Not supported for F#. Disponible a partir del SDK de .NET Core 2.2.Available since .NET Core 2.2 SDK.

    Para obtener una lista de las versiones predeterminadas de C#, vea Valores predeterminados.For a list of default C# versions, see Defaults.

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.Doesn't execute an implicit restore during project creation.


wpf, wpflib, wpfcustomcontrollib, wpfusercontrollibwpf, wpflib, wpfcustomcontrollib, wpfusercontrollib

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino.Specifies the framework to target. El valor predeterminado es netcoreapp3.1.The default value is netcoreapp3.1. Disponible a partir del SDK de .NET Core 3.1.Available since .NET Core 3.1 SDK.

  • --langVersion <VERSION_NUMBER>

    Establece la propiedad LangVersion en el archivo del proyecto creado.Sets the LangVersion property in the created project file. Por ejemplo, use --langVersion 7.3 para emplear C# 7.3.For example, use --langVersion 7.3 to use C# 7.3.

    Para obtener una lista de las versiones predeterminadas de C#, vea Valores predeterminados.For a list of default C# versions, see Defaults.

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.Doesn't execute an implicit restore during project creation.


winforms, winformslibwinforms, winformslib

  • --langVersion <VERSION_NUMBER>

    Establece la propiedad LangVersion en el archivo del proyecto creado.Sets the LangVersion property in the created project file. Por ejemplo, use --langVersion 7.3 para emplear C# 7.3.For example, use --langVersion 7.3 to use C# 7.3.

    Para obtener una lista de las versiones predeterminadas de C#, vea Valores predeterminados.For a list of default C# versions, see Defaults.

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.Doesn't execute an implicit restore during project creation.


worker, grpcworker, grpc

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino.Specifies the framework to target. El valor predeterminado es netcoreapp3.1.The default value is netcoreapp3.1. Disponible a partir del SDK de .NET Core 3.1.Available since .NET Core 3.1 SDK.

  • --exclude-launch-settings

    Excluye launchSettings.json de la plantilla generada.Excludes launchSettings.json from the generated template.

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.Doesn't execute an implicit restore during project creation.


mstest, xunitmstest, xunit

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino.Specifies the framework to target. Opción disponible a partir del SDK de .NET Core 3.0.Option available since .NET Core 3.0 SDK.

    En la tabla siguiente se enumeran los valores predeterminados según el número de versión del SDK que esté usando:The following table lists the default values according to the SDK version number you're using:

    Versión del SDKSDK version Valor predeterminadoDefault value
    3.13.1 netcoreapp3.1
    3.03.0 netcoreapp3.0
  • -p|--enable-pack

    Habilita el empaquetado del proyecto mediante dotnet pack.Enables packaging for the project using dotnet pack.

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.Doesn't execute an implicit restore during project creation.


nunitnunit

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino.Specifies the framework to target.

    En la tabla siguiente se enumeran los valores predeterminados según el número de versión del SDK que esté usando:The following table lists the default values according to the SDK version number you're using:

    Versión del SDKSDK version Valor predeterminadoDefault value
    3.13.1 netcoreapp3.1
    3.03.0 netcoreapp3.0
    2.22.2 netcoreapp2.2
    2.12.1 netcoreapp2.1
  • -p|--enable-pack

    Habilita el empaquetado del proyecto mediante dotnet pack.Enables packaging for the project using dotnet pack.

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.Doesn't execute an implicit restore during project creation.


páginapage

  • -na|--namespace <NAMESPACE_NAME>

    Espacio de nombres del código generado.Namespace for the generated code. El valor predeterminado es MyApp.Namespace.The default value is MyApp.Namespace.

  • -np|--no-pagemodel

    Crea la página sin PageModel.Creates the page without a PageModel.


viewimports, protoviewimports, proto

  • -na|--namespace <NAMESPACE_NAME>

    Espacio de nombres del código generado.Namespace for the generated code. El valor predeterminado es MyApp.Namespace.The default value is MyApp.Namespace.


blazorserverblazorserver

  • -au|--auth <AUTHENTICATION_TYPE>

    Tipo de autenticación que se va a usar.The type of authentication to use. Los valores posibles son:The possible values are:

    • None: sin autenticación (valor predeterminado).None - No authentication (Default).
    • Individual: autenticación individual.Individual - Individual authentication.
    • IndividualB2C: autenticación individual con Azure AD B2C.IndividualB2C - Individual authentication with Azure AD B2C.
    • SingleOrg: autenticación organizativa para un solo inquilino.SingleOrg - Organizational authentication for a single tenant.
    • MultiOrg: autenticación organizativa para varios inquilinos.MultiOrg - Organizational authentication for multiple tenants.
    • Windows: autenticación de Windows.Windows - Windows authentication.
  • --aad-b2c-instance <INSTANCE>

    Instancia de Azure Active Directory B2C con la que se realiza la conexión.The Azure Active Directory B2C instance to connect to. Úsela con la autenticación IndividualB2C.Use with IndividualB2C authentication. El valor predeterminado es https://login.microsoftonline.com/tfp/.The default value is https://login.microsoftonline.com/tfp/.

  • -ssp|--susi-policy-id <ID>

    Identificador de la directiva de registro e inicio de sesión de este proyecto.The sign-in and sign-up policy ID for this project. Úsela con la autenticación IndividualB2C.Use with IndividualB2C authentication.

  • -rp|--reset-password-policy-id <ID>

    Identificador de la directiva de restablecimiento de contraseñas de este proyecto.The reset password policy ID for this project. Úsela con la autenticación IndividualB2C.Use with IndividualB2C authentication.

  • -ep|--edit-profile-policy-id <ID>

    Identificador de la directiva de edición de perfiles de este proyecto.The edit profile policy ID for this project. Úsela con la autenticación IndividualB2C.Use with IndividualB2C authentication.

  • --aad-instance <INSTANCE>

    Instancia de Azure Active Directory con la que se realiza la conexión.The Azure Active Directory instance to connect to. Úsela con las autenticaciones SingleOrg o MultiOrg.Use with SingleOrg or MultiOrg authentication. El valor predeterminado es https://login.microsoftonline.com/.The default value is https://login.microsoftonline.com/.

  • --client-id <ID>

    Identificador de cliente de este proyecto.The Client ID for this project. Úsela con las autenticaciones IndividualB2C, SingleOrg o MultiOrg.Use with IndividualB2C, SingleOrg, or MultiOrg authentication. El valor predeterminado es 11111111-1111-1111-11111111111111111.The default value is 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    Dominio del inquilino del directorio.The domain for the directory tenant. Úsela con las autenticaciones SingleOrg o IndividualB2C.Use with SingleOrg or IndividualB2C authentication. El valor predeterminado es qualified.domain.name.The default value is qualified.domain.name.

  • --tenant-id <ID>

    Identificador de inquilino del directorio con el que se realiza la conexión.The TenantId ID of the directory to connect to. Úsela con la autenticación SingleOrg.Use with SingleOrg authentication. El valor predeterminado es 22222222-2222-2222-2222-222222222222.The default value is 22222222-2222-2222-2222-222222222222.

  • --callback-path <PATH>

    Ruta de acceso de solicitud de la ruta de acceso de la base de la aplicación del URI de redirección.The request path within the application's base path of the redirect URI. Úsela con las autenticaciones SingleOrg o IndividualB2C.Use with SingleOrg or IndividualB2C authentication. El valor predeterminado es /signin-oidc.The default value is /signin-oidc.

  • -r|--org-read-access

    Concede a esta aplicación acceso de lectura al directorio.Allows this application read-access to the directory. Solo se aplica a las autenticaciones SingleOrg y MultiOrg.Only applies to SingleOrg or MultiOrg authentication.

  • --exclude-launch-settings

    Excluye launchSettings.json de la plantilla generada.Excludes launchSettings.json from the generated template.

  • --no-https

    Desactiva HTTPS.Turns off HTTPS. Esta opción solo se aplica si no se usan Individual, IndividualB2C, SingleOrg o MultiOrg en --auth.This option only applies if Individual, IndividualB2C, SingleOrg, or MultiOrg aren't being used for --auth.

  • -uld|--use-local-db

    Especifica que se debería usar LocalDB en vez de SQLite.Specifies LocalDB should be used instead of SQLite. Solo se aplica a las autenticaciones Individual y IndividualB2C.Only applies to Individual or IndividualB2C authentication.

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.Doesn't execute an implicit restore during project creation.


webweb

  • --exclude-launch-settings

    Excluye launchSettings.json de la plantilla generada.Excludes launchSettings.json from the generated template.

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino.Specifies the framework to target. Opción no disponible en el SDK de .NET Core 2.2.Option not available in .NET Core 2.2 SDK.

    En la tabla siguiente se enumeran los valores predeterminados según el número de versión del SDK que esté usando:The following table lists the default values according to the SDK version number you're using:

    Versión del SDKSDK version Valor predeterminadoDefault value
    3.13.1 netcoreapp3.1
    3.03.0 netcoreapp3.0
    2.12.1 netcoreapp2.1
  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.Doesn't execute an implicit restore during project creation.

  • --no-https

    Desactiva HTTPS.Turns off HTTPS.


mvc, webappmvc, webapp

  • -au|--auth <AUTHENTICATION_TYPE>

    Tipo de autenticación que se va a usar.The type of authentication to use. Los valores posibles son:The possible values are:

    • None: sin autenticación (valor predeterminado).None - No authentication (Default).
    • Individual: autenticación individual.Individual - Individual authentication.
    • IndividualB2C: autenticación individual con Azure AD B2C.IndividualB2C - Individual authentication with Azure AD B2C.
    • SingleOrg: autenticación organizativa para un solo inquilino.SingleOrg - Organizational authentication for a single tenant.
    • MultiOrg: autenticación organizativa para varios inquilinos.MultiOrg - Organizational authentication for multiple tenants.
    • Windows: autenticación de Windows.Windows - Windows authentication.
  • --aad-b2c-instance <INSTANCE>

    Instancia de Azure Active Directory B2C con la que se realiza la conexión.The Azure Active Directory B2C instance to connect to. Úsela con la autenticación IndividualB2C.Use with IndividualB2C authentication. El valor predeterminado es https://login.microsoftonline.com/tfp/.The default value is https://login.microsoftonline.com/tfp/.

  • -ssp|--susi-policy-id <ID>

    Identificador de la directiva de registro e inicio de sesión de este proyecto.The sign-in and sign-up policy ID for this project. Úsela con la autenticación IndividualB2C.Use with IndividualB2C authentication.

  • -rp|--reset-password-policy-id <ID>

    Identificador de la directiva de restablecimiento de contraseñas de este proyecto.The reset password policy ID for this project. Úsela con la autenticación IndividualB2C.Use with IndividualB2C authentication.

  • -ep|--edit-profile-policy-id <ID>

    Identificador de la directiva de edición de perfiles de este proyecto.The edit profile policy ID for this project. Úsela con la autenticación IndividualB2C.Use with IndividualB2C authentication.

  • --aad-instance <INSTANCE>

    Instancia de Azure Active Directory con la que se realiza la conexión.The Azure Active Directory instance to connect to. Úsela con las autenticaciones SingleOrg o MultiOrg.Use with SingleOrg or MultiOrg authentication. El valor predeterminado es https://login.microsoftonline.com/.The default value is https://login.microsoftonline.com/.

  • --client-id <ID>

    Identificador de cliente de este proyecto.The Client ID for this project. Úsela con las autenticaciones IndividualB2C, SingleOrg o MultiOrg.Use with IndividualB2C, SingleOrg, or MultiOrg authentication. El valor predeterminado es 11111111-1111-1111-11111111111111111.The default value is 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    Dominio del inquilino del directorio.The domain for the directory tenant. Úsela con las autenticaciones SingleOrg o IndividualB2C.Use with SingleOrg or IndividualB2C authentication. El valor predeterminado es qualified.domain.name.The default value is qualified.domain.name.

  • --tenant-id <ID>

    Identificador de inquilino del directorio con el que se realiza la conexión.The TenantId ID of the directory to connect to. Úsela con la autenticación SingleOrg.Use with SingleOrg authentication. El valor predeterminado es 22222222-2222-2222-2222-222222222222.The default value is 22222222-2222-2222-2222-222222222222.

  • --callback-path <PATH>

    Ruta de acceso de solicitud de la ruta de acceso de la base de la aplicación del URI de redirección.The request path within the application's base path of the redirect URI. Úsela con las autenticaciones SingleOrg o IndividualB2C.Use with SingleOrg or IndividualB2C authentication. El valor predeterminado es /signin-oidc.The default value is /signin-oidc.

  • -r|--org-read-access

    Concede a esta aplicación acceso de lectura al directorio.Allows this application read-access to the directory. Solo se aplica a las autenticaciones SingleOrg y MultiOrg.Only applies to SingleOrg or MultiOrg authentication.

  • --exclude-launch-settings

    Excluye launchSettings.json de la plantilla generada.Excludes launchSettings.json from the generated template.

  • --no-https

    Desactiva HTTPS.Turns off HTTPS. Esta opción solo se aplica si no se usan Individual, IndividualB2C, SingleOrg o MultiOrg.This option only applies if Individual, IndividualB2C, SingleOrg, or MultiOrg aren't being used.

  • -uld|--use-local-db

    Especifica que se debería usar LocalDB en vez de SQLite.Specifies LocalDB should be used instead of SQLite. Solo se aplica a las autenticaciones Individual y IndividualB2C.Only applies to Individual or IndividualB2C authentication.

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino.Specifies the framework to target. Opción disponible a partir del SDK de .NET Core 3.0.Option available since .NET Core 3.0 SDK.

    En la tabla siguiente se enumeran los valores predeterminados según el número de versión del SDK que esté usando:The following table lists the default values according to the SDK version number you're using:

    Versión del SDKSDK version Valor predeterminadoDefault value
    3.13.1 netcoreapp3.1
    3.03.0 netcoreapp3.0
  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.Doesn't execute an implicit restore during project creation.

  • --use-browserlink

    Incluye BrowserLink en el proyecto.Includes BrowserLink in the project. Opción no disponible en el SDK de .NET Core 2.2 y 3.1.Option not available in .NET Core 2.2 and 3.1 SDK.

  • -rrc|--razor-runtime-compilation

    Determina si el proyecto está configurado para usar la compilación en tiempo de ejecución de Razor en las compilaciones de depuración.Determines if the project is configured to use Razor runtime compilation in Debug builds. Opción disponible a partir del SDK de .NET Core 3.1.201.Option available since .NET Core 3.1.201 SDK.


angular, reactangular, react

  • -au|--auth <AUTHENTICATION_TYPE>

    Tipo de autenticación que se va a usar.The type of authentication to use. Disponible desde el SDK de .NET Core 3.0.Available since .NET Core 3.0 SDK.

    Los valores posibles son:The possible values are:

    • None: sin autenticación (valor predeterminado).None - No authentication (Default).
    • Individual: autenticación individual.Individual - Individual authentication.
  • --exclude-launch-settings

    Excluye launchSettings.json de la plantilla generada.Excludes launchSettings.json from the generated template.

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.Doesn't execute an implicit restore during project creation.

  • --no-https

    Desactiva HTTPS.Turns off HTTPS. Esta opción solo se aplica si la autenticación es None.This option only applies if authentication is None.

  • -uld|--use-local-db

    Especifica que se debería usar LocalDB en vez de SQLite.Specifies LocalDB should be used instead of SQLite. Solo se aplica a las autenticaciones Individual y IndividualB2C.Only applies to Individual or IndividualB2C authentication. Disponible desde el SDK de .NET Core 3.0.Available since .NET Core 3.0 SDK.

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino.Specifies the framework to target. Opción no disponible en el SDK de .NET Core 2.2.Option not available in .NET Core 2.2 SDK.

    En la tabla siguiente se enumeran los valores predeterminados según el número de versión del SDK que esté usando:The following table lists the default values according to the SDK version number you're using:

    Versión del SDKSDK version Valor predeterminadoDefault value
    3.13.1 netcoreapp3.1
    3.03.0 netcoreapp3.0
    2.12.1 netcoreapp2.0

reactreduxreactredux

  • --exclude-launch-settings

    Excluye launchSettings.json de la plantilla generada.Excludes launchSettings.json from the generated template.

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino.Specifies the framework to target. Opción no disponible en el SDK de .NET Core 2.2.Option not available in .NET Core 2.2 SDK.

    En la tabla siguiente se enumeran los valores predeterminados según el número de versión del SDK que esté usando:The following table lists the default values according to the SDK version number you're using:

    Versión del SDKSDK version Valor predeterminadoDefault value
    3.13.1 netcoreapp3.1
    3.03.0 netcoreapp3.0
    2.12.1 netcoreapp2.0
  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.Doesn't execute an implicit restore during project creation.

  • --no-https

    Desactiva HTTPS.Turns off HTTPS.


razorclasslibrazorclasslib

  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.Doesn't execute an implicit restore during project creation.

  • -s|--support-pages-and-views

    Permite agregar vistas y páginas de Razor tradicionales además de los componentes a esta biblioteca.Supports adding traditional Razor pages and Views in addition to components to this library. Disponible desde el SDK de .NET Core 3.0.Available since .NET Core 3.0 SDK.


webapiwebapi

  • -au|--auth <AUTHENTICATION_TYPE>

    Tipo de autenticación que se va a usar.The type of authentication to use. Los valores posibles son:The possible values are:

    • None: sin autenticación (valor predeterminado).None - No authentication (Default).
    • IndividualB2C: autenticación individual con Azure AD B2C.IndividualB2C - Individual authentication with Azure AD B2C.
    • SingleOrg: autenticación organizativa para un solo inquilino.SingleOrg - Organizational authentication for a single tenant.
    • Windows: autenticación de Windows.Windows - Windows authentication.
  • --aad-b2c-instance <INSTANCE>

    Instancia de Azure Active Directory B2C con la que se realiza la conexión.The Azure Active Directory B2C instance to connect to. Úsela con la autenticación IndividualB2C.Use with IndividualB2C authentication. El valor predeterminado es https://login.microsoftonline.com/tfp/.The default value is https://login.microsoftonline.com/tfp/.

  • -ssp|--susi-policy-id <ID>

    Identificador de la directiva de registro e inicio de sesión de este proyecto.The sign-in and sign-up policy ID for this project. Úsela con la autenticación IndividualB2C.Use with IndividualB2C authentication.

  • --aad-instance <INSTANCE>

    Instancia de Azure Active Directory con la que se realiza la conexión.The Azure Active Directory instance to connect to. Úsela con la autenticación SingleOrg.Use with SingleOrg authentication. El valor predeterminado es https://login.microsoftonline.com/.The default value is https://login.microsoftonline.com/.

  • --client-id <ID>

    Identificador de cliente de este proyecto.The Client ID for this project. Úsela con las autenticaciones IndividualB2C o SingleOrg.Use with IndividualB2C or SingleOrg authentication. El valor predeterminado es 11111111-1111-1111-11111111111111111.The default value is 11111111-1111-1111-11111111111111111.

  • --domain <DOMAIN>

    Dominio del inquilino del directorio.The domain for the directory tenant. Úsela con las autenticaciones IndividualB2C o SingleOrg.Use with IndividualB2C or SingleOrg authentication. El valor predeterminado es qualified.domain.name.The default value is qualified.domain.name.

  • --tenant-id <ID>

    Identificador de inquilino del directorio con el que se realiza la conexión.The TenantId ID of the directory to connect to. Úsela con la autenticación SingleOrg.Use with SingleOrg authentication. El valor predeterminado es 22222222-2222-2222-2222-222222222222.The default value is 22222222-2222-2222-2222-222222222222.

  • -r|--org-read-access

    Concede a esta aplicación acceso de lectura al directorio.Allows this application read-access to the directory. Solo se aplica a la autenticación SingleOrg.Only applies to SingleOrg authentication.

  • --exclude-launch-settings

    Excluye launchSettings.json de la plantilla generada.Excludes launchSettings.json from the generated template.

  • --no-https

    Desactiva HTTPS.Turns off HTTPS. app.UseHsts y app.UseHttpsRedirection no se agregan a Startup.Configure.app.UseHsts and app.UseHttpsRedirection aren't added to Startup.Configure. Esta opción solo se aplica si no se usan IndividualB2C o SingleOrg en la autenticación.This option only applies if IndividualB2C or SingleOrg aren't being used for authentication.

  • -uld|--use-local-db

    Especifica que se debería usar LocalDB en vez de SQLite.Specifies LocalDB should be used instead of SQLite. Solo se aplica a la autenticación IndividualB2C.Only applies to IndividualB2C authentication.

  • -f|--framework <FRAMEWORK>

    Especifica el marco de destino.Specifies the framework to target. Opción no disponible en el SDK de .NET Core 2.2.Option not available in .NET Core 2.2 SDK.

    En la tabla siguiente se enumeran los valores predeterminados según el número de versión del SDK que esté usando:The following table lists the default values according to the SDK version number you're using:

    Versión del SDKSDK version Valor predeterminadoDefault value
    3.13.1 netcoreapp3.1
    3.03.0 netcoreapp3.0
    2.12.1 netcoreapp2.1
  • --no-restore

    No se ejecuta ninguna restauración implícita durante la creación del proyecto.Doesn't execute an implicit restore during project creation.


globaljsonglobaljson

  • --sdk-version <VERSION_NUMBER>

    Especifica la versión del SDK de .NET Core que se usará en el archivo global.json.Specifies the version of the .NET Core SDK to use in the global.json file.


EjemplosExamples

  • Creación de un proyecto de aplicación de consola de C# mediante la especificación del nombre de plantilla:Create a C# console application project by specifying the template name:

    dotnet new "Console Application"
    
  • Creación de un proyecto de aplicación de consola con F# en el directorio actual:Create an F# console application project in the current directory:

    dotnet new console -lang "F#"
    
  • Creación de un proyecto de biblioteca de clases de .NET Standard en el directorio especificado:Create a .NET Standard class library project in the specified directory:

    dotnet new classlib -lang VB -o MyLibrary
    
  • Creación de un proyecto MVC de ASP.NET Core C# en el directorio actual sin autenticación:Create a new ASP.NET Core C# MVC project in the current directory with no authentication:

    dotnet new mvc -au None
    
  • Creación de un proyecto de xUnit:Create a new xUnit project:

    dotnet new xunit
    
  • Enumeración de todas las plantillas disponibles en las plantillas de aplicación de página única (SPA):List all templates available for Single Page Application (SPA) templates:

    dotnet new spa -l
    
  • Enumeración de todas las plantillas que coinciden con la subcadena we.List all templates matching the we substring. No se encuentra ninguna coincidencia exacta, por lo que se ejecuta la coincidencia de subcadena con las columnas de nombre corto y de nombre.No exact match is found, so substring matching runs against both the short name and name columns.

    dotnet new we -l
    
  • Intento de invocar a la plantilla que coincide con ng.Attempt to invoke the template matching ng. Si no se puede determinar una única coincidencia, se enumeran las plantillas que son coincidencias parciales.If a single match can't be determined, list the templates that are partial matches.

    dotnet new ng
    
  • Instalación de la versión 2.0 de las plantillas de SPA de ASP.NET Core:Install version 2.0 of the SPA templates for ASP.NET Core:

    dotnet new -i Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0
    
  • Enumeración de las plantillas instaladas y detalles sobre ellas, incluido cómo desinstalarlas:List the installed templates and details about them, including how to uninstall them:

    dotnet new -u
    
  • Creación de un archivo global.json en el directorio actual al establecer la versión del SDK en 3.1.101:Create a global.json in the current directory setting the SDK version to 3.1.101:

    dotnet new globaljson --sdk-version 3.1.101
    

Vea tambiénSee also