Modelos padrão para dotnet new

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

dotnet new list

Opções do modelo

Os modelos fornecidos com o SDK do .NET têm opções específicas de modelo. Para mostrar as opções adicionais disponíveis para o modelo, use a --help opção com o argumento do nome do modelo, por exemplo: dotnet new console --help. As seções específicas do modelo neste artigo também descrevem as opções.

Se o modelo suportar várias linguagens de programação, a --help opção mostrará ajuda para o modelo no idioma padrão. Ao combiná-lo com a --language opção, você pode ver a ajuda para outros idiomas: dotnet new console --help --language F#.

Modelos pré-instalados

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

buildprops

Cria um arquivo Directory.Build.props para personalizar as propriedades do MSBuild para uma árvore de pastas inteira. Para obter mais informações, consulte Personalizar sua compilação.

• --inherit

  Se especificado, adiciona um elemento Import para o arquivo Directory.Build.props mais próximo na hierarquia de diretórios pai. Por padrão, os arquivos Directory.Build.props não herdam dos diretórios pai, portanto, habilitar essa opção permite que você crie uma hierarquia de personalizações pasta por pasta.

• --use-artifacts

  Se especificado, adiciona uma propriedade para habilitar o layout de saída dos artefatos. Esse é um padrão comum para projetos que produzem artefatos de compilação, como pacotes NuGet, que são colocados em uma estrutura de pastas comum. Para obter mais informações, consulte Layout de saída de artefatos.

buildtargets

Cria um arquivo Directory.Build.targets para personalizar destinos e tarefas do MSBuild para uma árvore de pastas inteira. Para obter mais informações, consulte Personalizar sua compilação.

• --inherit

  Se especificado, adiciona um elemento Import para o arquivo Directory.Build.targets mais próximo na hierarquia de diretórios pai. Por padrão, os arquivos Directory.Build.targets não herdam dos diretórios pai, portanto, habilitar essa opção permite que você crie uma hierarquia de personalizações pasta por pasta.

console

• -f|--framework <FRAMEWORK>

  Especifica a estrutura a ser direcionada.

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

  Versão do SDK	Valor predefinido
  9.0	net9.0
  8.0	net8.0
  7.0	net7.0

  A capacidade de criar um projeto para um TFM anterior depende de ter essa versão do SDK instalada. Por exemplo, se você tiver apenas o SDK do .NET 9 instalado, o único valor disponível para --framework é net9.0. Se, por exemplo, você instalar o SDK do .NET 8, o valor net8.0 ficará disponível para --framework. Portanto, especificando --framework net8.0 você pode direcionar o .NET 8 mesmo durante a execução do dotnet new no SDK do .NET 9.

  Como alternativa, para criar um projeto destinado a uma estrutura anterior ao SDK que você está usando, você poderá fazê-lo instalando o pacote NuGet para o modelo. Os tipos de projeto Common, Web e SPA usam pacotes diferentes por moniker de estrutura de destino (TFM). Por exemplo, para criar um console projeto destinado a netcoreapp1.0, execute dotnet new install em Microsoft.DotNet.Common.ProjectTemplates.1.x.

• --langVersion <VERSION_NUMBER>

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

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

• --no-restore

  Se especificado, não executa uma restauração implícita durante a criação do projeto.

• --use-program-main

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

classlib

• -f|--framework <FRAMEWORK>

  Especifica a estrutura a ser direcionada. Valores: net9.0, , ou net8.0 para criar uma Biblioteca de Classes .NET ou net7.0netstandard2.1 para criar uma Biblioteca de Classes Padrão netstandard2.0do .NET. O valor padrão para o .NET SDK 9.0.x é net9.0.

  Para criar um projeto destinado a uma estrutura anterior ao SDK que você está usando, consulte --framework para console projetos anteriormente neste artigo.

• --langVersion <VERSION_NUMBER>

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

  Para obter uma lista de versões padrão do C#, consulte 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 a ser direcionada. Para o SDK do .NET 9, o valor padrão é net9.0.

• --langVersion <VERSION_NUMBER>

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

  Para obter uma lista de versões padrão do C#, consulte 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 LangVersion propriedade no arquivo de projeto criado. Por exemplo, use --langVersion 7.3 para usar C# 7.3.

  Para obter uma lista de versões padrão do C#, consulte 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 a ser direcionada. O valor padrão para o SDK do .NET 9 é net9.0.

  Para criar um projeto destinado a uma estrutura anterior ao SDK que você está usando, consulte --framework para console projetos anteriormente 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 e Program um método explícitos Main serão usados em vez de instruções de nível superior. Disponível desde .NET SDK 6.0.300. Valor predefinido: false.

