MSTest
- Microsoft.Testing.Platform。
--coverage-tool <COVERAGE_TOOL>
用于测试项目的覆盖范围工具。 可能的值为:
Microsoft.CodeCoverage
- Microsoft代码覆盖率(默认值)。
coverlet
- coverlet 覆盖率工具。
--extensions-profile <EXTENSIONS_PROFILE>
使用 Microsoft.Testing.Platform 时的 SDK 扩展配置文件。 可能的值为:
Default
- 默认扩展配置文件(默认值)。
None
- 未启用任何扩展。
AllMicrosoft
- 启用 Microsoft 提供的所有扩展(包括具有限制性许可证的扩展)。
--fixture <FIXTURE>
要包含在测试项目中的装置类型。 可能的值为:
None
- 无固定装置方法。
AssemblyInitialize
- AssemblyInitialize 装置方法。
AssemblyCleanup
- AssemblyCleanup 装置方法。
ClassInitialize
- ClassInitialize 固定装置方法。
ClassCleanup
- ClassCleanup 装置方法。
TestInitialize
- TestInitialize 固定装置方法。
TestCleanup
- TestCleanup 装置方法。
允许多个值的位置。
-p|--enable-pack
允许使用 dotnet pack 为项目打包。
mstest-class
--fixture <FIXTURE>
要包含在测试项目中的装置类型。 可能的值为:
None
- 无固定装置方法。
AssemblyInitialize
- AssemblyInitialize 装置方法。
AssemblyCleanup
- AssemblyCleanup 装置方法。
ClassInitialize
- ClassInitialize 固定装置方法。
ClassCleanup
- ClassCleanup 装置方法。
TestInitialize
- TestInitialize 固定装置方法。
TestCleanup
- TestCleanup 装置方法。
允许多个值的位置。
xunit
-f|--framework <FRAMEWORK>
指定目标框架。
下表根据所使用的 SDK 版本号列出了默认值:
SDK 版本
能否为较早的 TFM 创建项目取决于是否安装了该版本的 SDK。 例如,如果只安装了 .NET 9 SDK,则可用于 --framework
的唯一值是 net9.0
。 例如,如果安装 .NET 8 SDK,则值 net8.0
可用于 --framework
。 因此,通过指定 --framework net8.0
,即使在 .NET 9 SDK 中运行 dotnet new
时,也可以以 .NET 8 为目标。
-p|--enable-pack
允许使用 dotnet pack 为项目打包。
--no-restore
在项目创建期间不执行隐式还原。
nunit
-f|--framework <FRAMEWORK>
指定目标框架。
下表根据所使用的 SDK 版本号列出了默认值:
SDK 版本
能否为较早的 TFM 创建项目取决于是否安装了该版本的 SDK。 例如,如果只安装了 .NET 9 SDK,则可用于 --framework
的唯一值是 net9.0
。 例如,如果安装 .NET 8 SDK,则值 net8.0
可用于 --framework
。 因此,通过指定 --framework net8.0
,即使在 .NET 9 SDK 中运行 dotnet new
时,也可以以 .NET 8 为目标。
-p|--enable-pack
允许使用 dotnet pack 为项目打包。
--no-restore
在项目创建期间不执行隐式还原。
-na|--namespace <NAMESPACE_NAME>
已生成代码的命名空间。 默认值为 MyApp.Namespace
。
-np|--no-pagemodel
创建不含 PageModel 的页。
--aad-b2c-instance <INSTANCE>
要连接到的 Azure Active Directory B2C 实例。 与 IndividualB2C
身份验证结合使用。 默认值为 https://login.microsoftonline.com/tfp/
。
-ssp|--susi-policy-id <ID>
此项目的登录和注册策略 ID。 与 IndividualB2C
身份验证结合使用。
-rp|--reset-password-policy-id <ID>
此项目的重置密码策略 ID。 与 IndividualB2C
身份验证结合使用。
-ep|--edit-profile-policy-id <ID>
此项目的编辑配置文件策略 ID。 与 IndividualB2C
身份验证结合使用。
--aad-instance <INSTANCE>
要连接到的 Azure Active Directory 实例。 与 SingleOrg
或 MultiOrg
身份验证结合使用。 默认值为 https://login.microsoftonline.com/
。
--client-id <ID>
此项目的客户端 ID。 与 IndividualB2C
、SingleOrg
或 MultiOrg
身份验证结合使用。 默认值为 11111111-1111-1111-11111111111111111
。
--domain <DOMAIN>
目录租户的域。 与 SingleOrg
或 IndividualB2C
身份验证结合使用。 默认值为 qualified.domain.name
。
--tenant-id <ID>
要连接到的目录的 TenantId ID。 与 SingleOrg
身份验证结合使用。 默认值为 22222222-2222-2222-2222-222222222222
。
--callback-path <PATH>
重定向 URI 的应用程序基路径中的请求路径。 与 SingleOrg
或 IndividualB2C
身份验证结合使用。 默认值为 /signin-oidc
。
-r|--org-read-access
允许此应用程序对目录进行读取访问。 仅适用于 SingleOrg
或 MultiOrg
身份验证。
--exclude-launch-settings
从生成的模板中排除 launchSettings.json。
--no-https
关闭 HTTPS。 此选项仅适用于 Individual
、IndividualB2C
、SingleOrg
和 MultiOrg
未用于 --auth
的情况。
-uld|--use-local-db
指定应使用 LocalDB,而不使用 SQLite。 仅适用于 Individual
或 IndividualB2C
身份验证。
--no-restore
在项目创建期间不执行隐式还原。
--kestrelHttpPort
要用于 launchSettings.json 中的 HTTP 终结点的端口号。
--kestrelHttpsPort
要用于 launchSettings.json 中的 HTTPS 终结点的端口号。 使用参数 no-https
时,此选项不适用(但为 no-https
选择单独或组织身份验证设置时忽略 --auth
)。
--use-program-main
如果指定,将使用显式 Program
类和 Main
方法,而不是顶级语句。 自 .NET SDK 6.0.300 之后可用。 默认值:false
。
blazor
-f|--framework <FRAMEWORK>
指定目标框架。
此模板适用于 .NET 8 或更高版本。
--no-restore
在项目创建期间不执行隐式还原。
--exclude-launch-settings
从生成的应用中排除 launchSettings.json。
-int|--interactivity <None|Server|Webassembly|Auto >
指定要用于交互式组件的交互式呈现模式。 可能的值为:
None
- 无交互性(仅静态服务器端呈现)。
Server
-(默认)使用交互式服务器端呈现在服务器上运行应用。
WebAssembly
- 通过 WebAssembly 在浏览器中使用客户端呈现运行应用。
Auto
- 在客户端下载 Blazor 捆绑包并激活 Blazor 运行时的同时,使用交互式服务器端呈现,然后搭配使用客户端呈现和 WebAssembly。
--empty
省略演示基本使用模式的示例页和样式。
-au|--auth <AUTHENTICATION_TYPE>
要使用的身份验证类型。 可能的值为:
None
- 不进行身份验证(默认)。
Individual
- 个人身份验证。
-uld|--use-local-db
指定应使用 LocalDB,而不使用 SQLite。 仅适用于 Individual
身份验证。
-ai|--all-interactive
通过在顶层应用交互式呈现模式,使每个页面都具有交互性。 如果为 false
,则页面默认使用静态服务器端呈现,并且可在每页或每个组件的基础上标记为交互式。 仅当 -i|--interactivity
选项未设置为 None
时,此选项才有效。
--no-https
关闭 HTTPS。 仅当未为 Individual
选项选择 -au|--auth
时,此选项才适用。
--use-program-main
如果已指定,则将生成显式 Program
类和 Main
方法,而不是顶级语句。
blazorwasm
-f|--framework <FRAMEWORK>
指定目标框架。
下表根据所使用的 SDK 版本号列出了默认值:
SDK 版本
IndividualB2C
- 使用 Azure AD B2C 进行个人身份验证。
SingleOrg
- 对一个租户进行组织身份验证。 Entra 外部 ID 租户也使用 SingleOrg。
--authority <AUTHORITY>
OIDC 提供程序所属的机构。 与 Individual
身份验证结合使用。 默认值为 https://login.microsoftonline.com/
。
--aad-b2c-instance <INSTANCE>
要连接到的 Azure Active Directory B2C 实例。 与 IndividualB2C
身份验证结合使用。 默认值为 https://aadB2CInstance.b2clogin.com/
。
-ssp|--susi-policy-id <ID>
此项目的登录和注册策略 ID。 与 IndividualB2C
身份验证结合使用。
--aad-instance <INSTANCE>
要连接到的 Azure Active Directory 实例。 与 SingleOrg
身份验证结合使用。 默认值为 https://login.microsoftonline.com/
。
--client-id <ID>
此项目的客户端 ID。 在独立方案中与 IndividualB2C
、SingleOrg
或 Individual
身份验证一起使用。 默认值为 33333333-3333-3333-33333333333333333
。
--domain <DOMAIN>
目录租户的域。 与 SingleOrg
或 IndividualB2C
身份验证结合使用。 默认值为 qualified.domain.name
。
--app-id-uri <URI>
要调用的服务器 API 的应用 ID URI。 与 SingleOrg
或 IndividualB2C
身份验证结合使用。 默认值为 api.id.uri
。
--api-client-id <ID>
服务器承载的 API 的客户端 ID。 与 SingleOrg
或 IndividualB2C
身份验证结合使用。 默认值为 11111111-1111-1111-11111111111111111
。
-s|--default-scope <SCOPE>
客户端为预配访问令牌所需请求的 API 作用域。 与 SingleOrg
或 IndividualB2C
身份验证结合使用。 默认值为 user_impersonation
。
--tenant-id <ID>
要连接到的目录的 TenantId ID。 与 SingleOrg
身份验证结合使用。 默认值为 22222222-2222-2222-2222-222222222222
。
-r|--org-read-access
允许此应用程序对目录进行读取访问。 仅适用于 SingleOrg
身份验证。
--exclude-launch-settings
从生成的模板中排除 launchSettings.json。
-p|--pwa
生成支持安装和脱机使用的渐进式 Web 应用程序 (PWA)。
--no-https
关闭 HTTPS。 此选项仅适用于 Individual
、IndividualB2C
和 SingleOrg
未用于 --auth
的情况。
-uld|--use-local-db
指定应使用 LocalDB,而不使用 SQLite。 仅适用于 Individual
或 IndividualB2C
身份验证。
--called-api-url <URL>
要从 Web 应用调用的 API 的 URL。 仅适用于未指定 ASP.NET Core 主机的 SingleOrg
或 IndividualB2C
身份验证。 默认值为 https://graph.microsoft.com/v1.0/me
。
--calls-graph
指定 Web 应用是否调用 Microsoft Graph。 仅适用于 SingleOrg
身份验证。
--called-api-scopes <SCOPES>
为从 Web 应用调用 API 而请求的作用域。 仅适用于未指定 ASP.NET Core 主机的 SingleOrg
或 IndividualB2C
身份验证。 默认值为 user.read
。
--kestrelHttpPort
要用于 launchSettings.json 中的 HTTP 终结点的端口号。
--kestrelHttpsPort
要用于 launchSettings.json 中的 HTTPS 终结点的端口号。 使用参数 no-https
时,此选项不适用(但为 no-https
选择单独或组织身份验证设置时忽略 --auth
)。
--use-program-main
如果指定,将使用显式 Program
类和 Main
方法,而不是顶级语句。 自 .NET SDK 6.0.300 之后可用。 默认值:false
。
--exclude-launch-settings
从生成的模板中排除 launchSettings.json。
-f|--framework <FRAMEWORK>
指定目标框架。 选项在 .NET Core 2.2 SDK 中不可用。
下表根据所使用的 SDK 版本号列出了默认值:
SDK 版本
--kestrelHttpsPort
要用于 launchSettings.json 中的 HTTPS 终结点的端口号。 使用参数 no-https
时,此选项不适用(但为 no-https
选择单独或组织身份验证设置时忽略 --auth
)。
--use-program-main
如果指定,将使用显式 Program
类和 Main
方法,而不是顶级语句。 自 .NET SDK 6.0.300 之后可用。 默认值:false
。
IndividualB2C
- 使用 Azure AD B2C 进行个人身份验证。
SingleOrg
- 对一个租户进行组织身份验证。 Entra 外部 ID 租户也使用 SingleOrg。
MultiOrg
- 对多个租户进行组织身份验证。
Windows
- Windows 身份验证。
--aad-b2c-instance <INSTANCE>
要连接到的 Azure Active Directory B2C 实例。 与 IndividualB2C
身份验证结合使用。 默认值为 https://login.microsoftonline.com/tfp/
。
-ssp|--susi-policy-id <ID>
此项目的登录和注册策略 ID。 与 IndividualB2C
身份验证结合使用。
-rp|--reset-password-policy-id <ID>
此项目的重置密码策略 ID。 与 IndividualB2C
身份验证结合使用。
-ep|--edit-profile-policy-id <ID>
此项目的编辑配置文件策略 ID。 与 IndividualB2C
身份验证结合使用。
--aad-instance <INSTANCE>
要连接到的 Azure Active Directory 实例。 与 SingleOrg
或 MultiOrg
身份验证结合使用。 默认值为 https://login.microsoftonline.com/
。
--client-id <ID>
此项目的客户端 ID。 与 IndividualB2C
、SingleOrg
或 MultiOrg
身份验证结合使用。 默认值为 11111111-1111-1111-11111111111111111
。
--domain <DOMAIN>
目录租户的域。 与 SingleOrg
或 IndividualB2C
身份验证结合使用。 默认值为 qualified.domain.name
。
--tenant-id <ID>
要连接到的目录的 TenantId ID。 与 SingleOrg
身份验证结合使用。 默认值为 22222222-2222-2222-2222-222222222222
。
--callback-path <PATH>
重定向 URI 的应用程序基路径中的请求路径。 与 SingleOrg
或 IndividualB2C
身份验证结合使用。 默认值为 /signin-oidc
。
-r|--org-read-access
允许此应用程序对目录进行读取访问。 仅适用于 SingleOrg
或 MultiOrg
身份验证。
--exclude-launch-settings
从生成的模板中排除 launchSettings.json。
--no-https
关闭 HTTPS。 此选项仅适用于未使用 Individual
、IndividualB2C
、SingleOrg
和 MultiOrg
的情况。
-uld|--use-local-db
指定应使用 LocalDB,而不使用 SQLite。 仅适用于 Individual
或 IndividualB2C
身份验证。
-f|--framework <FRAMEWORK>
指定目标框架。 自 .NET Core 3.0 SDK 起可用的选项。
下表根据所使用的 SDK 版本号列出了默认值:
SDK 版本
--kestrelHttpsPort
要用于 launchSettings.json 中的 HTTPS 终结点的端口号。 使用参数 no-https
时,此选项不适用(但为 no-https
选择单独或组织身份验证设置时忽略 --auth
)。
--use-program-main
如果指定,将使用显式 Program
类和 Main
方法,而不是顶级语句。 自 .NET SDK 6.0.300 之后可用。 默认值:false
。
-uld|--use-local-db
指定应使用 LocalDB,而不使用 SQLite。 仅适用于 Individual
或 IndividualB2C
身份验证。 自 .NET Core 3.0 SDK 起可用。
-f|--framework <FRAMEWORK>
指定目标框架。
下表根据所使用的 SDK 版本号列出了默认值:
没有适用于 net8.0
的 React 模板,但是,如果你有兴趣使用 ASP.NET Core 开发 React 应用,请参阅 ASP.NET Core 中的单页应用 (SPA) 概述。
--kestrelHttpsPort
要用于 launchSettings.json 中的 HTTPS 终结点的端口号。 使用参数 no-https
时,此选项不适用(但为 no-https
选择单独或组织身份验证设置时忽略 --auth
)。
--use-program-main
如果指定,将使用显式 Program
类和 Main
方法,而不是顶级语句。 自 .NET SDK 6.0.300 之后可用。 默认值:false
。
razorclasslib
--no-restore
在项目创建期间不执行隐式还原。
-s|--support-pages-and-views
除了将组件添加到此库以外,还支持添加传统的 Razor 页面和视图。
webapiaot
创建启用了 AOT 发布的 Web API 项目。 有关详细信息,请参阅本机 AOT 部署 和 Web API(本机 AOT)模板。
--exclude-launch-settings
从生成的模板中排除 launchSettings.json。
-f|--framework <FRAMEWORK>
指定目标框架。
下表根据所使用的 SDK 版本号列出了默认值:
SDK 版本
IndividualB2C
- 使用 Azure AD B2C 进行个人身份验证。
SingleOrg
- 对一个租户进行组织身份验证。 Entra 外部 ID 租户也使用 SingleOrg。
Windows
- Windows 身份验证。
--aad-b2c-instance <INSTANCE>
要连接到的 Azure Active Directory B2C 实例。 与 IndividualB2C
身份验证结合使用。 默认值为 https://login.microsoftonline.com/tfp/
。
-minimal|--use-minimal-apis
创建使用 ASP.NET Core 最小 API 的项目。 默认值为 false
,但此选项被 -controllers
重写。 由于 -controllers
的默认值 为 false
,因此输入 dotnet new webapi
时不指定任一选项将创建最小的 API 项目。
-ssp|--susi-policy-id <ID>
此项目的登录和注册策略 ID。 与 IndividualB2C
身份验证结合使用。
--aad-instance <INSTANCE>
要连接到的 Azure Active Directory 实例。 与 SingleOrg
身份验证结合使用。 默认值为 https://login.microsoftonline.com/
。
--client-id <ID>
此项目的客户端 ID。 与 IndividualB2C
或 SingleOrg
身份验证结合使用。 默认值为 11111111-1111-1111-11111111111111111
。
-controllers|--use-controllers
是否使用控制器而不是最小 API。 如果同时指定了此选项并且已指定 -minimal
,则此选项将替代由 -minimal
指定的值。 默认值为 false
。 自 .NET 8 SDK 起可用。
--domain <DOMAIN>
目录租户的域。 与 IndividualB2C
或 SingleOrg
身份验证结合使用。 默认值为 qualified.domain.name
。
--tenant-id <ID>
要连接到的目录的 TenantId ID。 与 SingleOrg
身份验证结合使用。 默认值为 22222222-2222-2222-2222-222222222222
。
-r|--org-read-access
允许此应用程序对目录进行读取访问。 仅适用于 SingleOrg
身份验证。
--exclude-launch-settings
从生成的模板中排除 launchSettings.json。
--no-openapi
禁用 OpenAPI (Swagger) 支持。 不调用 AddSwaggerGen
、UseSwagger
和 UseSwaggerUI
。
--no-https
关闭 HTTPS。 不在 中创建任何 https 启动配置文件。 不在 Program.csapp.UseHsts
Startup.cs 中调用 app.UseHttpsRedirection
和 。 此选项仅适用于 IndividualB2C
或 SingleOrg
未用于身份验证的情况。
-uld|--use-local-db
指定应使用 LocalDB,而不使用 SQLite。 仅适用于 IndividualB2C
身份验证。
-f|--framework <FRAMEWORK>
指定目标框架。 选项在 .NET Core 2.2 SDK 中不可用。
下表根据所使用的 SDK 版本号列出了默认值:
SDK 版本
--roll-forward <ROLL_FORWARD_POLICY>
选择 SDK 版本时要使用的前滚策略,可作为特定 SDK 版本缺失时的回退,或者作为使用更高版本的指令。
有关详细信息,请参阅 global-json。
editorconfig
创建用于配置代码样式首选项的 .editorconfig 文件。
--empty
创建空的 .editorconfig 而非 .NET 的默认值。
dotnet new 命令
dotnet new list 命令
dotnet new 自定义模板
创建 dotnet new 自定义模板
隐式 using 指令