Partilhar via

Modelos padrão do .NET para dotnet new

  • Artigo

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

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. Clique no link de nome curto para ver as opções de modelo específicas.

Modelos Nome abreviado Idioma Etiquetas Introduzido
Aplicação de Consola console [C#], F#, VB Comum/Console 1.0
Biblioteca de classes classlib [C#], F#, VB Comum/Biblioteca 1.0
Aplicação WPF wpf [C#], VB Comum/WPF 3.0 (5.0 para VB)
Biblioteca de classes do WPF wpflib [C#], VB Comum/WPF 3.0 (5.0 para VB)
Biblioteca de controle personalizado do WPF wpfcustomcontrollib [C#], VB Comum/WPF 3.0 (5.0 para VB)
Biblioteca de controle de usuário do WPF wpfusercontrollib [C#], VB Comum/WPF 3.0 (5.0 para VB)
Aplicativo Windows Forms (WinForms) winforms [C#], VB Comum/WinForms 3.0 (5.0 para VB)
Biblioteca de classes do Windows Forms (WinForms) winformslib [C#], VB Comum/WinForms 3.0 (5.0 para VB)
Serviço ao Trabalhador worker [C#] Comum/Trabalhador/Web 3.0
Projeto de teste MSTest mstest [C#], F#, VB Teste/MSTest 1.0
Classe de teste MSTest mstest-class [C#], F#, VB Teste/MSTest 1.0
Projeto de teste NUnit 3 nunit [C#], F#, VB Teste/NUnit 2.1.400
Item de teste NUnit 3 nunit-test [C#], F#, VB Teste/NUnit 2.2
Projeto de Teste xUnit xunit [C#], F#, VB Teste/xUnit 1.0
Componente da navalha razorcomponent [C#] Web/ASP.NET 3.0
Página Razor page [C#] Web/ASP.NET 2.0
MVC ViewImports viewimports [C#] Web/ASP.NET 2.0
MVC ViewStart viewstart [C#] Web/ASP.NET 2.0
Blazor Aplicação Web blazor [C#] Sítio Web/Blazor 8.0.100
BlazorWebAssembly Aplicação autónoma blazorwasm [C#] Web/Blazor/WebAssembly/PWA 3.1.300
ASP.NET núcleo vazio web [C#], F# Web/Vazio 1.0
ASP.NET Core Web App (Model-View-Controller) mvc [C#], F# Web/MVC 1.0
ASP.NET Core Web App webapp, razor [C#] Páginas Web/MVC/Razor 2.2, 2.0
Biblioteca de Classes Razor razorclasslib [C#] Web/Razor/Biblioteca/Biblioteca de Classes Razor 2.1
API Web ASP.NET Core webapi [C#], F# Web/API Web/API/Serviço/WebAPI 1.0
API principal do ASP.NET webapiaot [C#] Web/API Web/API/Serviço 8.0
ASP.NET controlador de API principal apicontroller [C#] Web/ASP.NET 8.0
ASP.NET Serviço gRPC principal grpc [C#] Web/gRPC 3.0
arquivo dotnet gitignore gitignore Configurar 3.0
global.json arquivo globaljson Configurar 2.0
Configuração do NuGet nugetconfig Configurar 1.0
Arquivo de manifesto da ferramenta local Dotnet tool-manifest Configurar 3.0
Configuração da Web webconfig Configurar 1.0
Arquivo de solução sln Solução 1.0
Arquivo de buffer de protocolo proto Web/gRPC 3.0
Arquivo EditorConfig editorconfig Configurar 6,0

A tabela a seguir mostra 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.

Modelos Nome abreviado Idioma Etiquetas Descontinuado desde
ASP.NET Core com Angular angular [C#] Web/MVC/SPA 8.0
ASP.NET Core com React.js react [C#] Web/MVC/SPA 8.0
Blazor Aplicativo de servidor blazorserver [C#] Sítio Web/Blazor 8.0
Blazor Aplicativo de servidor vazio blazorserver-empty [C#] Sítio Web/Blazor 8.0
BlazorWebAssembly Aplicativo vazio blazorwasm-empty [C#] Sítio Web/Blazor/WebAssembly 8.0

Opções do modelo

Cada modelo pode ter opções adicionais disponíveis. 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. Caso o modelo suporte vários idiomas, este comando mostrará a 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#. Os modelos fornecidos com o SDK do .NET têm as seguintes opções adicionais:

console

  • -f|--framework <FRAMEWORK>

    Especifica a estrutura a ser direcionada. Disponível desde o SDK do .NET Core 3.0.

    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 Default value
    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 de ter essa 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 que você pode direcionar o .NET Core 3.1 mesmo durante a execução dotnet new no SDK do .NET 6.

    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#. Disponível desde o SDK do .NET Core 2.2.

    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. Disponível desde o SDK do .NET Core 2.2.

  • --use-program-main

    Se especificado, uma classe e Main um método explícitos Program 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: net8.0, , ou net6.0 para criar uma Biblioteca de Classes .NET ou netstandard2.0 netstandard2.1 para criar uma Biblioteca de Classes Padrão net7.0do .NET. O valor padrão para o .NET SDK 8.0.x é 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.

  • --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#. Disponível desde o SDK do .NET Core 2.2.

    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 8, o valor padrão é net8.0. Disponível desde o SDK do .NET Core 3.1.

  • --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 8 é net8.0. Disponível desde o SDK do .NET Core 3.1.

    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 Main um método explícitos Program 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. Opção disponível desde o SDK do .NET Core 3.0.

    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 Default value
    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 de ter essa 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 que você pode direcionar o .NET Core 3.1 mesmo durante a execução 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 corredor/plataforma para o projeto de teste. Os valores possíveis são:

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

  • --extensions-profile <EXTENSIONS_PROFILE>

    O perfil de extensões 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á 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. Opção disponível desde o SDK do .NET Core 3.0.

    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 Default value
    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 de ter essa 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 que você pode direcionar o .NET Core 3.1 mesmo durante a execução dotnet new no SDK do .NET 6.

  • -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 Default value
    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 de ter essa 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 que você pode direcionar o .NET Core 3.1 mesmo durante a execução dotnet new no SDK do .NET 6.

  • -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.

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 MultiOrg não estiverem a ser utilizados para --auth. SingleOrgIndividualB2CIndividual

  • -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 Main um método explícitos Program serão usados em vez de instruções de nível superior. Disponível desde .NET SDK 6.0.300. Valor predefinido: false.

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 Main um método explícitos Program são gerados em vez de instruções de nível superior.

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 Default value
    8.0 net8.0
    7.0 net7.0
    6,0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1

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

web

  • --exclude-launch-settings

    Exclui launchSettings.json do modelo gerado.

  • -f|--framework <FRAMEWORK>

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

    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 Default value
    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 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 Main um método explícitos Program 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. Opção disponível desde o SDK do .NET Core 3.0.

    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 Default value
    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 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. 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 tempo de execução do Razor em compilações 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 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 Main um método explícitos Program serão usados em vez de instruções de nível superior. Disponível desde .NET SDK 6.0.300. Valor predefinido: false.

angular, react

Descontinuado desde o SDK do .NET 8.

  • -au|--auth <AUTHENTICATION_TYPE>

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

    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. Disponível desde o SDK do .NET Core 3.0.

  • -f|--framework <FRAMEWORK>

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

    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 Default value
    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 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 Main um método explícitos Program 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. Disponível desde o SDK do .NET Core 3.0.

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 Default value
    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 Main um método explícitos Program 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). AddSwaggerGen, UseSwagger, e UseSwaggerUI 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. Opção não disponível no SDK do .NET Core 2.2.

    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 Default value
    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 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 Main um método explícitos Program 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.

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.

Consulte também