mstest

• -f|--framework <FRAMEWORK>

  Especifica a estrutura a ser direcionada.

  A tabela a seguir 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 predefinido
  10.0	net10.0
  9.0	net9.0
  8.0	net8.0

A capacidade de criar um projeto para um TFM anterior depende de ter essa versão do SDK instalada. Por exemplo, se você tiver apenas o SDK do .NET 9 instalado, o único valor disponível para --framework é net9.0. Se você instalar, por exemplo, o SDK do .NET 8, o valor net8.0 ficará disponível para --framework. Portanto, especificando --framework net8.0 você pode direcionar o .NET 8 mesmo durante a execução do dotnet new no SDK do .NET 9.

• --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 corredor/plataforma para o projeto de teste. Os valores possíveis são:

  • VSTest - Plataforma VSTest (Default).
  • MSTest - 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 do Microsoft Code (Padrão).
  • coverlet - Ferramenta de cobertura de coverlet.

• --extensions-profile <EXTENSIONS_PROFILE>

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

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

• --fixture <FIXTURE>

  Os tipos de acessórios a serem incluídos 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 - Método de fixação ClassInitialize.
  • 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

  Permite o empacotamento para o projeto usando dotnet pack.

mstest-class

• --fixture <FIXTURE>

  Os tipos de acessórios a serem incluídos 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 - Método de fixação ClassInitialize.
  • 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 a ser direcionada.

  A tabela a seguir 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 predefinido
  10.0	net10.0
  9.0	net9.0
  8.0	net8.0

A capacidade de criar um projeto para um TFM anterior depende de ter essa versão do SDK instalada. Por exemplo, se você tiver apenas o SDK do .NET 9 instalado, o único valor disponível para --framework é net9.0. Se você instalar, por exemplo, o SDK do .NET 8, o valor net8.0 ficará disponível para --framework. Portanto, especificando --framework net8.0 você pode direcionar o .NET 8 mesmo durante a execução do dotnet new no SDK do .NET 9.

• -p|--enable-pack

  Permite 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 a ser direcionada.

  A tabela a seguir 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 predefinido
  10.0	net10.0
  9.0	net9.0
  8.0	net8.0

A capacidade de criar um projeto para um TFM anterior depende de ter essa versão do SDK instalada. Por exemplo, se você tiver apenas o SDK do .NET 9 instalado, o único valor disponível para --framework é net9.0. Se você instalar, por exemplo, o SDK do .NET 8, o valor net8.0 ficará disponível para --framework. Portanto, especificando --framework net8.0 você pode direcionar o .NET 8 mesmo durante a execução do dotnet new no SDK do .NET 9.

• -p|--enable-pack

  Permite 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 para o código gerado. O valor predefinido é MyApp.Namespace.

• -np|--no-pagemodel

  Cria a página sem um PageModel.

viewimports, proto

• -na|--namespace <NAMESPACE_NAME>

  Namespace para o código gerado. O valor predefinido é MyApp.Namespace.

blazor

• -f|--framework <FRAMEWORK>

  Especifica a estrutura a ser direcionada.

  Este 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 qual modo de renderização interativo usar para componentes interativos. Os valores possíveis são:

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

• --empty

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

• -au|--auth <AUTHENTICATION_TYPE>

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

  • None - Sem autenticação (padrão).
  • Individual - Autenticação individual.

• -uld|--use-local-db

  Especifica que LocalDB deve ser usado em vez de SQLite. Aplica-se apenas à Individual autenticação.

• -ai|--all-interactive

  Torna cada página interativa aplicando um modo de renderização interativo no nível superior. Se false, as páginas usam renderização estática do lado do servidor por padrão e podem ser marcadas como interativas por página ou por componente. Esta opção só é eficaz se não -i|--interactivity estiver definida como None.

• --no-https

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

• --use-program-main

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

web

• --exclude-launch-settings

  Exclui launchSettings.json do modelo gerado.

• -f|--framework <FRAMEWORK>

  Especifica a estrutura a ser direcionada.

  A tabela a seguir 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 predefinido
  10.0	net10.0
  9.0	net9.0
  8.0	net8.0

  Para criar um projeto destinado a uma estrutura anterior ao SDK que você está usando, consulte --framework para console projetos anteriormente neste artigo.

• --no-restore

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

• --no-https

  Desativa HTTPS.

