Modelos padrão do .NET para dotnet new

Ao instalar o SDK do .NET, você recebe dezenas de modelos internos para criar projetos e arquivos, incluindo aplicativos de console, bibliotecas de classes, projetos de teste de unidade, aplicativos ASP.NET Core (incluindo projetos Angular e React) e arquivos de configuração. Para listar os modelos internos, execute o comando dotnet new list:

dotnet new list

A tabela a seguir mostra os modelos que vêm pré-instalados com o SDK do .NET. O idioma padrão do modelo é mostrado entre parênteses. Clique no link de nome curto para ver as opções de modelo específicas.

A tabela a seguir mostra os modelos que foram descontinuados e não vêm mais pré-instalados com o SDK do .NET. Clique no link de nome curto para ver as opções de modelo específicas.

Opções de modelo

Cada modelo pode ter opções adicionais disponíveis. Para mostrar as opções adicionais disponíveis para o modelo, use a opção --help com o argumento de nome do modelo, por exemplo: dotnet new console --help. Caso o modelo dê suporte a vários idiomas, esse comando mostrará ajuda para o modelo no idioma padrão. Ao combiná-lo com a opção --language, você pode ver a ajuda para outros idiomas: dotnet new console --help --language F#. Os modelos fornecidos com o SDK do .NET têm as seguintes opções adicionais:

console

• -f|--framework <FRAMEWORK>

  Especifica a estrutura de destino. Disponível desde o SDK do .NET Core 3.0.

  A seguinte tabela lista os valores padrão de acordo com a versão do SDK que você está usando:

  Versão do SDK	Valor padrão
  8.0	net8.0
  7.0	net7.0
  6,0	net6.0
  3.1	netcoreapp3.1

  A capacidade de criar um projeto para um TFM anterior depende da presença dessa versão do SDK instalada. Por exemplo, se você tiver apenas o SDK do .NET 7 instalado, o único valor disponível para --framework será net7.0. Se você instalar o SDK do .NET 6, o valor net6.0 ficará disponível para --framework. Se você instalar o SDK do .NET Core 3.1, netcoreapp3.1 ficará disponível e assim por diante. Portanto, especificando --framework netcoreapp3.1 você pode fazer o direcionamento ao .NET Core 3.1 mesmo durante a execução do dotnet new no SDK do .NET 6.

  Como alternativa, para criar um projeto direcionado a uma estrutura anterior ao SDK que você está usando, instale o pacote NuGet do modelo. Os tipos de projeto Comuns, Web e SPA usam pacotes diferentes de acordo com o TFM (Moniker da Estrutura de Destino). Por exemplo, para criar um projeto console direcionado ao netcoreapp1.0, execute dotnet new install em Microsoft.DotNet.Common.ProjectTemplates.1.x.

• --langVersion <VERSION_NUMBER>

  Define a propriedade LangVersion no arquivo de projeto criado. Por exemplo, use --langVersion 7.3 para usar C# 7.3. Sem suporte para F#. Disponível desde o SDK do .NET Core 2.2.

  Para obter uma lista de versões C# padrão, confira Padrões.

• --no-restore

  Se especificado, não executa uma restauração implícita durante a criação do projeto. Disponível desde o SDK do .NET Core 2.2.

• --use-program-main

  Se especificado, uma classe explícita Program e um método Main serão usados em vez de instruções de nível superior. Disponível desde o .NET 6.0.300. Valor padrão: false. Disponível somente para C#.

classlib

• -f|--framework <FRAMEWORK>

  Especifica a estrutura de destino. Valores: net8.0, , ou net6.0 para criar uma Biblioteca de Classes do .NET ou netstandard2.0 netstandard2.1 para criar uma Biblioteca de Classes do net7.0.NET Standard. O valor padrão para o SDK do .NET 8.0.x é net8.0.

  Para criar um projeto direcionado a uma estrutura anterior ao SDK que você está usando, confira --framework para projetos console já abordado neste artigo.

• --langVersion <VERSION_NUMBER>

  Define a propriedade LangVersion no arquivo de projeto criado. Por exemplo, use --langVersion 7.3 para usar C# 7.3. Sem suporte para F#. Disponível desde o SDK do .NET Core 2.2.

  Para obter uma lista de versões C# padrão, confira Padrões.

• --no-restore

  Não executa uma restauração implícita durante a criação do projeto.

wpf, wpflib, wpfcustomcontrollib, wpfusercontrollib

• -f|--framework <FRAMEWORK>

  Especifica a estrutura de destino. Para o SDK do .NET 8, o valor padrão é net8.0. Disponível desde o SDK do .NET Core 3.1.

