diff --git a/documentation/manpages/sdk/dotnet-migrate.1 b/documentation/manpages/sdk/dotnet-migrate.1 index 5a7e51ca9f3b..597a6275c919 100644 --- a/documentation/manpages/sdk/dotnet-migrate.1 +++ b/documentation/manpages/sdk/dotnet-migrate.1 @@ -14,7 +14,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "dotnet-migrate" "1" "2025-06-13" "" ".NET Documentation" +.TH "dotnet-migrate" "1" "2025-09-15" "" ".NET Documentation" .hy .SH dotnet migrate .PP @@ -49,7 +49,7 @@ A single project by specifying the \f[I]project.json\f[R] file to migrate. .IP \[bu] 2 All of the directories specified in the \f[I]global.json\f[R] file by passing in a path to the \f[I]global.json\f[R] file. .IP \[bu] 2 -A \f[I]solution.sln(x)\f[R] file, where it migrates the projects referenced in the solution. +A \f[I]solution.sln\f[R] file, where it migrates the projects referenced in the solution. .IP \[bu] 2 On all subdirectories of the given directory recursively. .PP @@ -72,7 +72,7 @@ a \f[I]project.json\f[R] file to migrate. .IP \[bu] 2 a \f[I]global.json\f[R] file: the folders specified in \f[I]global.json\f[R] are migrated. .IP \[bu] 2 -a \f[I]solution.sln(x)\f[R] file: the projects referenced in the solution are migrated. +a \f[I]solution.sln\f[R] file: the projects referenced in the solution are migrated. .IP \[bu] 2 a directory to migrate: recursively searches for \f[I]project.json\f[R] files to migrate inside the specified directory. .PP diff --git a/documentation/manpages/sdk/dotnet-new-sdk-templates.7 b/documentation/manpages/sdk/dotnet-new-sdk-templates.7 index b49bc3dde2e6..8fc161631978 100644 --- a/documentation/manpages/sdk/dotnet-new-sdk-templates.7 +++ b/documentation/manpages/sdk/dotnet-new-sdk-templates.7 @@ -15,11 +15,11 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "dotnet-new-sdk-templates" "7" "2025-06-13" "" ".NET Documentation" +.TH "dotnet-new-sdk-templates" "7" "2025-09-15" "" ".NET Documentation" .hy .SH NAME .PP -dotnet-new-sdk-templates - .NET default templates for dotnet new +dotnet-new-sdk-templates - Default templates for dotnet-new .SH DESCRIPTION .PP When you install the .NET SDK (https://dotnet.microsoft.com/download), you receive over a dozen built-in templates for creating projects and files, including console apps, class libraries, unit test projects, ASP.NET Core apps (including Angular (https://angular.io/) and React (https://reactjs.org/) projects), and configuration files. @@ -30,10 +30,19 @@ To list the built-in templates, run the \f[V]dotnet new list\f[R] command: dotnet new list \f[R] .fi +.SS Template options +.PP +The templates that ship with the .NET SDK has template-specific options. +To show the additional options available for the template, use the \f[V]--help\f[R] option with the template name argument, for example: \f[V]dotnet new console --help\f[R]. +The template-specific sections in this article also describe the options. +.PP +If the template supports multiple programming languages, the \f[V]--help\f[R] option will show help for the template in the default language. +By combining it with the \f[V]--language\f[R] option, you can see the help for other languages: \f[V]dotnet new console --help --language F#\f[R]. +.SS Preinstalled templates .PP -The following table shows the templates that come pre-installed with the .NET SDK. -The default language for the template is shown inside the brackets. -Click on the short name link to see the specific template options. +The following table shows the templates that come preinstalled with the .NET SDK. +The default language for the template is shown inside brackets. +To see any template-specific options, select the short name link. .PP .TS tab(@); @@ -51,257 +60,239 @@ Introduced T} _ T{ -Console Application +ASP.NET Core API T}@T{ -\f[V]console\f[R] +\f[V]webapiaot\f[R] T}@T{ -[C#], F#, VB +[C#] T}@T{ -Common/Console +Web/Web API/API/Service T}@T{ -1.0 +8.0 T} T{ -Class library +ASP.NET Core API controller T}@T{ -\f[V]classlib\f[R] +\f[V]apicontroller\f[R] T}@T{ -[C#], F#, VB +[C#] T}@T{ -Common/Library +Web/ASP.NET T}@T{ -1.0 +8.0 T} T{ -WPF Application +ASP.NET Core Empty T}@T{ -\f[V]wpf\f[R] +\f[V]web\f[R] T}@T{ -[C#], VB +[C#], F# T}@T{ -Common/WPF +Web/Empty T}@T{ -3.0 (5.0 for VB) +1.0 T} T{ -WPF Class library +ASP.NET Core Web API T}@T{ -\f[V]wpflib\f[R] +\f[V]webapi\f[R] T}@T{ -[C#], VB +[C#], F# T}@T{ -Common/WPF +Web/Web API/API/Service/WebAPI T}@T{ -3.0 (5.0 for VB) +1.0 T} T{ -WPF Custom Control Library +ASP.NET Core Web App (Model-View-Controller) T}@T{ -\f[V]wpfcustomcontrollib\f[R] +\f[V]mvc\f[R] T}@T{ -[C#], VB +[C#], F# T}@T{ -Common/WPF +Web/MVC T}@T{ -3.0 (5.0 for VB) +1.0 T} T{ -WPF User Control Library +ASP.NET Core Web App T}@T{ -\f[V]wpfusercontrollib\f[R] +\f[V]webapp, razor\f[R] T}@T{ -[C#], VB +[C#] T}@T{ -Common/WPF +Web/MVC/Razor Pages T}@T{ -3.0 (5.0 for VB) +2.2, 2.0 T} T{ -Windows Forms (WinForms) Application +ASP.NET Core gRPC Service T}@T{ -\f[V]winforms\f[R] +\f[V]grpc\f[R] T}@T{ -[C#], VB +[C#] T}@T{ -Common/WinForms +Web/gRPC T}@T{ -3.0 (5.0 for VB) +3.0 T} T{ -Windows Forms (WinForms) Class library +Blazor Web App T}@T{ -\f[V]winformslib\f[R] +\f[V]blazor\f[R] T}@T{ -[C#], VB +[C#] T}@T{ -Common/WinForms +Web/Blazor T}@T{ -3.0 (5.0 for VB) +8.0.100 T} T{ -Worker Service +Blazor WebAssembly Standalone App T}@T{ -\f[V]worker\f[R] +\f[V]blazorwasm\f[R] T}@T{ [C#] T}@T{ -Common/Worker/Web +Web/Blazor/WebAssembly/PWA T}@T{ -3.0 +3.1.300 T} T{ -MSTest Test Project +Class library T}@T{ -\f[V]mstest\f[R] +\f[V]classlib\f[R] T}@T{ [C#], F#, VB T}@T{ -Test/MSTest +Common/Library T}@T{ 1.0 T} T{ -MSTest Test Class +Console Application T}@T{ -\f[V]mstest-class\f[R] +\f[V]console\f[R] T}@T{ [C#], F#, VB T}@T{ -Test/MSTest +Common/Console T}@T{ 1.0 T} T{ -NUnit 3 Test Project -T}@T{ -\f[V]nunit\f[R] -T}@T{ -[C#], F#, VB -T}@T{ -Test/NUnit -T}@T{ -2.1.400 -T} -T{ -NUnit 3 Test Item +Directory.Build.props file T}@T{ -\f[V]nunit-test\f[R] +\f[V]buildprops\f[R] T}@T{ -[C#], F#, VB T}@T{ -Test/NUnit +Config T}@T{ -2.2 +8.0.100 T} T{ -xUnit Test Project +Directory.Build.targets file T}@T{ -\f[V]xunit\f[R] +\f[V]buildtargets\f[R] T}@T{ -[C#], F#, VB T}@T{ -Test/xUnit +Config T}@T{ -1.0 +8.0.100 T} T{ -Razor Component +Dotnet local tool manifest file T}@T{ -\f[V]razorcomponent\f[R] +\f[V]tool-manifest\f[R] T}@T{ -[C#] T}@T{ -Web/ASP.NET +Config T}@T{ 3.0 T} T{ -Razor Page +EditorConfig file T}@T{ -\f[V]page\f[R] +\f[V]editorconfig\f[R] T}@T{ -[C#] T}@T{ -Web/ASP.NET +Config T}@T{ -2.0 +6.0 T} T{ -MVC ViewImports +global.json file T}@T{ -\f[V]viewimports\f[R] +\f[V]globaljson\f[R] T}@T{ -[C#] T}@T{ -Web/ASP.NET +Config T}@T{ 2.0 T} T{ -MVC ViewStart +MSTest Test Class T}@T{ -\f[V]viewstart\f[R] +\f[V]mstest-class\f[R] T}@T{ -[C#] +[C#], F#, VB T}@T{ -Web/ASP.NET +Test/MSTest T}@T{ -2.0 +1.0 T} T{ -Blazor Web App +MSTest Test Project T}@T{ -\f[V]blazor\f[R] +\f[V]mstest\f[R] T}@T{ -[C#] +[C#], F#, VB T}@T{ -Web/Blazor +Test/MSTest T}@T{ -8.0.100 +1.0 T} T{ -Blazor WebAssembly Standalone App +NUnit 3 Test Item T}@T{ -\f[V]blazorwasm\f[R] +\f[V]nunit-test\f[R] T}@T{ -[C#] +[C#], F#, VB T}@T{ -Web/Blazor/WebAssembly/PWA +Test/NUnit T}@T{ -3.1.300 +2.2 T} T{ -ASP.NET Core Empty +NUnit 3 Test Project T}@T{ -\f[V]web\f[R] +\f[V]nunit\f[R] T}@T{ -[C#], F# +[C#], F#, VB T}@T{ -Web/Empty +Test/NUnit T}@T{ -1.0 +2.1.400 T} T{ -ASP.NET Core Web App (Model-View-Controller) +NuGet Config T}@T{ -\f[V]mvc\f[R] +\f[V]nugetconfig\f[R] T}@T{ -[C#], F# T}@T{ -Web/MVC +Config T}@T{ 1.0 T} T{ -ASP.NET Core Web App +Protocol Buffer File T}@T{ -\f[V]webapp, razor\f[R] +\f[V]proto\f[R] T}@T{ -[C#] T}@T{ -Web/MVC/Razor Pages +Web/gRPC T}@T{ -2.2, 2.0 +3.0 T} T{ Razor Class Library @@ -315,212 +306,192 @@ T}@T{ 2.1 T} T{ -ASP.NET Core Web API -T}@T{ -\f[V]webapi\f[R] -T}@T{ -[C#], F# -T}@T{ -Web/Web API/API/Service/WebAPI -T}@T{ -1.0 -T} -T{ -ASP.NET Core API +Razor Component T}@T{ -\f[V]webapiaot\f[R] +\f[V]razorcomponent\f[R] T}@T{ [C#] T}@T{ -Web/Web API/API/Service +Web/ASP.NET T}@T{ -8.0 +3.0 T} T{ -ASP.NET Core API controller +Razor Page T}@T{ -\f[V]apicontroller\f[R] +\f[V]page\f[R] T}@T{ [C#] T}@T{ Web/ASP.NET T}@T{ -8.0 +2.0 T} T{ -ASP.NET Core gRPC Service +Solution File T}@T{ -\f[V]grpc\f[R] +\f[V]sln\f[R] T}@T{ -[C#] T}@T{ -Web/gRPC +Solution T}@T{ -3.0 +1.0 T} T{ -dotnet gitignore file +Web Config T}@T{ -\f[V]gitignore\f[R] +\f[V]webconfig\f[R] T}@T{ T}@T{ Config T}@T{ -3.0 +1.0 T} T{ -global.json file +Windows Forms (WinForms) Application T}@T{ -\f[V]globaljson\f[R] +\f[V]winforms\f[R] T}@T{ +[C#], VB T}@T{ -Config +Common/WinForms T}@T{ -2.0 +3.0 (5.0 for VB) T} T{ -NuGet Config -T}@T{ -\f[V]nugetconfig\f[R] -T}@T{ -T}@T{ -Config -T}@T{ -1.0 -T} -T{ -Dotnet local tool manifest file -T}@T{ -\f[V]tool-manifest\f[R] -T}@T{ -T}@T{ -Config -T}@T{ -3.0 -T} -T{ -Web Config -T}@T{ -\f[V]webconfig\f[R] -T}@T{ -T}@T{ -Config -T}@T{ -1.0 -T} -T{ -Solution File +Windows Forms (WinForms) Class library T}@T{ -\f[V]sln\f[R] +\f[V]winformslib\f[R] T}@T{ +[C#], VB T}@T{ -Solution +Common/WinForms T}@T{ -1.0 +3.0 (5.0 for VB) T} T{ -Protocol Buffer File +Worker Service T}@T{ -\f[V]proto\f[R] +\f[V]worker\f[R] T}@T{ +[C#] T}@T{ -Web/gRPC +Common/Worker/Web T}@T{ 3.0 T} T{ -EditorConfig file +WPF Application T}@T{ -\f[V]editorconfig\f[R] +\f[V]wpf\f[R] T}@T{ +[C#], VB T}@T{ -Config +Common/WPF T}@T{ -6.0 +3.0 (5.0 for VB) T} -.TE -.PP -The following table shows templates that have been discontinued and no longer come pre-installed with the .NET SDK. -Click on the short name link to see the specific template options. -.PP -.TS -tab(@); -l l l l l. T{ -Templates +WPF Class library T}@T{ -Short name +\f[V]wpflib\f[R] T}@T{ -Language +[C#], VB T}@T{ -Tags +Common/WPF T}@T{ -Discontinued since +3.0 (5.0 for VB) T} -_ T{ -ASP.NET Core with Angular +WPF Custom Control Library T}@T{ -\f[V]angular\f[R] +\f[V]wpfcustomcontrollib\f[R] T}@T{ -[C#] +[C#], VB T}@T{ -Web/MVC/SPA +Common/WPF T}@T{ -8.0 +3.0 (5.0 for VB) T} T{ -ASP.NET Core with React.js +WPF User Control Library T}@T{ -\f[V]react\f[R] +\f[V]wpfusercontrollib\f[R] T}@T{ -[C#] +[C#], VB T}@T{ -Web/MVC/SPA +Common/WPF T}@T{ -8.0 +3.0 (5.0 for VB) T} T{ -Blazor Server App +xUnit Test Project T}@T{ -\f[V]blazorserver\f[R] +\f[V]xunit\f[R] T}@T{ -[C#] +[C#], F#, VB T}@T{ -Web/Blazor +Test/xUnit T}@T{ -8.0 +1.0 T} T{ -Blazor Server App Empty +MVC ViewImports T}@T{ -\f[V]blazorserver-empty\f[R] +\f[V]viewimports\f[R] T}@T{ [C#] T}@T{ -Web/Blazor +Web/ASP.NET T}@T{ -8.0 +2.0 T} T{ -Blazor WebAssembly App Empty +MVC ViewStart T}@T{ -\f[V]blazorwasm-empty\f[R] +\f[V]viewstart\f[R] T}@T{ [C#] T}@T{ -Web/Blazor/WebAssembly +Web/ASP.NET T}@T{ -8.0 +2.0 T} .TE -.SS Template options +.SS \f[V]buildprops\f[R] .PP -Each template may have additional options available. -To show the additional options available for the template use the \f[V]--help\f[R] option with the template name argument, for example: \f[V]dotnet new console --help\f[R]. -In case the template supports multiple languages, this command will show help for the template in the default language. -By combining it with the \f[V]--language\f[R] option, you can see the help for other languages: \f[V]dotnet new console --help --language F#\f[R]. -The templates that ship with the .NET SDK have the following additional options: +Creates a \f[I]Directory.Build.props\f[R] file for customizing MSBuild properties for an entire folder tree. +For more information, see Customize your build. +.IP \[bu] 2 +\f[B]\f[VB]--inherit\f[B]\f[R] +.RS 2 +.PP +If specified, adds an Import element for the closest \f[I]Directory.Build.props\f[R] file in the parent directory hierarchy. +By default, \f[I]Directory.Build.props\f[R] files don\[cq]t inherit from parent directories, so enabling this option allows you to build up a hierarchy of customizations folder-by-folder. +.RE +.IP \[bu] 2 +\f[B]\f[VB]--use-artifacts\f[B]\f[R] +.RS 2 +.PP +If specified, adds a property to enable the artifacts output layout. +This is a common pattern for projects that produce build artifacts, such as NuGet packages, that are placed in a common folder structure. +For more information, see Artifacts output layout. +.RE +.PP + * * * * * +.SS \f[V]buildtargets\f[R] +.PP +Creates a \f[I]Directory.Build.targets\f[R] file for customizing MSBuild targets and tasks for an entire folder tree. +For more information, see Customize your build. +.IP \[bu] 2 +\f[B]\f[VB]--inherit\f[B]\f[R] +.RS 2 +.PP +If specified, adds an Import element for the closest \f[I]Directory.Build.targets\f[R] file in the parent directory hierarchy. +By default, \f[I]Directory.Build.targets\f[R] files don\[cq]t inherit from parent directories, so enabling this option allows you to build up a hierarchy of customizations folder-by-folder. +.RE +.PP + * * * * * .SS \f[V]console\f[R] .IP \[bu] 2 \f[B]\f[VB]-f|--framework \f[B]\f[R] @@ -975,138 +946,152 @@ The default value is \f[V]MyApp.Namespace\f[R]. .RE .PP * * * * * -.SS \f[V]blazorserver\f[R] -.PP -\f[B]Discontinued since .NET 8 SDK.\f[R] +.SS \f[V]blazor\f[R] .IP \[bu] 2 -\f[B]\f[VB]-au|--auth \f[B]\f[R] +\f[B]\f[VB]-f|--framework \f[B]\f[R] .RS 2 .PP -The type of authentication to use. -The possible values are: -.IP \[bu] 2 -\f[V]None\f[R] - No authentication (Default). -.IP \[bu] 2 -\f[V]Individual\f[R] - Individual authentication. -.IP \[bu] 2 -\f[V]IndividualB2C\f[R] - Individual authentication with Azure AD B2C. -.IP \[bu] 2 -\f[V]SingleOrg\f[R] - Organizational authentication for a single tenant. -Entra External ID tenants also use \f[V]SingleOrg\f[R]. -.IP \[bu] 2 -\f[V]MultiOrg\f[R] - Organizational authentication for multiple tenants. -.IP \[bu] 2 -\f[V]Windows\f[R] - Windows authentication. -.RE -.IP \[bu] 2 -\f[B]\f[VB]--aad-b2c-instance \f[B]\f[R] -.RS 2 +Specifies the framework to target. .PP -The Azure Active Directory B2C instance to connect to. -Use with \f[V]IndividualB2C\f[R] authentication. -The default value is \f[V]https://login.microsoftonline.com/tfp/\f[R]. +This template is available for .NET 8 or later. .RE .IP \[bu] 2 -\f[B]\f[VB]-ssp|--susi-policy-id \f[B]\f[R] +\f[B]\f[VB]--no-restore\f[B]\f[R] .RS 2 .PP -The sign-in and sign-up policy ID for this project. -Use with \f[V]IndividualB2C\f[R] authentication. +Doesn\[cq]t execute an implicit restore during project creation. .RE .IP \[bu] 2 -\f[B]\f[VB]-rp|--reset-password-policy-id \f[B]\f[R] +\f[B]\f[VB]--exclude-launch-settings\f[B]\f[R] .RS 2 .PP -The reset password policy ID for this project. -Use with \f[V]IndividualB2C\f[R] authentication. +Excludes \f[I]launchSettings.json\f[R] from the generated app. .RE .IP \[bu] 2 -\f[B]\f[VB]-ep|--edit-profile-policy-id \f[B]\f[R] +\f[B]\f[VB]-int|--interactivity \f[B]\f[R] .RS 2 .PP -The edit profile policy ID for this project. -Use with \f[V]IndividualB2C\f[R] authentication. -.RE +Specifies which interactive render mode to use for interactive components. +The possible values are: .IP \[bu] 2 -\f[B]\f[VB]--aad-instance \f[B]\f[R] -.RS 2 -.PP -The Azure Active Directory instance to connect to. -Use with \f[V]SingleOrg\f[R] or \f[V]MultiOrg\f[R] authentication. -The default value is \f[V]https://login.microsoftonline.com/\f[R]. -.RE +\f[V]None\f[R] - No interactivity (static server-side rendering only). .IP \[bu] 2 -\f[B]\f[VB]--client-id \f[B]\f[R] -.RS 2 -.PP -The Client ID for this project. -Use with \f[V]IndividualB2C\f[R], \f[V]SingleOrg\f[R], or \f[V]MultiOrg\f[R] authentication. -The default value is \f[V]11111111-1111-1111-11111111111111111\f[R]. -.RE +\f[V]Server\f[R] - (Default) Runs the app on the server with interactive server-side rendering. .IP \[bu] 2 -\f[B]\f[VB]--domain \f[B]\f[R] -.RS 2 -.PP -The domain for the directory tenant. -Use with \f[V]SingleOrg\f[R] or \f[V]IndividualB2C\f[R] authentication. -The default value is \f[V]qualified.domain.name\f[R]. +\f[V]WebAssembly\f[R] - Runs the app using client-side rendering in the browser with WebAssembly. +.IP \[bu] 2 +\f[V]Auto\f[R] - Uses interactive server-side rendering while downloading the Blazor bundle and activating the Blazor runtime on the client, then uses client-side rendering with WebAssembly. .RE .IP \[bu] 2 -\f[B]\f[VB]--tenant-id \f[B]\f[R] +\f[B]\f[VB]--empty\f[B]\f[R] .RS 2 .PP -The TenantId ID of the directory to connect to. -Use with \f[V]SingleOrg\f[R] authentication. -The default value is \f[V]22222222-2222-2222-2222-222222222222\f[R]. +Omits sample pages and styling that demonstrate basic usage patterns. .RE .IP \[bu] 2 -\f[B]\f[VB]--callback-path \f[B]\f[R] +\f[B]\f[VB]-au|--auth \f[B]\f[R] .RS 2 .PP -The request path within the application\[cq]s base path of the redirect URI. -Use with \f[V]SingleOrg\f[R] or \f[V]IndividualB2C\f[R] authentication. -The default value is \f[V]/signin-oidc\f[R]. +The type of authentication to use. +The possible values are: +.IP \[bu] 2 +\f[V]None\f[R] - No authentication (Default). +.IP \[bu] 2 +\f[V]Individual\f[R] - Individual authentication. .RE .IP \[bu] 2 -\f[B]\f[VB]-r|--org-read-access\f[B]\f[R] +\f[B]\f[VB]-uld|--use-local-db\f[B]\f[R] .RS 2 .PP -Allows this application read-access to the directory. -Only applies to \f[V]SingleOrg\f[R] or \f[V]MultiOrg\f[R] authentication. +Specifies LocalDB should be used instead of SQLite. +Only applies to \f[V]Individual\f[R] authentication. .RE .IP \[bu] 2 -\f[B]\f[VB]--exclude-launch-settings\f[B]\f[R] +\f[B]\f[VB]-ai|--all-interactive\f[B]\f[R] .RS 2 .PP -Excludes \f[I]launchSettings.json\f[R] from the generated template. +Makes every page interactive by applying an interactive render mode at the top level. +If \f[V]false\f[R], pages use static server-side rendering by default and can be marked interactive on a per-page or per-component basis. +This option is only effective if the \f[V]-i|--interactivity\f[R] option isn\[cq]t set to \f[V]None\f[R]. .RE .IP \[bu] 2 \f[B]\f[VB]--no-https\f[B]\f[R] .RS 2 .PP Turns off HTTPS. -This option only applies if \f[V]Individual\f[R], \f[V]IndividualB2C\f[R], \f[V]SingleOrg\f[R], or \f[V]MultiOrg\f[R] aren\[cq]t being used for \f[V]--auth\f[R]. +This option only applies if \f[V]Individual\f[R] isn\[cq]t chosen for the \f[V]-au|--auth\f[R] option. .RE .IP \[bu] 2 -\f[B]\f[VB]-uld|--use-local-db\f[B]\f[R] +\f[B]\f[VB]--use-program-main\f[B]\f[R] .RS 2 .PP -Specifies LocalDB should be used instead of SQLite. -Only applies to \f[V]Individual\f[R] or \f[V]IndividualB2C\f[R] authentication. +If specified, an explicit \f[V]Program\f[R] class and \f[V]Main\f[R] method is generated instead of top-level statements. .RE +.PP + * * * * * +.SS \f[V]web\f[R] .IP \[bu] 2 -\f[B]\f[VB]--no-restore\f[B]\f[R] +\f[B]\f[VB]--exclude-launch-settings\f[B]\f[R] .RS 2 .PP -Doesn\[cq]t execute an implicit restore during project creation. +Excludes \f[I]launchSettings.json\f[R] from the generated template. .RE .IP \[bu] 2 -\f[B]\f[VB]--kestrelHttpPort\f[B]\f[R] +\f[B]\f[VB]-f|--framework \f[B]\f[R] .RS 2 .PP -Port number to use for the HTTP endpoint in \f[I]launchSettings.json\f[R]. -.RE -.IP \[bu] 2 +Specifies the framework to target. +Option not available in .NET Core 2.2 SDK. +.PP +The following table lists the default values according to the SDK version number you\[cq]re using: +.PP +.TS +tab(@); +l l. +T{ +SDK version +T}@T{ +Default value +T} +_ +T{ +9.0 +T}@T{ +\f[V]net9.0\f[R] +T} +T{ +8.0 +T}@T{ +\f[V]net8.0\f[R] +T} +T{ +7.0 +T}@T{ +\f[V]net7.0\f[R] +T} +.TE +.PP +To create a project that targets a framework earlier than the SDK that you\[cq]re using, see \f[V]--framework\f[R] for \f[V]console\f[R] projects earlier in this article. +.RE +.IP \[bu] 2 +\f[B]\f[VB]--no-restore\f[B]\f[R] +.RS 2 +.PP +Doesn\[cq]t execute an implicit restore during project creation. +.RE +.IP \[bu] 2 +\f[B]\f[VB]--no-https\f[B]\f[R] +.RS 2 +.PP +Turns off HTTPS. +.RE +.IP \[bu] 2 +\f[B]\f[VB]--kestrelHttpPort\f[B]\f[R] +.RS 2 +.PP +Port number to use for the HTTP endpoint in \f[I]launchSettings.json\f[R]. +.RE +.IP \[bu] 2 \f[B]\f[VB]--kestrelHttpsPort\f[B]\f[R] .RS 2 .PP @@ -1123,95 +1108,129 @@ Default value: \f[V]false\f[R]. .RE .PP * * * * * -.SS \f[V]blazor\f[R] +.SS \f[V]mvc\f[R], \f[V]webapp\f[R] .IP \[bu] 2 -\f[B]\f[VB]-f|--framework \f[B]\f[R] +\f[B]\f[VB]-au|--auth \f[B]\f[R] .RS 2 .PP -Specifies the framework to target. -.PP -This template is available for .NET 8 or later. +The type of authentication to use. +The possible values are: +.IP \[bu] 2 +\f[V]None\f[R] - No authentication (Default). +.IP \[bu] 2 +\f[V]Individual\f[R] - Individual authentication. +.IP \[bu] 2 +\f[V]IndividualB2C\f[R] - Individual authentication with Azure AD B2C. +.IP \[bu] 2 +\f[V]SingleOrg\f[R] - Organizational authentication for a single tenant. +Entra External ID tenants also use SingleOrg. +.IP \[bu] 2 +\f[V]MultiOrg\f[R] - Organizational authentication for multiple tenants. +.IP \[bu] 2 +\f[V]Windows\f[R] - Windows authentication. .RE .IP \[bu] 2 -\f[B]\f[VB]--no-restore\f[B]\f[R] +\f[B]\f[VB]--aad-b2c-instance \f[B]\f[R] .RS 2 .PP -Doesn\[cq]t execute an implicit restore during project creation. +The Azure Active Directory B2C instance to connect to. +Use with \f[V]IndividualB2C\f[R] authentication. +The default value is \f[V]https://login.microsoftonline.com/tfp/\f[R]. .RE .IP \[bu] 2 -\f[B]\f[VB]--exclude-launch-settings\f[B]\f[R] +\f[B]\f[VB]-ssp|--susi-policy-id \f[B]\f[R] .RS 2 .PP -Excludes \f[I]launchSettings.json\f[R] from the generated app. +The sign-in and sign-up policy ID for this project. +Use with \f[V]IndividualB2C\f[R] authentication. .RE .IP \[bu] 2 -\f[B]\f[VB]-int|--interactivity \f[B]\f[R] +\f[B]\f[VB]-rp|--reset-password-policy-id \f[B]\f[R] .RS 2 .PP -Specifies which interactive render mode to use for interactive components. -The possible values are: -.IP \[bu] 2 -\f[V]None\f[R] - No interactivity (static server-side rendering only). -.IP \[bu] 2 -\f[V]Server\f[R] - (Default) Runs the app on the server with interactive server-side rendering. +The reset password policy ID for this project. +Use with \f[V]IndividualB2C\f[R] authentication. +.RE .IP \[bu] 2 -\f[V]WebAssembly\f[R] - Runs the app using client-side rendering in the browser with WebAssembly. +\f[B]\f[VB]-ep|--edit-profile-policy-id \f[B]\f[R] +.RS 2 +.PP +The edit profile policy ID for this project. +Use with \f[V]IndividualB2C\f[R] authentication. +.RE .IP \[bu] 2 -\f[V]Auto\f[R] - Uses interactive server-side rendering while downloading the Blazor bundle and activating the Blazor runtime on the client, then uses client-side rendering with WebAssembly. +\f[B]\f[VB]--aad-instance \f[B]\f[R] +.RS 2 +.PP +The Azure Active Directory instance to connect to. +Use with \f[V]SingleOrg\f[R] or \f[V]MultiOrg\f[R] authentication. +The default value is \f[V]https://login.microsoftonline.com/\f[R]. .RE .IP \[bu] 2 -\f[B]\f[VB]--empty\f[B]\f[R] +\f[B]\f[VB]--client-id \f[B]\f[R] .RS 2 .PP -Omits sample pages and styling that demonstrate basic usage patterns. +The Client ID for this project. +Use with \f[V]IndividualB2C\f[R], \f[V]SingleOrg\f[R], or \f[V]MultiOrg\f[R] authentication. +The default value is \f[V]11111111-1111-1111-11111111111111111\f[R]. .RE .IP \[bu] 2 -\f[B]\f[VB]-au|--auth \f[B]\f[R] +\f[B]\f[VB]--domain \f[B]\f[R] .RS 2 .PP -The type of authentication to use. -The possible values are: +The domain for the directory tenant. +Use with \f[V]SingleOrg\f[R] or \f[V]IndividualB2C\f[R] authentication. +The default value is \f[V]qualified.domain.name\f[R]. +.RE .IP \[bu] 2 -\f[V]None\f[R] - No authentication (Default). +\f[B]\f[VB]--tenant-id \f[B]\f[R] +.RS 2 +.PP +The TenantId ID of the directory to connect to. +Use with \f[V]SingleOrg\f[R] authentication. +The default value is \f[V]22222222-2222-2222-2222-222222222222\f[R]. +.RE .IP \[bu] 2 -\f[V]Individual\f[R] - Individual authentication. +\f[B]\f[VB]--callback-path \f[B]\f[R] +.RS 2 +.PP +The request path within the application\[cq]s base path of the redirect URI. +Use with \f[V]SingleOrg\f[R] or \f[V]IndividualB2C\f[R] authentication. +The default value is \f[V]/signin-oidc\f[R]. .RE .IP \[bu] 2 -\f[B]\f[VB]-uld|--use-local-db\f[B]\f[R] +\f[B]\f[VB]-r|--org-read-access\f[B]\f[R] .RS 2 .PP -Specifies LocalDB should be used instead of SQLite. -Only applies to \f[V]Individual\f[R] authentication. +Allows this application read-access to the directory. +Only applies to \f[V]SingleOrg\f[R] or \f[V]MultiOrg\f[R] authentication. .RE .IP \[bu] 2 -\f[B]\f[VB]-ai|--all-interactive\f[B]\f[R] +\f[B]\f[VB]--exclude-launch-settings\f[B]\f[R] .RS 2 .PP -Makes every page interactive by applying an interactive render mode at the top level. -If \f[V]false\f[R], pages use static server-side rendering by default and can be marked interactive on a per-page or per-component basis. -This option is only effective if the \f[V]-i|--interactivity\f[R] option isn\[cq]t set to \f[V]None\f[R]. +Excludes \f[I]launchSettings.json\f[R] from the generated template. .RE .IP \[bu] 2 \f[B]\f[VB]--no-https\f[B]\f[R] .RS 2 .PP Turns off HTTPS. -This option only applies if \f[V]Individual\f[R] isn\[cq]t chosen for the \f[V]-au|--auth\f[R] option. +This option only applies if \f[V]Individual\f[R], \f[V]IndividualB2C\f[R], \f[V]SingleOrg\f[R], or \f[V]MultiOrg\f[R] aren\[cq]t being used. .RE .IP \[bu] 2 -\f[B]\f[VB]--use-program-main\f[B]\f[R] +\f[B]\f[VB]-uld|--use-local-db\f[B]\f[R] .RS 2 .PP -If specified, an explicit \f[V]Program\f[R] class and \f[V]Main\f[R] method is generated instead of top-level statements. +Specifies LocalDB should be used instead of SQLite. +Only applies to \f[V]Individual\f[R] or \f[V]IndividualB2C\f[R] authentication. .RE -.PP - * * * * * -.SS \f[V]blazorwasm\f[R] .IP \[bu] 2 \f[B]\f[VB]-f|--framework \f[B]\f[R] .RS 2 .PP Specifies the framework to target. +Option available since .NET Core 3.0 SDK. .PP The following table lists the default values according to the SDK version number you\[cq]re using: .PP @@ -1250,12 +1269,112 @@ To create a project that targets a framework earlier than the SDK that you\[cq]r Doesn\[cq]t execute an implicit restore during project creation. .RE .IP \[bu] 2 -\f[B]\f[VB]-ho|--hosted\f[B]\f[R] +\f[B]\f[VB]--use-browserlink\f[B]\f[R] .RS 2 .PP -Includes an ASP.NET Core host for the Blazor WebAssembly app. +Includes BrowserLink in the project. +.RE +.IP \[bu] 2 +\f[B]\f[VB]-rrc|--razor-runtime-compilation\f[B]\f[R] +.RS 2 +.PP +Determines if the project is configured to use Razor runtime compilation in Debug builds. +.RE +.IP \[bu] 2 +\f[B]\f[VB]--kestrelHttpPort\f[B]\f[R] +.RS 2 +.PP +Port number to use for the HTTP endpoint in \f[I]launchSettings.json\f[R]. +.RE +.IP \[bu] 2 +\f[B]\f[VB]--kestrelHttpsPort\f[B]\f[R] +.RS 2 +.PP +Port number to use for the HTTPS endpoint in \f[I]launchSettings.json\f[R]. +This option is not applicable when the parameter \f[V]no-https\f[R] is used (but \f[V]no-https\f[R] is ignored when an individual or organizational authentication setting is chosen for \f[V]--auth\f[R]). +.RE +.IP \[bu] 2 +\f[B]\f[VB]--use-program-main\f[B]\f[R] +.RS 2 +.PP +If specified, an explicit \f[V]Program\f[R] class and \f[V]Main\f[R] method will be used instead of top-level statements. +Available since .NET SDK 6.0.300. +Default value: \f[V]false\f[R]. +.RE +.PP + * * * * * +.SS \f[V]razorclasslib\f[R] +.IP \[bu] 2 +\f[B]\f[VB]--no-restore\f[B]\f[R] +.RS 2 +.PP +Doesn\[cq]t execute an implicit restore during project creation. +.RE +.IP \[bu] 2 +\f[B]\f[VB]-s|--support-pages-and-views\f[B]\f[R] +.RS 2 +.PP +Supports adding traditional Razor pages and Views in addition to components to this library. +.RE +.PP + * * * * * +.SS \f[V]webapiaot\f[R] +.PP +Creates a web API project with AOT publish enabled. +For more information, see Native AOT deployment and The Web API (Native AOT) template. +.IP \[bu] 2 +\f[B]\f[VB]--exclude-launch-settings\f[B]\f[R] +.RS 2 +.PP +Excludes \f[I]launchSettings.json\f[R] from the generated template. +.RE +.IP \[bu] 2 +\f[B]\f[VB]-f|--framework \f[B]\f[R] +.RS 2 +.PP +Specifies the framework to target. +.PP +The following table lists the default values according to the SDK version number you\[cq]re using: +.PP +.TS +tab(@); +l l. +T{ +SDK version +T}@T{ +Default value +T} +_ +T{ +9.0 +T}@T{ +\f[V]net9.0\f[R] +T} +T{ +8.0 +T}@T{ +\f[V]net8.0\f[R] +T} +.TE +.RE +.IP \[bu] 2 +\f[B]\f[VB]--no-restore\f[B]\f[R] +.RS 2 +.PP +Doesn\[cq]t execute an implicit restore during project creation. .RE .IP \[bu] 2 +\f[B]\f[VB]--use-program-main\f[B]\f[R] +.RS 2 +.PP +If specified, an explicit \f[V]Program\f[R] class and \f[V]Main\f[R] method will be used instead of top-level statements. +Available since .NET SDK 6.0.300. +Default value: \f[V]false\f[R]. +.RE +.PP + * * * * * +.SS \f[V]webapi\f[R] +.IP \[bu] 2 \f[B]\f[VB]-au|--auth \f[B]\f[R] .RS 2 .PP @@ -1264,20 +1383,12 @@ The possible values are: .IP \[bu] 2 \f[V]None\f[R] - No authentication (Default). .IP \[bu] 2 -\f[V]Individual\f[R] - Individual authentication. -.IP \[bu] 2 \f[V]IndividualB2C\f[R] - Individual authentication with Azure AD B2C. .IP \[bu] 2 \f[V]SingleOrg\f[R] - Organizational authentication for a single tenant. Entra External ID tenants also use SingleOrg. -.RE .IP \[bu] 2 -\f[B]\f[VB]--authority \f[B]\f[R] -.RS 2 -.PP -The authority of the OIDC provider. -Use with \f[V]Individual\f[R] authentication. -The default value is \f[V]https://login.microsoftonline.com/\f[R]. +\f[V]Windows\f[R] - Windows authentication. .RE .IP \[bu] 2 \f[B]\f[VB]--aad-b2c-instance \f[B]\f[R] @@ -1285,7 +1396,15 @@ The default value is \f[V]https://login.microsoftonline.com/\f[R]. .PP The Azure Active Directory B2C instance to connect to. Use with \f[V]IndividualB2C\f[R] authentication. -The default value is \f[V]https://aadB2CInstance.b2clogin.com/\f[R]. +The default value is \f[V]https://login.microsoftonline.com/tfp/\f[R]. +.RE +.IP \[bu] 2 +\f[B]\f[VB]-minimal|--use-minimal-apis\f[B]\f[R] +.RS 2 +.PP +Create a project that uses the ASP.NET Core minimal API. +Default is \f[V]false\f[R], but this option is overridden by \f[V]-controllers\f[R]. +Since the default for \f[V]-controllers\f[R] is \f[V]false\f[R], entering \f[V]dotnet new webapi\f[R] without specifying either option creates a minimal API project. .RE .IP \[bu] 2 \f[B]\f[VB]-ssp|--susi-policy-id \f[B]\f[R] @@ -1307,55 +1426,265 @@ The default value is \f[V]https://login.microsoftonline.com/\f[R]. .RS 2 .PP The Client ID for this project. -Use with \f[V]IndividualB2C\f[R], \f[V]SingleOrg\f[R], or \f[V]Individual\f[R] authentication in standalone scenarios. -The default value is \f[V]33333333-3333-3333-33333333333333333\f[R]. +Use with \f[V]IndividualB2C\f[R] or \f[V]SingleOrg\f[R] authentication. +The default value is \f[V]11111111-1111-1111-11111111111111111\f[R]. +.RE +.IP \[bu] 2 +\f[B]\f[VB]-controllers|--use-controllers\f[B]\f[R] +.RS 2 +.PP +Whether to use controllers instead of minimal APIs. +If both this option and \f[V]-minimal\f[R] are specified, this option overrides the value specified by \f[V]-minimal\f[R]. +Default is \f[V]false\f[R]. +Available since .NET 8 SDK. .RE .IP \[bu] 2 \f[B]\f[VB]--domain \f[B]\f[R] .RS 2 .PP The domain for the directory tenant. -Use with \f[V]SingleOrg\f[R] or \f[V]IndividualB2C\f[R] authentication. +Use with \f[V]IndividualB2C\f[R] or \f[V]SingleOrg\f[R] authentication. The default value is \f[V]qualified.domain.name\f[R]. .RE .IP \[bu] 2 -\f[B]\f[VB]--app-id-uri \f[B]\f[R] +\f[B]\f[VB]--tenant-id \f[B]\f[R] +.RS 2 +.PP +The TenantId ID of the directory to connect to. +Use with \f[V]SingleOrg\f[R] authentication. +The default value is \f[V]22222222-2222-2222-2222-222222222222\f[R]. +.RE +.IP \[bu] 2 +\f[B]\f[VB]-r|--org-read-access\f[B]\f[R] +.RS 2 +.PP +Allows this application read-access to the directory. +Only applies to \f[V]SingleOrg\f[R] authentication. +.RE +.IP \[bu] 2 +\f[B]\f[VB]--exclude-launch-settings\f[B]\f[R] +.RS 2 +.PP +Excludes \f[I]launchSettings.json\f[R] from the generated template. +.RE +.IP \[bu] 2 +\f[B]\f[VB]--no-openapi\f[B]\f[R] +.RS 2 +.PP +Turns off OpenAPI (Swagger) support. +\f[V]AddOpenApi\f[R] and \f[V]MapOpenApi\f[R] aren\[cq]t called. +.RE +.IP \[bu] 2 +\f[B]\f[VB]--no-https\f[B]\f[R] +.RS 2 +.PP +Turns off HTTPS. +No \f[I]https\f[R] launch profile is created in \f[V]launchSettings.json\f[R]. +\f[V]app.UseHsts\f[R] and \f[V]app.UseHttpsRedirection\f[R] aren\[cq]t called in \f[I]Program.cs\f[R]/\f[I]Startup.cs\f[R]. +This option only applies if \f[V]IndividualB2C\f[R] or \f[V]SingleOrg\f[R] aren\[cq]t being used for authentication. +.RE +.IP \[bu] 2 +\f[B]\f[VB]-uld|--use-local-db\f[B]\f[R] +.RS 2 +.PP +Specifies LocalDB should be used instead of SQLite. +Only applies to \f[V]IndividualB2C\f[R] authentication. +.RE +.IP \[bu] 2 +\f[B]\f[VB]-f|--framework \f[B]\f[R] +.RS 2 +.PP +Specifies the framework to target. +Option not available in .NET Core 2.2 SDK. +.PP +The following table lists the default values according to the SDK version number you\[cq]re using: +.PP +.TS +tab(@); +l l. +T{ +SDK version +T}@T{ +Default value +T} +_ +T{ +9.0 +T}@T{ +\f[V]net9.0\f[R] +T} +T{ +8.0 +T}@T{ +\f[V]net8.0\f[R] +T} +T{ +7.0 +T}@T{ +\f[V]net7.0\f[R] +T} +.TE +.PP +To create a project that targets a framework earlier than the SDK that you\[cq]re using, see \f[V]--framework\f[R] for \f[V]console\f[R] projects earlier in this article. +.RE +.IP \[bu] 2 +\f[B]\f[VB]--no-restore\f[B]\f[R] +.RS 2 +.PP +Doesn\[cq]t execute an implicit restore during project creation. +.RE +.IP \[bu] 2 +\f[B]\f[VB]--use-program-main\f[B]\f[R] +.RS 2 +.PP +If specified, an explicit \f[V]Program\f[R] class and \f[V]Main\f[R] method will be used instead of top-level statements. +Available since .NET SDK 6.0.300. +Default value: \f[V]false\f[R]. +.RE +.PP + * * * * * +.SS \f[V]apicontroller\f[R] +.PP +API Controller with or without read/write actions. +.IP \[bu] 2 +\f[B]\f[VB]-p:n|--name \f[B]\f[R] +.RS 2 +.PP +The namespace for the generated code. +Default is \f[V]MyApp.Namespace\f[R]. +.RE +.IP \[bu] 2 +\f[B]\f[VB]-ac|--actions\f[B]\f[R] +.RS 2 +.PP +Create a controller with read/write actions. +Default is \f[V]false\f[R]. +.RE +.PP + * * * * * +.SS \f[V]globaljson\f[R] +.IP \[bu] 2 +\f[B]\f[VB]--sdk-version \f[B]\f[R] +.RS 2 +.PP +Specifies the version of the .NET SDK to use in the \f[I]global.json\f[R] file. +.RE +.IP \[bu] 2 +\f[B]\f[VB]--roll-forward \f[B]\f[R] +.RS 2 +.PP +The roll-forward policy to use when selecting an SDK version, either as a fallback when a specific SDK version is missing or as a directive to use a later version. +For more information, see global-json. +.RE +.SS \f[V]sln\f[R] +.PP +Creates an empty solution file containing no projects. +.RS +.PP +In .NET SDK 9.0.200 and later, this template supports a \f[V]--format\f[R] option to choose between \f[V]sln\f[R] and \f[V]slnx\f[R] formats. +Starting with .NET 10, the default format is \f[V]slnx\f[R]. +.RE +.PP + * * * * * +.SS \f[V]editorconfig\f[R] +.PP +Creates an \f[I].editorconfig\f[R] file for configuring code style preferences. +.IP \[bu] 2 +\f[B]\f[VB]--empty\f[B]\f[R] .RS 2 .PP -The App ID Uri for the server API you want to call. -Use with \f[V]SingleOrg\f[R] or \f[V]IndividualB2C\f[R] authentication. -The default value is \f[V]api.id.uri\f[R]. -.RE +Creates an empty \f[I].editorconfig\f[R] instead of the defaults for .NET. +.RE +.SS Discontinued templates +.PP +The following table shows templates that have been discontinued and no longer come preinstalled with the .NET SDK. +To see any template-specific options, select the short name link. +.PP +.TS +tab(@); +l l l l l. +T{ +Templates +T}@T{ +Short name +T}@T{ +Language +T}@T{ +Tags +T}@T{ +Discontinued since +T} +_ +T{ +ASP.NET Core with Angular +T}@T{ +\f[V]angular\f[R] +T}@T{ +[C#] +T}@T{ +Web/MVC/SPA +T}@T{ +8.0 +T} +T{ +ASP.NET Core with React.js +T}@T{ +\f[V]react\f[R] +T}@T{ +[C#] +T}@T{ +Web/MVC/SPA +T}@T{ +8.0 +T} +T{ +Blazor Server App +T}@T{ +\f[V]blazorserver\f[R] +T}@T{ +[C#] +T}@T{ +Web/Blazor +T}@T{ +8.0 +T} +T{ +Blazor Server App Empty +T}@T{ +\f[V]blazorserver-empty\f[R] +T}@T{ +[C#] +T}@T{ +Web/Blazor +T}@T{ +8.0 +T} +T{ +Blazor WebAssembly App Empty +T}@T{ +\f[V]blazorwasm-empty\f[R] +T}@T{ +[C#] +T}@T{ +Web/Blazor/WebAssembly +T}@T{ +8.0 +T} +.TE +.SS \f[V]angular\f[R], \f[V]react\f[R] +.PP +\f[B]Discontinued since .NET 8 SDK.\f[R] .IP \[bu] 2 -\f[B]\f[VB]--api-client-id \f[B]\f[R] +\f[B]\f[VB]-au|--auth \f[B]\f[R] .RS 2 .PP -The Client ID for the API that the server hosts. -Use with \f[V]SingleOrg\f[R] or \f[V]IndividualB2C\f[R] authentication. -The default value is \f[V]11111111-1111-1111-11111111111111111\f[R]. -.RE -.IP \[bu] 2 -\f[B]\f[VB]-s|--default-scope \f[B]\f[R] -.RS 2 +The type of authentication to use. .PP -The API scope the client needs to request to provision an access token. -Use with \f[V]SingleOrg\f[R] or \f[V]IndividualB2C\f[R] authentication. -The default value is \f[V]user_impersonation\f[R]. -.RE +The possible values are: .IP \[bu] 2 -\f[B]\f[VB]--tenant-id \f[B]\f[R] -.RS 2 -.PP -The TenantId ID of the directory to connect to. -Use with \f[V]SingleOrg\f[R] authentication. -The default value is \f[V]22222222-2222-2222-2222-222222222222\f[R]. -.RE +\f[V]None\f[R] - No authentication (Default). .IP \[bu] 2 -\f[B]\f[VB]-r|--org-read-access\f[B]\f[R] -.RS 2 -.PP -Allows this application read-access to the directory. -Only applies to \f[V]SingleOrg\f[R] authentication. +\f[V]Individual\f[R] - Individual authentication. .RE .IP \[bu] 2 \f[B]\f[VB]--exclude-launch-settings\f[B]\f[R] @@ -1364,17 +1693,17 @@ Only applies to \f[V]SingleOrg\f[R] authentication. Excludes \f[I]launchSettings.json\f[R] from the generated template. .RE .IP \[bu] 2 -\f[B]\f[VB]-p|--pwa\f[B]\f[R] +\f[B]\f[VB]--no-restore\f[B]\f[R] .RS 2 .PP -produces a Progressive Web Application (PWA) supporting installation and offline use. +Doesn\[cq]t execute an implicit restore during project creation. .RE .IP \[bu] 2 \f[B]\f[VB]--no-https\f[B]\f[R] .RS 2 .PP Turns off HTTPS. -This option only applies if \f[V]Individual\f[R], \f[V]IndividualB2C\f[R], or \f[V]SingleOrg\f[R] aren\[cq]t being used for \f[V]--auth\f[R]. +This option only applies if authentication is \f[V]None\f[R]. .RE .IP \[bu] 2 \f[B]\f[VB]-uld|--use-local-db\f[B]\f[R] @@ -1382,68 +1711,19 @@ This option only applies if \f[V]Individual\f[R], \f[V]IndividualB2C\f[R], or \f .PP Specifies LocalDB should be used instead of SQLite. Only applies to \f[V]Individual\f[R] or \f[V]IndividualB2C\f[R] authentication. -.RE -.IP \[bu] 2 -\f[B]\f[VB]--called-api-url \f[B]\f[R] -.RS 2 -.PP -URL of the API to call from the web app. -Only applies to \f[V]SingleOrg\f[R] or \f[V]IndividualB2C\f[R] authentication without an ASP.NET Core host specified. -The default value is \f[V]https://graph.microsoft.com/v1.0/me\f[R]. -.RE -.IP \[bu] 2 -\f[B]\f[VB]--calls-graph\f[B]\f[R] -.RS 2 -.PP -Specifies if the web app calls Microsoft Graph. -Only applies to \f[V]SingleOrg\f[R] authentication. -.RE -.IP \[bu] 2 -\f[B]\f[VB]--called-api-scopes \f[B]\f[R] -.RS 2 -.PP -Scopes to request to call the API from the web app. -Only applies to \f[V]SingleOrg\f[R] or \f[V]IndividualB2C\f[R] authentication without an ASP.NET Core host specified. -The default is \f[V]user.read\f[R]. -.RE -.IP \[bu] 2 -\f[B]\f[VB]--kestrelHttpPort\f[B]\f[R] -.RS 2 -.PP -Port number to use for the HTTP endpoint in \f[I]launchSettings.json\f[R]. -.RE -.IP \[bu] 2 -\f[B]\f[VB]--kestrelHttpsPort\f[B]\f[R] -.RS 2 -.PP -Port number to use for the HTTPS endpoint in \f[I]launchSettings.json\f[R]. -This option is not applicable when the parameter \f[V]no-https\f[R] is used (but \f[V]no-https\f[R] is ignored when an individual or organizational authentication setting is chosen for \f[V]--auth\f[R]). -.RE -.IP \[bu] 2 -\f[B]\f[VB]--use-program-main\f[B]\f[R] -.RS 2 -.PP -If specified, an explicit \f[V]Program\f[R] class and \f[V]Main\f[R] method will be used instead of top-level statements. -Available since .NET SDK 6.0.300. -Default value: \f[V]false\f[R]. -.RE -.PP - * * * * * -.SS \f[V]web\f[R] -.IP \[bu] 2 -\f[B]\f[VB]--exclude-launch-settings\f[B]\f[R] -.RS 2 -.PP -Excludes \f[I]launchSettings.json\f[R] from the generated template. +Available since .NET Core 3.0 SDK. .RE .IP \[bu] 2 \f[B]\f[VB]-f|--framework \f[B]\f[R] .RS 2 .PP Specifies the framework to target. -Option not available in .NET Core 2.2 SDK. .PP The following table lists the default values according to the SDK version number you\[cq]re using: +.RS +.PP +There isn\[cq]t a React template for \f[V]net8.0\f[R], however, if you\[cq]re interested in developing React apps with ASP.NET Core, see Overview of Single Page Apps (SPAs) in ASP.NET Core. +.RE .PP .TS tab(@); @@ -1455,16 +1735,6 @@ Default value T} _ T{ -9.0 -T}@T{ -\f[V]net9.0\f[R] -T} -T{ -8.0 -T}@T{ -\f[V]net8.0\f[R] -T} -T{ 7.0 T}@T{ \f[V]net7.0\f[R] @@ -1474,18 +1744,6 @@ T} To create a project that targets a framework earlier than the SDK that you\[cq]re using, see \f[V]--framework\f[R] for \f[V]console\f[R] projects earlier in this article. .RE .IP \[bu] 2 -\f[B]\f[VB]--no-restore\f[B]\f[R] -.RS 2 -.PP -Doesn\[cq]t execute an implicit restore during project creation. -.RE -.IP \[bu] 2 -\f[B]\f[VB]--no-https\f[B]\f[R] -.RS 2 -.PP -Turns off HTTPS. -.RE -.IP \[bu] 2 \f[B]\f[VB]--kestrelHttpPort\f[B]\f[R] .RS 2 .PP @@ -1508,7 +1766,9 @@ Default value: \f[V]false\f[R]. .RE .PP * * * * * -.SS \f[V]mvc\f[R], \f[V]webapp\f[R] +.SS \f[V]blazorserver\f[R] +.PP +\f[B]Discontinued since .NET 8 SDK.\f[R] .IP \[bu] 2 \f[B]\f[VB]-au|--auth \f[B]\f[R] .RS 2 @@ -1523,7 +1783,7 @@ The possible values are: \f[V]IndividualB2C\f[R] - Individual authentication with Azure AD B2C. .IP \[bu] 2 \f[V]SingleOrg\f[R] - Organizational authentication for a single tenant. -Entra External ID tenants also use SingleOrg. +Entra External ID tenants also use \f[V]SingleOrg\f[R]. .IP \[bu] 2 \f[V]MultiOrg\f[R] - Organizational authentication for multiple tenants. .IP \[bu] 2 @@ -1587,155 +1847,36 @@ The default value is \f[V]qualified.domain.name\f[R]. .RS 2 .PP The TenantId ID of the directory to connect to. -Use with \f[V]SingleOrg\f[R] authentication. -The default value is \f[V]22222222-2222-2222-2222-222222222222\f[R]. -.RE -.IP \[bu] 2 -\f[B]\f[VB]--callback-path \f[B]\f[R] -.RS 2 -.PP -The request path within the application\[cq]s base path of the redirect URI. -Use with \f[V]SingleOrg\f[R] or \f[V]IndividualB2C\f[R] authentication. -The default value is \f[V]/signin-oidc\f[R]. -.RE -.IP \[bu] 2 -\f[B]\f[VB]-r|--org-read-access\f[B]\f[R] -.RS 2 -.PP -Allows this application read-access to the directory. -Only applies to \f[V]SingleOrg\f[R] or \f[V]MultiOrg\f[R] authentication. -.RE -.IP \[bu] 2 -\f[B]\f[VB]--exclude-launch-settings\f[B]\f[R] -.RS 2 -.PP -Excludes \f[I]launchSettings.json\f[R] from the generated template. -.RE -.IP \[bu] 2 -\f[B]\f[VB]--no-https\f[B]\f[R] -.RS 2 -.PP -Turns off HTTPS. -This option only applies if \f[V]Individual\f[R], \f[V]IndividualB2C\f[R], \f[V]SingleOrg\f[R], or \f[V]MultiOrg\f[R] aren\[cq]t being used. -.RE -.IP \[bu] 2 -\f[B]\f[VB]-uld|--use-local-db\f[B]\f[R] -.RS 2 -.PP -Specifies LocalDB should be used instead of SQLite. -Only applies to \f[V]Individual\f[R] or \f[V]IndividualB2C\f[R] authentication. -.RE -.IP \[bu] 2 -\f[B]\f[VB]-f|--framework \f[B]\f[R] -.RS 2 -.PP -Specifies the framework to target. -Option available since .NET Core 3.0 SDK. -.PP -The following table lists the default values according to the SDK version number you\[cq]re using: -.PP -.TS -tab(@); -l l. -T{ -SDK version -T}@T{ -Default value -T} -_ -T{ -9.0 -T}@T{ -\f[V]net9.0\f[R] -T} -T{ -8.0 -T}@T{ -\f[V]net8.0\f[R] -T} -T{ -7.0 -T}@T{ -\f[V]net7.0\f[R] -T} -.TE -.PP -To create a project that targets a framework earlier than the SDK that you\[cq]re using, see \f[V]--framework\f[R] for \f[V]console\f[R] projects earlier in this article. -.RE -.IP \[bu] 2 -\f[B]\f[VB]--no-restore\f[B]\f[R] -.RS 2 -.PP -Doesn\[cq]t execute an implicit restore during project creation. -.RE -.IP \[bu] 2 -\f[B]\f[VB]--use-browserlink\f[B]\f[R] -.RS 2 -.PP -Includes BrowserLink in the project. -.RE -.IP \[bu] 2 -\f[B]\f[VB]-rrc|--razor-runtime-compilation\f[B]\f[R] -.RS 2 -.PP -Determines if the project is configured to use Razor runtime compilation in Debug builds. -.RE -.IP \[bu] 2 -\f[B]\f[VB]--kestrelHttpPort\f[B]\f[R] -.RS 2 -.PP -Port number to use for the HTTP endpoint in \f[I]launchSettings.json\f[R]. -.RE -.IP \[bu] 2 -\f[B]\f[VB]--kestrelHttpsPort\f[B]\f[R] -.RS 2 -.PP -Port number to use for the HTTPS endpoint in \f[I]launchSettings.json\f[R]. -This option is not applicable when the parameter \f[V]no-https\f[R] is used (but \f[V]no-https\f[R] is ignored when an individual or organizational authentication setting is chosen for \f[V]--auth\f[R]). -.RE -.IP \[bu] 2 -\f[B]\f[VB]--use-program-main\f[B]\f[R] -.RS 2 -.PP -If specified, an explicit \f[V]Program\f[R] class and \f[V]Main\f[R] method will be used instead of top-level statements. -Available since .NET SDK 6.0.300. -Default value: \f[V]false\f[R]. -.RE -.PP - * * * * * -.SS \f[V]angular\f[R], \f[V]react\f[R] -.PP -\f[B]Discontinued since .NET 8 SDK.\f[R] +Use with \f[V]SingleOrg\f[R] authentication. +The default value is \f[V]22222222-2222-2222-2222-222222222222\f[R]. +.RE .IP \[bu] 2 -\f[B]\f[VB]-au|--auth \f[B]\f[R] +\f[B]\f[VB]--callback-path \f[B]\f[R] .RS 2 .PP -The type of authentication to use. -.PP -The possible values are: -.IP \[bu] 2 -\f[V]None\f[R] - No authentication (Default). -.IP \[bu] 2 -\f[V]Individual\f[R] - Individual authentication. +The request path within the application\[cq]s base path of the redirect URI. +Use with \f[V]SingleOrg\f[R] or \f[V]IndividualB2C\f[R] authentication. +The default value is \f[V]/signin-oidc\f[R]. .RE .IP \[bu] 2 -\f[B]\f[VB]--exclude-launch-settings\f[B]\f[R] +\f[B]\f[VB]-r|--org-read-access\f[B]\f[R] .RS 2 .PP -Excludes \f[I]launchSettings.json\f[R] from the generated template. +Allows this application read-access to the directory. +Only applies to \f[V]SingleOrg\f[R] or \f[V]MultiOrg\f[R] authentication. .RE .IP \[bu] 2 -\f[B]\f[VB]--no-restore\f[B]\f[R] +\f[B]\f[VB]--exclude-launch-settings\f[B]\f[R] .RS 2 .PP -Doesn\[cq]t execute an implicit restore during project creation. +Excludes \f[I]launchSettings.json\f[R] from the generated template. .RE .IP \[bu] 2 \f[B]\f[VB]--no-https\f[B]\f[R] .RS 2 .PP Turns off HTTPS. -This option only applies if authentication is \f[V]None\f[R]. +This option only applies if \f[V]Individual\f[R], \f[V]IndividualB2C\f[R], \f[V]SingleOrg\f[R], or \f[V]MultiOrg\f[R] aren\[cq]t being used for \f[V]--auth\f[R]. .RE .IP \[bu] 2 \f[B]\f[VB]-uld|--use-local-db\f[B]\f[R] @@ -1743,37 +1884,12 @@ This option only applies if authentication is \f[V]None\f[R]. .PP Specifies LocalDB should be used instead of SQLite. Only applies to \f[V]Individual\f[R] or \f[V]IndividualB2C\f[R] authentication. -Available since .NET Core 3.0 SDK. .RE .IP \[bu] 2 -\f[B]\f[VB]-f|--framework \f[B]\f[R] +\f[B]\f[VB]--no-restore\f[B]\f[R] .RS 2 .PP -Specifies the framework to target. -.PP -The following table lists the default values according to the SDK version number you\[cq]re using: -.RS -.PP -There isn\[cq]t a React template for \f[V]net8.0\f[R], however, if you\[cq]re interested in developing React apps with ASP.NET Core, see Overview of Single Page Apps (SPAs) in ASP.NET Core. -.RE -.PP -.TS -tab(@); -l l. -T{ -SDK version -T}@T{ -Default value -T} -_ -T{ -7.0 -T}@T{ -\f[V]net7.0\f[R] -T} -.TE -.PP -To create a project that targets a framework earlier than the SDK that you\[cq]re using, see \f[V]--framework\f[R] for \f[V]console\f[R] projects earlier in this article. +Doesn\[cq]t execute an implicit restore during project creation. .RE .IP \[bu] 2 \f[B]\f[VB]--kestrelHttpPort\f[B]\f[R] @@ -1798,31 +1914,7 @@ Default value: \f[V]false\f[R]. .RE .PP * * * * * -.SS \f[V]razorclasslib\f[R] -.IP \[bu] 2 -\f[B]\f[VB]--no-restore\f[B]\f[R] -.RS 2 -.PP -Doesn\[cq]t execute an implicit restore during project creation. -.RE -.IP \[bu] 2 -\f[B]\f[VB]-s|--support-pages-and-views\f[B]\f[R] -.RS 2 -.PP -Supports adding traditional Razor pages and Views in addition to components to this library. -.RE -.PP - * * * * * -.SS \f[V]webapiaot\f[R] -.PP -Creates a web API project with AOT publish enabled. -For more information, see Native AOT deployment and The Web API (Native AOT) template. -.IP \[bu] 2 -\f[B]\f[VB]--exclude-launch-settings\f[B]\f[R] -.RS 2 -.PP -Excludes \f[I]launchSettings.json\f[R] from the generated template. -.RE +.SS \f[V]blazorwasm\f[R] .IP \[bu] 2 \f[B]\f[VB]-f|--framework \f[B]\f[R] .RS 2 @@ -1850,7 +1942,14 @@ T{ T}@T{ \f[V]net8.0\f[R] T} +T{ +7.0 +T}@T{ +\f[V]net7.0\f[R] +T} .TE +.PP +To create a project that targets a framework earlier than the SDK that you\[cq]re using, see \f[V]--framework\f[R] for \f[V]console\f[R] projects earlier in this article. .RE .IP \[bu] 2 \f[B]\f[VB]--no-restore\f[B]\f[R] @@ -1859,16 +1958,11 @@ T} Doesn\[cq]t execute an implicit restore during project creation. .RE .IP \[bu] 2 -\f[B]\f[VB]--use-program-main\f[B]\f[R] +\f[B]\f[VB]-ho|--hosted\f[B]\f[R] .RS 2 .PP -If specified, an explicit \f[V]Program\f[R] class and \f[V]Main\f[R] method will be used instead of top-level statements. -Available since .NET SDK 6.0.300. -Default value: \f[V]false\f[R]. +Includes an ASP.NET Core host for the Blazor WebAssembly app. .RE -.PP - * * * * * -.SS \f[V]webapi\f[R] .IP \[bu] 2 \f[B]\f[VB]-au|--auth \f[B]\f[R] .RS 2 @@ -1878,28 +1972,28 @@ The possible values are: .IP \[bu] 2 \f[V]None\f[R] - No authentication (Default). .IP \[bu] 2 +\f[V]Individual\f[R] - Individual authentication. +.IP \[bu] 2 \f[V]IndividualB2C\f[R] - Individual authentication with Azure AD B2C. .IP \[bu] 2 \f[V]SingleOrg\f[R] - Organizational authentication for a single tenant. Entra External ID tenants also use SingleOrg. -.IP \[bu] 2 -\f[V]Windows\f[R] - Windows authentication. .RE .IP \[bu] 2 -\f[B]\f[VB]--aad-b2c-instance \f[B]\f[R] +\f[B]\f[VB]--authority \f[B]\f[R] .RS 2 .PP -The Azure Active Directory B2C instance to connect to. -Use with \f[V]IndividualB2C\f[R] authentication. -The default value is \f[V]https://login.microsoftonline.com/tfp/\f[R]. +The authority of the OIDC provider. +Use with \f[V]Individual\f[R] authentication. +The default value is \f[V]https://login.microsoftonline.com/\f[R]. .RE .IP \[bu] 2 -\f[B]\f[VB]-minimal|--use-minimal-apis\f[B]\f[R] +\f[B]\f[VB]--aad-b2c-instance \f[B]\f[R] .RS 2 .PP -Create a project that uses the ASP.NET Core minimal API. -Default is \f[V]false\f[R], but this option is overridden by \f[V]-controllers\f[R]. -Since the default for \f[V]-controllers\f[R] is \f[V]false\f[R], entering \f[V]dotnet new webapi\f[R] without specifying either option creates a minimal API project. +The Azure Active Directory B2C instance to connect to. +Use with \f[V]IndividualB2C\f[R] authentication. +The default value is \f[V]https://aadB2CInstance.b2clogin.com/\f[R]. .RE .IP \[bu] 2 \f[B]\f[VB]-ssp|--susi-policy-id \f[B]\f[R] @@ -1921,25 +2015,40 @@ The default value is \f[V]https://login.microsoftonline.com/\f[R]. .RS 2 .PP The Client ID for this project. -Use with \f[V]IndividualB2C\f[R] or \f[V]SingleOrg\f[R] authentication. -The default value is \f[V]11111111-1111-1111-11111111111111111\f[R]. +Use with \f[V]IndividualB2C\f[R], \f[V]SingleOrg\f[R], or \f[V]Individual\f[R] authentication in standalone scenarios. +The default value is \f[V]33333333-3333-3333-33333333333333333\f[R]. .RE .IP \[bu] 2 -\f[B]\f[VB]-controllers|--use-controllers\f[B]\f[R] +\f[B]\f[VB]--domain \f[B]\f[R] .RS 2 .PP -Whether to use controllers instead of minimal APIs. -If both this option and \f[V]-minimal\f[R] are specified, this option overrides the value specified by \f[V]-minimal\f[R]. -Default is \f[V]false\f[R]. -Available since .NET 8 SDK. +The domain for the directory tenant. +Use with \f[V]SingleOrg\f[R] or \f[V]IndividualB2C\f[R] authentication. +The default value is \f[V]qualified.domain.name\f[R]. .RE .IP \[bu] 2 -\f[B]\f[VB]--domain \f[B]\f[R] +\f[B]\f[VB]--app-id-uri \f[B]\f[R] .RS 2 .PP -The domain for the directory tenant. -Use with \f[V]IndividualB2C\f[R] or \f[V]SingleOrg\f[R] authentication. -The default value is \f[V]qualified.domain.name\f[R]. +The App ID Uri for the server API you want to call. +Use with \f[V]SingleOrg\f[R] or \f[V]IndividualB2C\f[R] authentication. +The default value is \f[V]api.id.uri\f[R]. +.RE +.IP \[bu] 2 +\f[B]\f[VB]--api-client-id \f[B]\f[R] +.RS 2 +.PP +The Client ID for the API that the server hosts. +Use with \f[V]SingleOrg\f[R] or \f[V]IndividualB2C\f[R] authentication. +The default value is \f[V]11111111-1111-1111-11111111111111111\f[R]. +.RE +.IP \[bu] 2 +\f[B]\f[VB]-s|--default-scope \f[B]\f[R] +.RS 2 +.PP +The API scope the client needs to request to provision an access token. +Use with \f[V]SingleOrg\f[R] or \f[V]IndividualB2C\f[R] authentication. +The default value is \f[V]user_impersonation\f[R]. .RE .IP \[bu] 2 \f[B]\f[VB]--tenant-id \f[B]\f[R] @@ -1963,123 +2072,71 @@ Only applies to \f[V]SingleOrg\f[R] authentication. Excludes \f[I]launchSettings.json\f[R] from the generated template. .RE .IP \[bu] 2 -\f[B]\f[VB]--no-openapi\f[B]\f[R] +\f[B]\f[VB]-p|--pwa\f[B]\f[R] .RS 2 .PP -Turns off OpenAPI (Swagger) support. -\f[V]AddOpenApi\f[R] and \f[V]MapOpenApi\f[R] aren\[cq]t called. +produces a Progressive Web Application (PWA) supporting installation and offline use. .RE .IP \[bu] 2 \f[B]\f[VB]--no-https\f[B]\f[R] .RS 2 .PP Turns off HTTPS. -No \f[I]https\f[R] launch profile is created in \f[V]launchSettings.json\f[R]. -\f[V]app.UseHsts\f[R] and \f[V]app.UseHttpsRedirection\f[R] aren\[cq]t called in \f[I]Program.cs\f[R]/\f[I]Startup.cs\f[R]. -This option only applies if \f[V]IndividualB2C\f[R] or \f[V]SingleOrg\f[R] aren\[cq]t being used for authentication. +This option only applies if \f[V]Individual\f[R], \f[V]IndividualB2C\f[R], or \f[V]SingleOrg\f[R] aren\[cq]t being used for \f[V]--auth\f[R]. .RE .IP \[bu] 2 \f[B]\f[VB]-uld|--use-local-db\f[B]\f[R] .RS 2 .PP Specifies LocalDB should be used instead of SQLite. -Only applies to \f[V]IndividualB2C\f[R] authentication. -.RE -.IP \[bu] 2 -\f[B]\f[VB]-f|--framework \f[B]\f[R] -.RS 2 -.PP -Specifies the framework to target. -Option not available in .NET Core 2.2 SDK. -.PP -The following table lists the default values according to the SDK version number you\[cq]re using: -.PP -.TS -tab(@); -l l. -T{ -SDK version -T}@T{ -Default value -T} -_ -T{ -9.0 -T}@T{ -\f[V]net9.0\f[R] -T} -T{ -8.0 -T}@T{ -\f[V]net8.0\f[R] -T} -T{ -7.0 -T}@T{ -\f[V]net7.0\f[R] -T} -.TE -.PP -To create a project that targets a framework earlier than the SDK that you\[cq]re using, see \f[V]--framework\f[R] for \f[V]console\f[R] projects earlier in this article. +Only applies to \f[V]Individual\f[R] or \f[V]IndividualB2C\f[R] authentication. .RE .IP \[bu] 2 -\f[B]\f[VB]--no-restore\f[B]\f[R] +\f[B]\f[VB]--called-api-url \f[B]\f[R] .RS 2 .PP -Doesn\[cq]t execute an implicit restore during project creation. +URL of the API to call from the web app. +Only applies to \f[V]SingleOrg\f[R] or \f[V]IndividualB2C\f[R] authentication without an ASP.NET Core host specified. +The default value is \f[V]https://graph.microsoft.com/v1.0/me\f[R]. .RE .IP \[bu] 2 -\f[B]\f[VB]--use-program-main\f[B]\f[R] +\f[B]\f[VB]--calls-graph\f[B]\f[R] .RS 2 .PP -If specified, an explicit \f[V]Program\f[R] class and \f[V]Main\f[R] method will be used instead of top-level statements. -Available since .NET SDK 6.0.300. -Default value: \f[V]false\f[R]. +Specifies if the web app calls Microsoft Graph. +Only applies to \f[V]SingleOrg\f[R] authentication. .RE -.PP - * * * * * -.SS \f[V]apicontroller\f[R] -.PP -API Controller with or without read/write actions. .IP \[bu] 2 -\f[B]\f[VB]-p:n|--name \f[B]\f[R] +\f[B]\f[VB]--called-api-scopes \f[B]\f[R] .RS 2 .PP -The namespace for the generated code. -Default is \f[V]MyApp.Namespace\f[R]. +Scopes to request to call the API from the web app. +Only applies to \f[V]SingleOrg\f[R] or \f[V]IndividualB2C\f[R] authentication without an ASP.NET Core host specified. +The default is \f[V]user.read\f[R]. .RE .IP \[bu] 2 -\f[B]\f[VB]-ac|--actions\f[B]\f[R] +\f[B]\f[VB]--kestrelHttpPort\f[B]\f[R] .RS 2 .PP -Create a controller with read/write actions. -Default is \f[V]false\f[R]. +Port number to use for the HTTP endpoint in \f[I]launchSettings.json\f[R]. .RE -.PP - * * * * * -.SS \f[V]globaljson\f[R] .IP \[bu] 2 -\f[B]\f[VB]--sdk-version \f[B]\f[R] +\f[B]\f[VB]--kestrelHttpsPort\f[B]\f[R] .RS 2 .PP -Specifies the version of the .NET SDK to use in the \f[I]global.json\f[R] file. +Port number to use for the HTTPS endpoint in \f[I]launchSettings.json\f[R]. +This option is not applicable when the parameter \f[V]no-https\f[R] is used (but \f[V]no-https\f[R] is ignored when an individual or organizational authentication setting is chosen for \f[V]--auth\f[R]). .RE .IP \[bu] 2 -\f[B]\f[VB]--roll-forward \f[B]\f[R] +\f[B]\f[VB]--use-program-main\f[B]\f[R] .RS 2 .PP -The roll-forward policy to use when selecting an SDK version, either as a fallback when a specific SDK version is missing or as a directive to use a later version. -For more information, see global-json. +If specified, an explicit \f[V]Program\f[R] class and \f[V]Main\f[R] method will be used instead of top-level statements. +Available since .NET SDK 6.0.300. +Default value: \f[V]false\f[R]. .RE -.SS \f[V]editorconfig\f[R] .PP -Creates an \f[I].editorconfig\f[R] file for configuring code style preferences. -.IP \[bu] 2 -\f[B]\f[VB]--empty\f[B]\f[R] -.RS 2 -.PP -Creates an empty \f[I].editorconfig\f[R] instead of the defaults for .NET. -.RE + * * * * * .SH SEE ALSO .IP \[bu] 2 dotnet new command diff --git a/documentation/manpages/sdk/dotnet-new.1 b/documentation/manpages/sdk/dotnet-new.1 index 0075c0cfe82e..3ba477b121aa 100644 --- a/documentation/manpages/sdk/dotnet-new.1 +++ b/documentation/manpages/sdk/dotnet-new.1 @@ -1,4 +1,3 @@ -'\" t .\" Automatically generated by Pandoc 2.18 .\" .\" Define V font for inline verbatim, using C font in formats @@ -15,7 +14,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "dotnet-new" "1" "2025-06-13" "" ".NET Documentation" +.TH "dotnet-new" "1" "2025-09-15" "" ".NET Documentation" .hy .SH dotnet new