• --kestrelHttpPort

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

• --kestrelHttpsPort

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

• --use-program-main

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

mvc, webapp

• -au|--auth <AUTHENTICATION_TYPE>

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

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

• --aad-b2c-instance <INSTANCE>

  A instância B2C do Azure Ative Directory à qual se conectar. Use com IndividualB2C autenticação. O valor predefinido é https://login.microsoftonline.com/tfp/.

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

  O ID da política de entrada e inscrição para este projeto. Use com IndividualB2C autenticação.

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

  O ID da política de redefinição de senha para este projeto. Use com IndividualB2C autenticação.

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

  O ID da política de perfil de edição para este projeto. Use com IndividualB2C autenticação.

• --aad-instance <INSTANCE>

  A instância do Azure Ative Directory à qual se conectar. Use com SingleOrg ou MultiOrg autenticação. O valor predefinido é https://login.microsoftonline.com/.

• --client-id <ID>

  A ID do cliente para este projeto. Use com IndividualB2C, SingleOrgou MultiOrg autenticação. O valor predefinido é 11111111-1111-1111-11111111111111111.

• --domain <DOMAIN>

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

• --tenant-id <ID>

  O ID TenantId do diretório ao qual se conectar. Use com SingleOrg autenticação. O valor predefinido é 22222222-2222-2222-2222-222222222222.

• --callback-path <PATH>

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

• -r|--org-read-access

  Permite que este aplicativo tenha acesso de leitura ao diretório. Aplica-se apenas a SingleOrg ou MultiOrg autenticação.

• --exclude-launch-settings

  Exclui launchSettings.json do modelo gerado.

• --no-https

  Desativa HTTPS. Esta opção só se aplica se Individual, IndividualB2C, SingleOrg, ou MultiOrg não estiverem a ser utilizados.

• -uld|--use-local-db

  Especifica que LocalDB deve ser usado em vez de SQLite. Aplica-se apenas a Individual ou IndividualB2C autenticação.

• -f|--framework <FRAMEWORK>

  Especifica a estrutura a ser direcionada.

  A tabela a seguir 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 predefinido
  10.0	net10.0
  9.0	net9.0
  8.0	net8.0

  Para criar um projeto destinado a uma estrutura anterior ao SDK que você está usando, consulte --framework para console projetos anteriormente neste artigo.

• --no-restore

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

• --use-browserlink

  Inclui BrowserLink no projeto.

• -rrc|--razor-runtime-compilation

  Determina se o projeto está configurado para usar a compilação de tempo de execução do Razor em compilações de depuração.

• --kestrelHttpPort

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

• --kestrelHttpsPort

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

• --use-program-main

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

razorclasslib

• --no-restore

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

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

  Suporta a adição de páginas e visualizações tradicionais do Razor, além de componentes a esta biblioteca.

webapiaot

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

• --exclude-launch-settings

  Exclui launchSettings.json do modelo gerado.

• -f|--framework <FRAMEWORK>

  Especifica a estrutura a ser direcionada.

  A tabela a seguir 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 predefinido
  10.0	net10.0
  9.0	net9.0
  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 e Program um método explícitos Main serão usados em vez de instruções de nível superior. Disponível desde .NET SDK 6.0.300. Valor predefinido: false.

webapi

• -au|--auth <AUTHENTICATION_TYPE>

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

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

• --aad-b2c-instance <INSTANCE>

  A instância B2C do Azure Ative Directory à qual se conectar. Use com IndividualB2C autenticação. O valor predefinido é https://login.microsoftonline.com/tfp/.

• -minimal|--use-minimal-apis

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

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

  O ID da política de entrada e inscrição para este projeto. Use com IndividualB2C autenticação.

• --aad-instance <INSTANCE>

  A instância do Azure Ative Directory à qual se conectar. Use com SingleOrg autenticação. O valor predefinido é https://login.microsoftonline.com/.

• --client-id <ID>

  A ID do cliente para este projeto. Use com IndividualB2C ou SingleOrg autenticação. O valor predefinido é 11111111-1111-1111-11111111111111111.

• -controllers|--use-controllers

  Se deve usar controladores em vez de APIs mínimas. Se ambas as opções forem -minimal especificadas, essa opção substituirá o valor especificado por -minimal. A predefinição é false. Disponível desde o SDK do .NET 8.

• --domain <DOMAIN>

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

• --tenant-id <ID>

  O ID TenantId do diretório ao qual se conectar. Use com SingleOrg autenticação. O valor predefinido é 22222222-2222-2222-2222-222222222222.