• --langVersion <VERSION_NUMBER>

  Define a propriedade LangVersion no arquivo de projeto criado. Por exemplo, use --langVersion 7.3 para usar C# 7.3.

  Para obter uma lista de versões C# padrão, confira Padrões.

• --no-restore

  Não executa uma restauração implícita durante a criação do projeto.

winforms, winformslib

• --langVersion <VERSION_NUMBER>

  Define a propriedade LangVersion no arquivo de projeto criado. Por exemplo, use --langVersion 7.3 para usar C# 7.3.

  Para obter uma lista de versões C# padrão, confira Padrões.

• --no-restore

  Não executa uma restauração implícita durante a criação do projeto.

worker, grpc

• -f|--framework <FRAMEWORK>

  Especifica a estrutura de destino. O valor padrão para o SDK do .NET 8 é net8.0. Disponível desde o SDK do .NET Core 3.1.

  Para criar um projeto direcionado a uma estrutura anterior ao SDK que você está usando, confira --framework para projetos console já abordado neste artigo.

• --exclude-launch-settings

  Exclui launchSettings.json do modelo gerado.

• --no-restore

  Não executa uma restauração implícita durante a criação do projeto.

• --use-program-main

  Se especificado, uma classe explícita Program e um método Main serão usados em vez de instruções de nível superior. Disponível desde o .NET 6.0.300. Valor padrão: false.

mstest

• -f|--framework <FRAMEWORK>

  Especifica a estrutura de destino. Opção disponível desde o SDK do .NET Core 3.0.

  A seguinte tabela lista os valores padrão de acordo com o número de versão do SDK que você está usando:

  Versão do SDK	Valor padrão
  9.0	net9.0
  8.0	net8.0
  7.0	net7.0
  6,0	net6.0
  5,0	net5.0
  3.1	netcoreapp3.1

A capacidade de criar um projeto para um TFM anterior depende da presença dessa versão do SDK instalada. Por exemplo, se você tiver apenas o SDK do .NET 6 instalado, o único valor disponível para --framework será net6.0. Se você instalar o SDK do .NET 5, o valor net5.0 ficará disponível para --framework. Se você instalar o SDK do .NET Core 3.1, netcoreapp3.1 ficará disponível e assim por diante. Portanto, especificando --framework netcoreapp3.1 você pode fazer o direcionamento ao .NET Core 3.1 mesmo durante a execução do dotnet new no SDK do .NET 6.

• --no-restore

  Não executa uma restauração implícita durante a criação do projeto.

• --sdk

  Use o estilo de projeto MSTest.Sdk.

• --test-runner <TEST_RUNNER>

  O executor/plataforma para o projeto de teste. Os valores possíveis são:

  • VSTest - Plataforma VSTest (padrão).
  • MSTest - MSTest Runner (ou seja, Microsoft.Testing.Platform).

• --coverage-tool <COVERAGE_TOOL>

  A ferramenta de cobertura a ser usada para o projeto de teste. Os valores possíveis são:

  • Microsoft.CodeCoverage - Cobertura de código da Microsoft (padrão).
  • coverlet - Ferramenta de cobertura de colchas.

• --extensions-profile <EXTENSIONS_PROFILE>

  O perfil de extensões do SDK ao usar o MSTest Runner. Os valores possíveis são:

  • Default - Perfil de extensões padrão (Padrão).
  • None - Nenhuma extensão está habilitada.
  • AllMicrosoft - Habilitar todas as extensões enviadas pela Microsoft (incluindo extensões com uma licença restritiva).

• --fixture <FIXTURE>

  Os tipos de fixação para incluir no projeto de teste. Os valores possíveis são:

  • None - Sem métodos de fixação.
  • AssemblyInitialize - Método de fixação AssemblyInitialize.
  • AssemblyCleanup - Método de fixação AssemblyCleanup.
  • ClassInitialize - ClassInitialize método de fixture.
  • ClassCleanup - Método de fixação ClassCleanup.
  • TestInitialize - Método de fixação TestInitialize.
  • TestCleanup - Método de fixação TestCleanup.

  Onde vários valores são permitidos.

• -p|--enable-pack

  Habilita o empacotamento para o projeto usando dotnet pack.

mstest-class

• --fixture <FIXTURE>

  Os tipos de fixação para incluir no projeto de teste. Os valores possíveis são:

  • None - Sem métodos de fixação.
  • AssemblyInitialize - Método de fixação AssemblyInitialize.
  • AssemblyCleanup - Método de fixação AssemblyCleanup.
  • ClassInitialize - ClassInitialize método de fixture.
  • ClassCleanup - Método de fixação ClassCleanup.
  • TestInitialize - Método de fixação TestInitialize.
  • TestCleanup - Método de fixação TestCleanup.

  Onde vários valores são permitidos.

xunit

• -f|--framework <FRAMEWORK>

  Especifica a estrutura de destino. Opção disponível desde o SDK do .NET Core 3.0.

  A seguinte tabela lista os valores padrão de acordo com o número de versão do SDK que você está usando:

  Versão do SDK	Valor padrão
  9.0	net9.0
  8.0	net8.0
  7.0	net7.0
  6,0	net6.0
  5,0	net5.0
  3.1	netcoreapp3.1

A capacidade de criar um projeto para um TFM anterior depende da presença dessa versão do SDK instalada. Por exemplo, se você tiver apenas o SDK do .NET 6 instalado, o único valor disponível para --framework será net6.0. Se você instalar o SDK do .NET 5, o valor net5.0 ficará disponível para --framework. Se você instalar o SDK do .NET Core 3.1, netcoreapp3.1 ficará disponível e assim por diante. Portanto, especificando --framework netcoreapp3.1 você pode fazer o direcionamento ao .NET Core 3.1 mesmo durante a execução do dotnet new no SDK do .NET 6.

• -p|--enable-pack

  Habilita o empacotamento para o projeto usando dotnet pack.

• --no-restore

  Não executa uma restauração implícita durante a criação do projeto.

nunit

• -f|--framework <FRAMEWORK>

  Especifica a estrutura de destino.

  A seguinte tabela lista os valores padrão de acordo com o número de versão do SDK que você está usando:

  Versão do SDK	Valor padrão
  9.0	net9.0
  8.0	net8.0
  7.0	net7.0
  6,0	net6.0
  5,0	net5.0
  3.1	netcoreapp3.1

A capacidade de criar um projeto para um TFM anterior depende da presença dessa versão do SDK instalada. Por exemplo, se você tiver apenas o SDK do .NET 6 instalado, o único valor disponível para --framework será net6.0. Se você instalar o SDK do .NET 5, o valor net5.0 ficará disponível para --framework. Se você instalar o SDK do .NET Core 3.1, netcoreapp3.1 ficará disponível e assim por diante. Portanto, especificando --framework netcoreapp3.1 você pode fazer o direcionamento ao .NET Core 3.1 mesmo durante a execução do dotnet new no SDK do .NET 6.

• -p|--enable-pack

  Habilita o empacotamento para o projeto usando dotnet pack.

• --no-restore

  Não executa uma restauração implícita durante a criação do projeto.

page

• -na|--namespace <NAMESPACE_NAME>

  Namespace do código gerado. O valor padrão é MyApp.Namespace.

• -np|--no-pagemodel

  Cria a página sem um PageModel.

viewimports, proto

• -na|--namespace <NAMESPACE_NAME>

  Namespace do código gerado. O valor padrão é MyApp.Namespace.

blazorserver

Descontinuado desde o SDK do .NET 8.

• -au|--auth <AUTHENTICATION_TYPE>

  O tipo de autenticação a ser usado. Os valores possíveis são:

  • None – Nenhuma autenticação (Padrão).
  • Individual – Autenticação individual.
  • IndividualB2C – Autenticação individual com o Azure AD B2C.
  • SingleOrg – Autenticação organizacional para um único locatário. Os locatários de ID externa do Entra também usam SingleOrg.
  • MultiOrg – Autenticação organizacional para vários locatários.
  • Windows – Autenticação do Windows.

• --aad-b2c-instance <INSTANCE>

  A instância do Azure Active Directory B2C com a qual a conexão será feita. Use com a autenticação do IndividualB2C. O valor padrão é https://login.microsoftonline.com/tfp/.

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

  A ID da política de entrada e de inscrição desse projeto. Use com a autenticação do IndividualB2C.

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

  A ID da política de redefinição de senha desse projeto. Use com a autenticação do IndividualB2C.

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

  A ID da política de perfil de edição desse projeto. Use com a autenticação do IndividualB2C.

• --aad-instance <INSTANCE>

  A instância do Azure Active Directory com a qual a conexão será feita. Use com a autenticação SingleOrg ou MultiOrg. O valor padrão é https://login.microsoftonline.com/.

• --client-id <ID>

  A ID do cliente desse projeto. Use com a autenticação IndividualB2C, SingleOrg ou MultiOrg. O valor padrão é 11111111-1111-1111-11111111111111111.