• -r|--org-read-access

  Permite que este aplicativo tenha acesso de leitura ao diretório. Aplica-se apenas à SingleOrg autenticação.

• --exclude-launch-settings

  Exclui launchSettings.json do modelo gerado.

• --no-openapi

  Desativa o suporte a OpenAPI (Swagger). AddOpenApi e MapOpenApi não são chamados.

• --no-https

  Desativa HTTPS. Nenhum perfil de inicialização https é criado no launchSettings.json. app.UseHstse app.UseHttpsRedirection não são chamados Program.cs/ Startup.cs. Esta opção só se aplica se IndividualB2C estiver ou SingleOrg não a ser utilizada para autenticação.

• -uld|--use-local-db

  Especifica que LocalDB deve ser usado em vez de SQLite. Aplica-se apenas à IndividualB2C autenticação.

• -f|--framework <FRAMEWORK>

  Especifica a estrutura a ser direcionada.

  A tabela a seguir 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 predefinido
  10.0	net10.0
  9.0	net9.0
  8.0	net8.0

  Para criar um projeto destinado a uma estrutura anterior ao SDK que você está usando, consulte --framework para console projetos anteriormente 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 e Program um método explícitos Main serão usados em vez de instruções de nível superior. Disponível desde .NET SDK 6.0.300. Valor predefinido: 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. A predefinição é MyApp.Namespace.

• -ac|--actions

  Crie um controlador com ações de leitura/gravação. A predefiniçã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>

  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 estiver ausente ou como uma diretiva para usar uma versão posterior. Para obter mais informações, consulte global-json.

• --test-runner <TEST_RUNNER>

  Essa opção foi introduzida no SDK do .NET 10 e especifica o executor de teste a ser usado, VSTest ou Microsoft.Testing.Platform. O padrão é VSTest.

sln

Cria um arquivo de solução vazio que não contém projetos.

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.

Modelos descontinuados

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

angular, react

Descontinuado desde o SDK do .NET 8.

• -au|--auth <AUTHENTICATION_TYPE>

  O tipo de autenticação a ser utilizada.

  Os valores possíveis são:

  • None - Sem 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 HTTPS. Esta opção só se aplica se a autenticação for None.

• -uld|--use-local-db

  Especifica que LocalDB deve ser usado em vez de SQLite. Aplica-se apenas a Individual ou IndividualB2C autenticação.

• -f|--framework <FRAMEWORK>

  Especifica a estrutura a ser direcionada.

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

  Nota

  Não há um modelo React para net8.0o , no entanto, se você estiver interessado em desenvolver aplicativos React com o ASP.NET Core, consulte Visão geral de aplicativos de página única (SPAs) no ASP.NET Core.

  Versão do SDK	Valor predefinido
  7.0	net7.0

  Para criar um projeto destinado a uma estrutura anterior ao SDK que você está usando, consulte --framework para console projetos anteriormente neste artigo.

• --kestrelHttpPort

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

• --kestrelHttpsPort

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

• --use-program-main

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

blazorserver

Descontinuado desde o SDK do .NET 8.

• -au|--auth <AUTHENTICATION_TYPE>

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

  • None - Sem autenticação (padrão).
  • Individual - Autenticação individual.
  • IndividualB2C - Autenticação individual com Azure AD B2C.
  • SingleOrg - Autenticação organizacional para um único inquilino. Os locatários do Entra External ID também usam SingleOrgo .
  • MultiOrg - Autenticação organizacional para vários inquilinos.
  • Windows - Autenticação do Windows.

• --aad-b2c-instance <INSTANCE>

  A instância B2C do Azure Ative Directory à qual se conectar. Use com IndividualB2C autenticação. O valor predefinido é https://login.microsoftonline.com/tfp/.

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

  O ID da política de entrada e inscrição para este projeto. Use com IndividualB2C autenticação.

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

  O ID da política de redefinição de senha para este projeto. Use com IndividualB2C autenticação.

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

  O ID da política de perfil de edição para este projeto. Use com IndividualB2C autenticação.

• --aad-instance <INSTANCE>

  A instância do Azure Ative Directory à qual se conectar. Use com SingleOrg ou MultiOrg autenticação. O valor predefinido é https://login.microsoftonline.com/.

• --client-id <ID>

  A ID do cliente para este projeto. Use com IndividualB2C, SingleOrgou MultiOrg autenticação. O valor predefinido é 11111111-1111-1111-11111111111111111.

• --domain <DOMAIN>

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

• --tenant-id <ID>

  O ID TenantId do diretório ao qual se conectar. Use com SingleOrg autenticação. O valor predefinido é 22222222-2222-2222-2222-222222222222.

• --callback-path <PATH>

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

• -r|--org-read-access

  Permite que este aplicativo tenha acesso de leitura ao diretório. Aplica-se apenas a SingleOrg ou MultiOrg autenticação.

• --exclude-launch-settings

  Exclui launchSettings.json do modelo gerado.

• --no-https

  Desativa HTTPS. Esta opção só se aplica se , , , ou Individual não estiverem a ser utilizados para IndividualB2C. SingleOrgMultiOrg--auth

• -uld|--use-local-db

  Especifica que LocalDB deve ser usado em vez de SQLite. Aplica-se apenas a Individual ou IndividualB2C autenticação.

• --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 no launchSettings.json.

• --kestrelHttpsPort

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

• --use-program-main

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

blazorwasm

• -f|--framework <FRAMEWORK>

  Especifica a estrutura a ser direcionada.

  A tabela a seguir 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 predefinido
  10.0	net10.0
  9.0	net9.0
  8.0	net8.0

  Para criar um projeto destinado a uma estrutura anterior ao SDK que você está usando, consulte --framework para console projetos anteriormente neste artigo.

• --no-restore

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

• -ho|--hosted

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

• -au|--auth <AUTHENTICATION_TYPE>

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

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

• --authority <AUTHORITY>

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

• --aad-b2c-instance <INSTANCE>

  A instância B2C do Azure Ative Directory à qual se conectar. Use com IndividualB2C autenticação. O valor predefinido é https://aadB2CInstance.b2clogin.com/.

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

  O ID da política de entrada e inscrição para este projeto. Use com IndividualB2C autenticação.

• --aad-instance <INSTANCE>

  A instância do Azure Ative Directory à qual se conectar. Use com SingleOrg autenticação. O valor predefinido é https://login.microsoftonline.com/.

• --client-id <ID>

  A ID do cliente para este projeto. Use com IndividualB2C, SingleOrgou Individual autenticação em cenários autônomos. O valor predefinido é 33333333-3333-3333-33333333333333333.

• --domain <DOMAIN>

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

• --app-id-uri <URI>

  O Uri de ID do Aplicativo para a API do servidor que você deseja chamar. Use com SingleOrg ou IndividualB2C autenticação. O valor predefinido é api.id.uri.

• --api-client-id <ID>

  A ID do cliente para a API que o servidor hospeda. Use com SingleOrg ou IndividualB2C autenticação. O valor predefinido é 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 SingleOrg ou IndividualB2C autenticação. O valor predefinido é user_impersonation.

• --tenant-id <ID>

  O ID TenantId do diretório ao qual se conectar. Use com SingleOrg autenticação. O valor predefinido é 22222222-2222-2222-2222-222222222222.

• -r|--org-read-access

  Permite que este aplicativo tenha acesso de leitura ao diretório. Aplica-se apenas à SingleOrg autenticação.

• --exclude-launch-settings

  Exclui launchSettings.json do modelo gerado.

• -p|--pwa

  produz um Progressive Web Application (PWA) que suporta instalação e uso offline.

• --no-https

  Desativa HTTPS. Esta opção só se aplica se Individual, IndividualB2Cou SingleOrg não estiver a ser utilizado para --auth.

• -uld|--use-local-db

  Especifica que LocalDB deve ser usado em vez de SQLite. Aplica-se apenas a Individual ou IndividualB2C autenticação.

• --called-api-url <URL>

  URL da API para chamar a partir da aplicação Web. Aplica-se apenas à SingleOrg autenticação ou IndividualB2C sem um host ASP.NET Core especificado. O valor predefinido é https://graph.microsoft.com/v1.0/me.

• --calls-graph

  Especifica se o aplicativo Web chama o Microsoft Graph. Aplica-se apenas à SingleOrg autenticação.

• --called-api-scopes <SCOPES>

  Escopos para solicitar a chamada da API do aplicativo Web. Aplica-se apenas à SingleOrg autenticação ou IndividualB2C sem um host ASP.NET Core especificado. A predefinição é user.read.

• --kestrelHttpPort

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

• --kestrelHttpsPort

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

• --use-program-main

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

Consulte também

• novo comando dotnet
• comando dotnet new list
• Modelos personalizados para dotnet new
• Criar um modelo personalizado para dotnet new
• Utilização implícita de diretivas