• --domain <DOMAIN>

  O domínio do locatário do diretório. Use com a autenticação SingleOrg ou IndividualB2C. O valor padrão é qualified.domain.name.

• --tenant-id <ID>

  A ID TenantId do diretório com o qual a conexão será feita. Use com a autenticação do SingleOrg. O valor padrão é 22222222-2222-2222-2222-222222222222.

• --callback-path <PATH>

  O caminho da solicitação no caminho base do aplicativo do URI de redirecionamento. Use com a autenticação SingleOrg ou IndividualB2C. O valor padrão é /signin-oidc.

• -r|--org-read-access

  Permite que esse aplicativo tenha acesso de leitura ao diretório. Aplicável apenas à autenticação SingleOrg ou MultiOrg.

• --exclude-launch-settings

  Exclui launchSettings.json do modelo gerado.

• --no-https

  Desativa o HTTPS. Essa opção é aplicável somente quando Individual, IndividualB2C, SingleOrg ou MultiOrg não estão sendo usados para --auth.

• -uld|--use-local-db

  Especifica que LocalDB deve ser usado em vez do SQLite. Aplicável apenas à autenticação Individual ou IndividualB2C.

• --no-restore

  Não executa uma restauração implícita durante a criação do projeto.

• --kestrelHttpPort

  Número da porta a ser usado para o ponto de extremidade HTTP em launchSettings.json.

• --kestrelHttpsPort

  Número da porta a ser usado para o ponto de extremidade HTTPS em launchSettings.json. Essa opção não é aplicável quando o parâmetro no-https é usado (mas no-https é ignorado quando uma configuração de autenticação individual ou organizacional é escolhida para --auth).

• --use-program-main

  Se especificado, uma classe explícita Program e um método Main serão usados em vez de instruções de nível superior. Disponível desde o .NET 6.0.300. Valor padrão: false.

blazor

• -f|--framework <FRAMEWORK>

  Especifica a estrutura de destino.

  Esse modelo está disponível para .NET 8 ou posterior.

• --no-restore

  Não executa uma restauração implícita durante a criação do projeto.

• --exclude-launch-settings

  Exclui launchSettings.json do aplicativo gerado.

• -int|--interactivity <None|Server|Webassembly|Auto >

  Especifica o modo de renderização interativo a ser usado para componentes interativos. Os valores possíveis são:

  • None - Sem interatividade (somente renderização estática do lado do servidor).
  • Server - (Padrão) Executa o aplicativo no servidor com renderização interativa no lado do servidor.
  • WebAssembly - Executa o aplicativo usando a renderização no lado do cliente no navegador com WebAssembly.
  • Auto - Usa a renderização interativa do lado do servidor enquanto baixa o pacote Blazor e ativa o runtime Blazor no cliente e, em seguida, usa a renderização do lado do cliente com WebAssembly.

• --empty

  Omite exemplos de páginas e estilos que demonstram padrões básicos de uso.

• -au|--auth <AUTHENTICATION_TYPE>

  O tipo de autenticação a ser usado. Os valores possíveis são:

  • None – Nenhuma autenticação (Padrão).
  • Individual – Autenticação individual.

• -uld|--use-local-db

  Especifica que LocalDB deve ser usado em vez do SQLite. Aplicável apenas à autenticação Individual.

• -ai|--all-interactive

  Torna todas as páginas interativas ao aplicar um modo de renderização interativo no nível superior. Se false, as páginas usarão renderização estática do lado do servidor por padrão e poderão ser marcadas como interativas por página ou por componente. Essa opção só será válida se a opção -i|--interactivity não estiver definida como None.

• --no-https

  Desativa o HTTPS. Essa opção só se aplica se Individual não for escolhido para a opção -au|--auth.

• --use-program-main

  Se especificado, uma classe Program e um método Main explícitos serão gerados em vez de instruções de nível superior.

blazorwasm

• -f|--framework <FRAMEWORK>

  Especifica a estrutura de destino.

  A seguinte tabela lista os valores padrão de acordo com o número de versão do SDK que você está usando:

  Versão do SDK	Valor padrão
  8.0	net8.0
  7.0	net7.0
  6,0	net6.0
  5,0	net5.0
  3.1	netcoreapp3.1

  Para criar um projeto direcionado a uma estrutura anterior ao SDK que você está usando, confira --framework para projetos console já abordado neste artigo.

• --no-restore

  Não executa uma restauração implícita durante a criação do projeto.

• -ho|--hosted

  Inclui um host do ASP.NET Core para o aplicativo BlazorWebAssembly.

• -au|--auth <AUTHENTICATION_TYPE>

  O tipo de autenticação a ser usado. Os valores possíveis são:

  • None – Nenhuma autenticação (Padrão).
  • Individual – Autenticação individual.
  • IndividualB2C – Autenticação individual com o Azure AD B2C.
  • SingleOrg – Autenticação organizacional para um único locatário. Os locatários do Entra External ID também usam o SingleOrg.

• --authority <AUTHORITY>

  A autoridade do provedor OIDC. Use com a autenticação do Individual. O valor padrão é https://login.microsoftonline.com/.

• --aad-b2c-instance <INSTANCE>

  A instância do Azure Active Directory B2C com a qual a conexão será feita. Use com a autenticação do IndividualB2C. O valor padrão é https://aadB2CInstance.b2clogin.com/.

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

  A ID da política de entrada e de inscrição desse projeto. Use com a autenticação do IndividualB2C.

• --aad-instance <INSTANCE>

  A instância do Azure Active Directory com a qual a conexão será feita. Use com a autenticação do SingleOrg. O valor padrão é https://login.microsoftonline.com/.

• --client-id <ID>

  A ID do cliente desse projeto. Use com a autenticação IndividualB2C, SingleOrg ou Individual em cenários autônomos. O valor padrão é 33333333-3333-3333-33333333333333333.

• --domain <DOMAIN>

  O domínio do locatário do diretório. Use com a autenticação SingleOrg ou IndividualB2C. O valor padrão é qualified.domain.name.

• --app-id-uri <URI>

  O URI da ID do aplicativo da API do servidor que você quer chamar. Use com a autenticação SingleOrg ou IndividualB2C. O valor padrão é api.id.uri.

• --api-client-id <ID>

  A ID do cliente da API que o servidor hospeda. Use com a autenticação SingleOrg ou IndividualB2C. O valor padrão é 11111111-1111-1111-11111111111111111.

• -s|--default-scope <SCOPE>

  O escopo da API que o cliente precisa solicitar para provisionar um token de acesso. Use com a autenticação SingleOrg ou IndividualB2C. O valor padrão é user_impersonation.

• --tenant-id <ID>

  A ID TenantId do diretório com o qual a conexão será feita. Use com a autenticação do SingleOrg. O valor padrão é 22222222-2222-2222-2222-222222222222.

• -r|--org-read-access

  Permite que esse aplicativo tenha acesso de leitura ao diretório. Aplicável apenas à autenticação SingleOrg.

• --exclude-launch-settings

  Exclui launchSettings.json do modelo gerado.

• -p|--pwa

  produz um PWA (Aplicativo Web Progressivo) que dá suporte à instalação e ao uso offline.

• --no-https

  Desativa o HTTPS. Essa opção é aplicável somente quando Individual, IndividualB2C ou SingleOrg não estão sendo usados para --auth.

• -uld|--use-local-db

  Especifica que LocalDB deve ser usado em vez do SQLite. Aplicável apenas à autenticação Individual ou IndividualB2C.

• --called-api-url <URL>

  URL da API a ser chamada por meio do aplicativo Web. Aplica-se somente à autenticação SingleOrg ou IndividualB2C sem um host do ASP.NET Core especificado. O valor padrão é https://graph.microsoft.com/v1.0/me.

• --calls-graph

  Especifica se o aplicativo Web chama o Microsoft Graph. Aplicável apenas à autenticação SingleOrg.

• --called-api-scopes <SCOPES>

  Os escopos a serem solicitados para chamar a API por meio do aplicativo Web. Aplica-se somente à autenticação SingleOrg ou IndividualB2C sem um host do ASP.NET Core especificado. O padrão é user.read.

• --kestrelHttpPort

  Número da porta a ser usado para o ponto de extremidade HTTP em launchSettings.json.

• --kestrelHttpsPort

  Número da porta a ser usado para o ponto de extremidade HTTPS em launchSettings.json. Essa opção não é aplicável quando o parâmetro no-https é usado (mas no-https é ignorado quando uma configuração de autenticação individual ou organizacional é escolhida para --auth).

• --use-program-main

  Se especificado, uma classe explícita Program e um método Main serão usados em vez de instruções de nível superior. Disponível desde o .NET 6.0.300. Valor padrão: false.

web

• --exclude-launch-settings

  Exclui launchSettings.json do modelo gerado.

• -f|--framework <FRAMEWORK>

  Especifica a estrutura de destino. Opção não disponível no SDK do .NET Core 2.2.

  A seguinte tabela lista os valores padrão de acordo com o número de versão do SDK que você está usando:

  Versão do SDK	Valor padrão
  8.0	net8.0
  7.0	net7.0
  6,0	net6.0
  5,0	net5.0
  3.1	netcoreapp3.1
  3,0	netcoreapp3.0
  2.1	netcoreapp2.1

  Para criar um projeto direcionado a uma estrutura anterior ao SDK que você está usando, confira --framework para projetos console já abordado neste artigo.

• --no-restore

  Não executa uma restauração implícita durante a criação do projeto.

• --no-https

  Desativa o HTTPS.

• --kestrelHttpPort

  Número da porta a ser usado para o ponto de extremidade HTTP em launchSettings.json.

• --kestrelHttpsPort

  Número da porta a ser usado para o ponto de extremidade HTTPS em launchSettings.json. Essa opção não é aplicável quando o parâmetro no-https é usado (mas no-https é ignorado quando uma configuração de autenticação individual ou organizacional é escolhida para --auth).

• --use-program-main

  Se especificado, uma classe explícita Program e um método Main serão usados em vez de instruções de nível superior. Disponível desde o .NET 6.0.300. Valor padrão: false.

mvc, webapp

• -au|--auth <AUTHENTICATION_TYPE>

  O tipo de autenticação a ser usado. Os valores possíveis são:

  • None – Nenhuma autenticação (Padrão).
  • Individual – Autenticação individual.
  • IndividualB2C – Autenticação individual com o Azure AD B2C.
  • SingleOrg – Autenticação organizacional para um único locatário. Os locatários do Entra External ID também usam o SingleOrg.
  • MultiOrg – Autenticação organizacional para vários locatários.
  • Windows – Autenticação do Windows.

• --aad-b2c-instance <INSTANCE>

  A instância do Azure Active Directory B2C com a qual a conexão será feita. Use com a autenticação do IndividualB2C. O valor padrão é https://login.microsoftonline.com/tfp/.

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

  A ID da política de entrada e de inscrição desse projeto. Use com a autenticação do IndividualB2C.

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

  A ID da política de redefinição de senha desse projeto. Use com a autenticação do IndividualB2C.

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

  A ID da política de perfil de edição desse projeto. Use com a autenticação do IndividualB2C.

• --aad-instance <INSTANCE>

  A instância do Azure Active Directory com a qual a conexão será feita. Use com a autenticação SingleOrg ou MultiOrg. O valor padrão é https://login.microsoftonline.com/.

• --client-id <ID>

  A ID do cliente desse projeto. Use com a autenticação IndividualB2C, SingleOrg ou MultiOrg. O valor padrão é 11111111-1111-1111-11111111111111111.

• --domain <DOMAIN>

  O domínio do locatário do diretório. Use com a autenticação SingleOrg ou IndividualB2C. O valor padrão é qualified.domain.name.

• --tenant-id <ID>

  A ID TenantId do diretório com o qual a conexão será feita. Use com a autenticação do SingleOrg. O valor padrão é 22222222-2222-2222-2222-222222222222.

• --callback-path <PATH>

  O caminho da solicitação no caminho base do aplicativo do URI de redirecionamento. Use com a autenticação SingleOrg ou IndividualB2C. O valor padrão é /signin-oidc.

• -r|--org-read-access

  Permite que esse aplicativo tenha acesso de leitura ao diretório. Aplicável apenas à autenticação SingleOrg ou MultiOrg.

• --exclude-launch-settings

  Exclui launchSettings.json do modelo gerado.

• --no-https

  Desativa o HTTPS. Essa opção é aplicável somente se Individual, IndividualB2C, SingleOrg ou MultiOrg não estão sendo usados.

• -uld|--use-local-db

  Especifica que LocalDB deve ser usado em vez do SQLite. Aplicável apenas à autenticação Individual ou IndividualB2C.

• -f|--framework <FRAMEWORK>

  Especifica a estrutura de destino. Opção disponível desde o SDK do .NET Core 3.0.

  A seguinte tabela lista os valores padrão de acordo com o número de versão do SDK que você está usando:

  Versão do SDK	Valor padrão
  8.0	net8.0
  7.0	net7.0
  6,0	net6.0
  5,0	net5.0
  3.1	netcoreapp3.1
  3,0	netcoreapp3.0

  Para criar um projeto direcionado a uma estrutura anterior ao SDK que você está usando, confira --framework para projetos console já abordado neste artigo.

• --no-restore

  Não executa uma restauração implícita durante a criação do projeto.

• --use-browserlink

  Inclui BrowserLink no projeto. Opção não disponível no SDK do .NET Core 2.2 e 3.1.

• -rrc|--razor-runtime-compilation

  Determina se o projeto está configurado para usar a compilação de runtime do Razor em builds de depuração. Opção disponível desde o SDK do .NET Core 3.1.201.

• --kestrelHttpPort

  Número da porta a ser usado para o ponto de extremidade HTTP em launchSettings.json.

• --kestrelHttpsPort

  Número da porta a ser usado para o ponto de extremidade HTTPS em launchSettings.json. Essa opção não é aplicável quando o parâmetro no-https é usado (mas no-https é ignorado quando uma configuração de autenticação individual ou organizacional é escolhida para --auth).

• --use-program-main

  Se especificado, uma classe explícita Program e um método Main serão usados em vez de instruções de nível superior. Disponível desde o .NET 6.0.300. Valor padrão: false.

angular, react

Descontinuado desde o SDK do .NET 8.

• -au|--auth <AUTHENTICATION_TYPE>

  O tipo de autenticação a ser usado. Disponível desde o SDK do .NET Core 3.0.

  Os valores possíveis são:

  • None – Nenhuma autenticação (Padrão).
  • Individual – Autenticação individual.

• --exclude-launch-settings

  Exclui launchSettings.json do modelo gerado.

• --no-restore

  Não executa uma restauração implícita durante a criação do projeto.

• --no-https

  Desativa o HTTPS. Essa opção só se aplicará se a autenticação for None.

• -uld|--use-local-db

  Especifica que LocalDB deve ser usado em vez do SQLite. Aplicável apenas à autenticação Individual ou IndividualB2C. Disponível desde o SDK do .NET Core 3.0.

• -f|--framework <FRAMEWORK>

  Especifica a estrutura de destino. Opção não disponível no SDK do .NET Core 2.2.

  A seguinte tabela lista os valores padrão de acordo com o número de versão do SDK que você está usando:

  Observação

  Não há um modelo do React para net8.0, entretanto, se você estiver interessado em desenvolver aplicativos React com ASP.NET Core, consulte Visão geral dos Aplicativos de Página Única (SPAs) no ASP.NET Core.

  Versão do SDK	Valor padrão
  7.0	net7.0
  6,0	net6.0
  5,0	net5.0
  3.1	netcoreapp3.1
  3,0	netcoreapp3.0
  2.1	netcoreapp2.0

  Para criar um projeto direcionado a uma estrutura anterior ao SDK que você está usando, confira --framework para projetos console já abordado neste artigo.

• --kestrelHttpPort

  Número da porta a ser usado para o ponto de extremidade HTTP em launchSettings.json.

• --kestrelHttpsPort

  Número da porta a ser usado para o ponto de extremidade HTTPS em launchSettings.json. Essa opção não é aplicável quando o parâmetro no-https é usado (mas no-https é ignorado quando uma configuração de autenticação individual ou organizacional é escolhida para --auth).

• --use-program-main

  Se especificado, uma classe explícita Program e um método Main serão usados em vez de instruções de nível superior. Disponível desde o .NET 6.0.300. Valor padrão: false.

razorclasslib

• --no-restore

  Não executa uma restauração implícita durante a criação do projeto.

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

  Dá suporte à adição de páginas e exibições tradicionais do Razor, além dos componentes dessa biblioteca. Disponível desde o SDK do .NET Core 3.0.

webapiaot

Cria um projeto de API Web com a publicação AOT habilitada. Para obter mais informações, confira Implantação AOT nativa e Modelo de API Web (AOT nativo).

• --exclude-launch-settings

  Exclui launchSettings.json do modelo gerado.

• -f|--framework <FRAMEWORK>

  Especifica a estrutura de destino.

  A seguinte tabela lista os valores padrão de acordo com o número de versão do SDK que você está usando:

  Versão do SDK	Valor padrão
  8.0	net8.0

• --no-restore

  Não executa uma restauração implícita durante a criação do projeto.

• --use-program-main

  Se especificado, uma classe explícita Program e um método Main serão usados em vez de instruções de nível superior. Disponível desde o .NET 6.0.300. Valor padrão: false.

webapi

• -au|--auth <AUTHENTICATION_TYPE>

  O tipo de autenticação a ser usado. Os valores possíveis são:

  • None – Nenhuma autenticação (Padrão).
  • IndividualB2C – Autenticação individual com o Azure AD B2C.
  • SingleOrg – Autenticação organizacional para um único locatário. Os locatários do Entra External ID também usam o SingleOrg.
  • Windows – Autenticação do Windows.

• --aad-b2c-instance <INSTANCE>

  A instância do Azure Active Directory B2C com a qual a conexão será feita. Use com a autenticação do IndividualB2C. O valor padrão é https://login.microsoftonline.com/tfp/.

• -minimal|--use-minimal-apis

  Crie um projeto que use a API mínima ASP.NET Core. O padrão é false, mas essa opção é substituída por -controllers. Como o padrão para -controllers é false, inserir dotnet new webapi sem especificar nenhuma das opções cria um projeto de API mínima.

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

  A ID da política de entrada e de inscrição desse projeto. Use com a autenticação do IndividualB2C.

• --aad-instance <INSTANCE>

  A instância do Azure Active Directory com a qual a conexão será feita. Use com a autenticação do SingleOrg. O valor padrão é https://login.microsoftonline.com/.

• --client-id <ID>

  A ID do cliente desse projeto. Use com a autenticação IndividualB2C ou SingleOrg. O valor padrão é 11111111-1111-1111-11111111111111111.

• -controllers|--use-controllers

  Utilizar ou não controladores em vez de APIs mínimas. Se tanto essa opção quanto -minimal forem especificadas, essa opção substituirá o valor especificado por -minimal. O padrão é false. Disponível desde o SDK do .NET 8.

• --domain <DOMAIN>

  O domínio do locatário do diretório. Use com a autenticação IndividualB2C ou SingleOrg. O valor padrão é qualified.domain.name.

• --tenant-id <ID>

  A ID TenantId do diretório com o qual a conexão será feita. Use com a autenticação do SingleOrg. O valor padrão é 22222222-2222-2222-2222-222222222222.

• -r|--org-read-access

  Permite que esse aplicativo tenha acesso de leitura ao diretório. Aplicável apenas à autenticação SingleOrg.

• --exclude-launch-settings

  Exclui launchSettings.json do modelo gerado.

• --no-openapi

  Desativa o suporte a OpenAPI (Swagger). AddSwaggerGen, UseSwagger e UseSwaggerUI não são chamados.

• --no-https

  Desativa o HTTPS. Nenhum perfil de inicialização https é criado em launchSettings.json. app.UseHsts e app.UseHttpsRedirection não são chamados em Program.cs/Startup.cs. Essa opção só se aplica quando IndividualB2C ou SingleOrg não está sendo usado para autenticação.

• -uld|--use-local-db

  Especifica que LocalDB deve ser usado em vez do SQLite. Aplicável apenas à autenticação IndividualB2C.

• -f|--framework <FRAMEWORK>

  Especifica a estrutura de destino. Opção não disponível no SDK do .NET Core 2.2.

  A seguinte tabela lista os valores padrão de acordo com o número de versão do SDK que você está usando:

  Versão do SDK	Valor padrão
  8.0	net8.0
  7.0	net7.0
  6,0	net6.0
  5,0	net5.0
  3.1	netcoreapp3.1
  3,0	netcoreapp3.0
  2.1	netcoreapp2.1

  Para criar um projeto direcionado a uma estrutura anterior ao SDK que você está usando, confira --framework para projetos console já abordado neste artigo.

• --no-restore

  Não executa uma restauração implícita durante a criação do projeto.

• --use-program-main

  Se especificado, uma classe explícita Program e um método Main serão usados em vez de instruções de nível superior. Disponível desde o .NET 6.0.300. Valor padrão: false.

apicontroller

Controlador de API com ou sem ações de leitura/gravação.

• -p:n|--name <NAME>

  O namespace para o código gerado. O padrão é MyApp.Namespace.

• -ac|--actions

  Crie um controlador com ações de leitura/gravação. O padrão é false.

globaljson

• --sdk-version <VERSION_NUMBER>

  Especifica a versão do SDK do .NET a ser usada no arquivo global.json.

• --roll-forward <ROLL_FORWARD_POLICY>

  Indica a política de roll-forward a ser usada ao selecionar uma versão do SDK, seja como um fallback quando uma versão específica do SDK está ausente ou como uma diretiva para usar uma versão posterior. Para obter mais informações, consulte global-json.

editorconfig

Cria um arquivo .editorconfig para configurar preferências de estilo de código.

• --empty

  Cria um .editorconfig vazio em vez dos padrões para .NET.

Confira também

• Comando dotnet new
• comando dotnet new list
• Modelos personalizados para dotnet new
• Create a custom template for dotnet new (Criar um modelo personalizado para dotnet new)
• Diretivas de uso implícito