.NET-Standardvorlagen für dotnet new

Wenn Sie das .NET SDK installieren, erhalten Sie mehr als zwölf integrierte Vorlagen zum Erstellen von Projekten und Dateien, einschließlich Konsolenanwendungen, Klassenbibliotheken, Komponententestprojekten, ASP.NET Core-Apps (einschließlich Angular- und React-Projekten) und Konfigurationsdateien. Um die integrierten Vorlagen aufzulisten, führen Sie den Befehl dotnet new list aus:

dotnet new list

Die folgende Tabelle zeigt die Vorlagen, die im Lieferumfang des .NET SDK enthalten sind. Die Standardsprache für die Vorlage wird in den Klammern angezeigt. Klicken Sie auf den Kurznamenlink, um die spezifischen Vorlagenoptionen einzusehen.

Vorlagen	Kurzname	Sprache	Tags	Eingeführt
Konsolenanwendung	console	[C#], F#, VB	Common/Console	1.0
Klassenbibliothek	classlib	[C#], F#, VB	Common/Library	1.0
WPF-Anwendung	wpf	[C#], VB	Common/WPF	3.0 (5.0 für VB)
WPF-Klassenbibliothek	wpflib	[C#], VB	Common/WPF	3.0 (5.0 für VB)
WPF-Benutzerdefinierte Steuerelementbibliothek	wpfcustomcontrollib	[C#], VB	Common/WPF	3.0 (5.0 für VB)
Bibliothek mit WPF-Benutzersteuerelementen	wpfusercontrollib	[C#], VB	Common/WPF	3.0 (5.0 für VB)
Windows Forms-Anwendung (WinForms)	winforms	[C#], VB	Common/WinForms	3.0 (5.0 für VB)
Windows Forms-Klassenbibliothek (WinForms)	winformslib	[C#], VB	Common/WinForms	3.0 (5.0 für VB)
Workerdienst	worker	[C#]	Common/Worker/Web	3.0
Komponententestprojekt	mstest	[C#], F#, VB	Test/MSTest	1.0
NUnit 3-Testprojekt	nunit	[C#], F#, VB	Test/NUnit	2.1.400
NUnit 3-Testelement	nunit-test	[C#], F#, VB	Test/NUnit	2.2
xUnit-Testprojekt	xunit	[C#], F#, VB	Test/xUnit	1.0
Razor-Komponente	razorcomponent	[C#]	Web/ASP.NET	3.0
Seite „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-Web-App	blazor	[C#]	Web/Blazor	8.0.100
BlazorWebAssembly Eigenständige App	blazorwasm	[C#]	Web/Blazor//WebAssembly/PWA	3.1.300
ASP.NET Core leer	web	[C#], F#	Web/Empty	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#]	Web/MVC/Razor Pages	2.2, 2.0
Razor-Klassenbibliothek	razorclasslib	[C#]	Web/Razor/Library/Razor Class Library	2.1
ASP.NET Core-Web-API	webapi	[C#], F#	Web/Web-API/API/Dienst/WebAPI	1.0
ASP.NET Core-API	webapiaot	[C#]	Web/Web-API/API/Dienst	8.0
ASP.NET Core-API-Controller	apicontroller	[C#]	Web/ASP.NET	8.0
ASP.NET Core: gRPC-Dienst	grpc	[C#]	Web/gRPC	3.0
dotnet: GITIGNORE-Datei	gitignore		Konfigurationen	3.0
global.json-Datei	globaljson		Konfigurationen	2.0
NuGet-Konfiguration	nugetconfig		Konfigurationen	1.0
Dotnet: Manifestdatei des lokalen Tools	tool-manifest		Konfigurationen	3.0
Web Config	webconfig		Konfigurationen	1.0
Projektmappendatei	sln		Lösung	1.0
Protokollpufferdatei	proto		Web/gRPC	3.0
EditorConfig-Datei	editorconfig(.. /docs/core/tools/dotnet-new-sdk-templates.md#editorconfig)		Config	6.0

Die folgende Tabelle enthält Vorlagen, die nicht mehr vorhanden sind und nicht mehr mit dem .NET SDK vorinstalliert sind. Klicken Sie auf den Kurznamenlink, um die spezifischen Vorlagenoptionen einzusehen.

Vorlagen	Kurzname	Sprache	Tags	Nicht mehr vorhanden seit
ASP.NET Core mit Angular	angular	[C#]	Web/MVC/SPA	8.0
ASP.NET Core mit React.js	react	[C#]	Web/MVC/SPA	8.0
Blazor Server-App	blazorserver	[C#]	Web/Blazor	8.0
Leere Blazor-Server-App	blazorserver-empty	[C#]	Web/Blazor	8.0
Leere BlazorWebAssembly-App	blazorwasm-empty	[C#]	Web/Blazor/WebAssembly	8.0

Vorlagenoptionen

Für jede Vorlage kann es zusätzliche Optionen geben. Um die zusätzlichen Optionen anzuzeigen, die für die Vorlage verfügbar sind, verwenden Sie die --help-Option mit dem Vorlagennamenargument, z. B.: dotnet new console --help. Falls die Vorlage mehrere Sprachen unterstützt, zeigt dieser Befehl Hilfe für die Vorlage in der Standardsprache an. Wenn Sie sie mit der --language-Option kombinieren, können Sie die Hilfe für andere Sprachen anzeigen: dotnet new console --help --language F#. Die Vorlagen, die im Lieferumfang des .NET SDK enthalten sind, verfügen über die folgenden zusätzlichen Optionen:

console

• -f|--framework <FRAMEWORK>

  Gibt das Zielframework an. Verfügbar seit .NET Core 3.0 SDK.

  In der folgenden Tabelle sind die Standardwerte entsprechend der von Ihnen verwendeten SDK-Version aufgeführt:

  SDK-Version	Standardwert
  8.0	net8.0
  7.0	net7.0
  6.0	net6.0
  3.1	netcoreapp3.1

  Ob Sie ein Projekt für eine frühere TFM-Version erstellen können, hängt davon ab, ob diese Version des SDK installiert ist. Wenn Sie beispielsweise nur das .NET 7 SDK installiert haben, ist für --framework nur der Wert net7.0 verfügbar. Wenn Sie das .NET 6 SDK installieren, wird der Wert net6.0 für --framework verfügbar. Wenn Sie das .NET Core 3.1 SDK installieren, wird netcoreapp3.1 verfügbar usw. Wenn Sie also --framework netcoreapp3.1 angeben, können Sie .NET Core 3.1 sogar während der Ausführung von dotnet new im .NET 6 SDK als Ziel verwenden.

  Wenn Sie alternativ ein Projekt für ein früheres Framework als das des verwendeten SDK erstellen möchten, können Sie das entsprechende NuGet-Paket für die Vorlage installieren. Die Projekttypen Common, Web und SPA verwenden je nach Zielframeworkmoniker unterschiedliche Pakete. Wenn Sie beispielsweise ein console-Projekt für netcoreapp1.0 erstellen möchten, müssen Sie dotnet new install unter Microsoft.DotNet.Common.ProjectTemplates.1.x ausführen.

• --langVersion <VERSION_NUMBER>

  Legt in der erstellten Projektdatei die LangVersion-Eigenschaft fest. Verwenden Sie beispielsweise --langVersion 7.3 für C# 7.3. Wird für F# nicht unterstützt. Verfügbar ab .NET Core 2.2 SDK.

  Eine Liste der C#-Standardversionen finden Sie unter Defaults.

• --no-restore

  Falls angegeben, erfolgt während der Projekterstellung keine implizite Wiederherstellung. Verfügbar ab .NET Core 2.2 SDK.

• --use-program-main

  Wenn angegeben, werden eine explizite Program-Klasse und Main-Methode anstelle von Anweisungen der obersten Ebene verwendet. Verfügbar seit .NET SDK 6.0.300. Standardwert. false. Nur für C# verfügbar.

---

classlib

• -f|--framework <FRAMEWORK>

  Gibt das Zielframework an. Werte: net8.0, net7.0, net6.0 oder netcoreapp3.1, um eine .NET-Klassenbibliothek zu erstellen, oder netstandard2.1 oder netstandard2.0, um eine .NET Standard-Klassenbibliothek zu erstellen. Der Standardwert für das .NET SDK 8.0.x ist net8.0.

  Weitere Informationen zum Erstellen eines Projekts für ein früheres Framework als das des verwendeten SDK finden Sie in diesem Artikel unter --framework für console-Projekte.

• --langVersion <VERSION_NUMBER>

  Legt in der erstellten Projektdatei die LangVersion-Eigenschaft fest. Verwenden Sie beispielsweise --langVersion 7.3 für C# 7.3. Wird für F# nicht unterstützt. Verfügbar ab .NET Core 2.2 SDK.

  Eine Liste der C#-Standardversionen finden Sie unter Defaults.

• --no-restore

  Führt während der Projekterstellung keine implizite Wiederherstellung durch.

---

wpf, , wpflibwpfcustomcontrollibwpfusercontrollib

• -f|--framework <FRAMEWORK>

  Gibt das Zielframework an. Für das .NET 8 SDK ist der Standardwert net8.0. Verfügbar seit .NET Core 3.1 SDK.

• --langVersion <VERSION_NUMBER>

  Legt in der erstellten Projektdatei die LangVersion-Eigenschaft fest. Verwenden Sie beispielsweise --langVersion 7.3 für C# 7.3.

  Eine Liste der C#-Standardversionen finden Sie unter Defaults.

• --no-restore

  Führt während der Projekterstellung keine implizite Wiederherstellung durch.

---

winforms, winformslib

• --langVersion <VERSION_NUMBER>

  Legt in der erstellten Projektdatei die LangVersion-Eigenschaft fest. Verwenden Sie beispielsweise --langVersion 7.3 für C# 7.3.

  Eine Liste der C#-Standardversionen finden Sie unter Defaults.

• --no-restore

  Führt während der Projekterstellung keine implizite Wiederherstellung durch.

---

worker, grpc

• -f|--framework <FRAMEWORK>

  Gibt das Zielframework an. Der Standardwert für das .NET 8 SDK ist net8.0. Verfügbar seit .NET Core 3.1 SDK.

  Weitere Informationen zum Erstellen eines Projekts für ein früheres Framework als das des verwendeten SDK finden Sie in diesem Artikel unter --framework für console-Projekte.

• --exclude-launch-settings

  Schließt launchSettings.json aus der generierten Vorlage aus.

• --no-restore

  Führt während der Projekterstellung keine implizite Wiederherstellung durch.

• --use-program-main

  Wenn angegeben, werden eine explizite Program-Klasse und Main-Methode anstelle von Anweisungen der obersten Ebene verwendet. Verfügbar seit .NET SDK 6.0.300. Standardwert. false.

---

mstest, xunit

• -f|--framework <FRAMEWORK>

  Gibt das Zielframework an. Die Option ist ab .NET Core 3.0 SDK verfügbar.

  In der folgenden Tabelle sind die Standardwerte entsprechend der von Ihnen verwendeten SDK-Versionsnummer aufgeführt:

  SDK-Version	Standardwert
  8.0	net8.0
  7.0	net7.0
  6.0	net6.0
  5.0	net5.0
  3.1	netcoreapp3.1

Ob Sie ein Projekt für eine frühere TFM-Version erstellen können, hängt davon ab, ob diese Version des SDK installiert ist. Wenn Sie beispielsweise nur das .NET 6 SDK installiert haben, ist für --framework nur der Wert net6.0 verfügbar. Wenn Sie das .NET 5 SDK installieren, wird der Wert net5.0 für --framework verfügbar. Wenn Sie das .NET Core 3.1 SDK installieren, wird netcoreapp3.1 verfügbar usw. Wenn Sie also --framework netcoreapp3.1 angeben, können Sie .NET Core 3.1 sogar während der Ausführung von dotnet new im .NET 6 SDK als Ziel verwenden.

• -p|--enable-pack

  Ermöglicht das Packen des Projekts mit dotnet pack.

• --no-restore

  Führt während der Projekterstellung keine implizite Wiederherstellung durch.

---

nunit

• -f|--framework <FRAMEWORK>

  Gibt das Zielframework an.

  In der folgenden Tabelle sind die Standardwerte entsprechend der von Ihnen verwendeten SDK-Versionsnummer aufgeführt:

  SDK-Version	Standardwert
  8.0	net8.0
  7.0	net7.0
  6.0	net6.0
  5.0	net5.0
  3.1	netcoreapp3.1

Ob Sie ein Projekt für eine frühere TFM-Version erstellen können, hängt davon ab, ob diese Version des SDK installiert ist. Wenn Sie beispielsweise nur das .NET 6 SDK installiert haben, ist für --framework nur der Wert net6.0 verfügbar. Wenn Sie das .NET 5 SDK installieren, wird der Wert net5.0 für --framework verfügbar. Wenn Sie das .NET Core 3.1 SDK installieren, wird netcoreapp3.1 verfügbar usw. Wenn Sie also --framework netcoreapp3.1 angeben, können Sie .NET Core 3.1 sogar während der Ausführung von dotnet new im .NET 6 SDK als Ziel verwenden.

• -p|--enable-pack

  Ermöglicht das Packen des Projekts mit dotnet pack.

• --no-restore

  Führt während der Projekterstellung keine implizite Wiederherstellung durch.

---

page

• -na|--namespace <NAMESPACE_NAME>

  Namespace für den generierten Code. Der Standardwert ist MyApp.Namespace.

• -np|--no-pagemodel

  Erstellt die Seite ohne PageModel.

---

viewimports, proto

• -na|--namespace <NAMESPACE_NAME>

  Namespace für den generierten Code. Der Standardwert ist MyApp.Namespace.

---

blazorserver

Seit .NET 8 SDK nicht mehr vorhanden.

• -au|--auth <AUTHENTICATION_TYPE>

  Der zu verwendende Authentifizierungstyp. Mögliche Werte sind:

  • None: keine Authentifizierung (Standard)
  • Individual: einzelne Authentifizierung
  • IndividualB2C: einzelne Authentifizierung mit Azur AD B2C
  • SingleOrg: Organisationauthentifizierung für einzelne Mandanten Externe ENTra-ID-Mandanten verwenden auch SingleOrgSingleOrg.
  • MultiOrg: Organisationauthentifizierung für mehrere Mandanten
  • Windows: Windows-Authentifizierung

• --aad-b2c-instance <INSTANCE>

  Die Azure Active Directory B2C-Instanz, mit der eine Verbindung hergestellt werden soll. Mit der IndividualB2C-Authentifizierung verwenden Der Standardwert ist https://login.microsoftonline.com/tfp/.

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

  Die ID der Anmelde- und Registrierungsrichtlinie für dieses Projekt. Mit der IndividualB2C-Authentifizierung verwenden

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

  Die Richtlinien-ID zum Zurücksetzen des Kennworts für dieses Projekt. Mit der IndividualB2C-Authentifizierung verwenden

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

  Die Richtlinien-ID zum Bearbeiten des Profils für dieses Projekt. Mit der IndividualB2C-Authentifizierung verwenden

• --aad-instance <INSTANCE>

  Die Azure Active Directory-Instanz, mit der eine Verbindung hergestellt werden soll. Mit der SingleOrg- oder MultiOrg-Authentifizierung verwenden Der Standardwert ist https://login.microsoftonline.com/.

• --client-id <ID>

  Die Client-ID für dieses Projekt. Mit der IndividualB2C-, SingleOrg-oder MultiOrg-Authentifizierung verwenden Der Standardwert ist 11111111-1111-1111-11111111111111111.

• --domain <DOMAIN>

  Die Domäne für den Verzeichnismandanten. Mit der SingleOrg- oder IndividualB2C-Authentifizierung verwenden Der Standardwert ist qualified.domain.name.

• --tenant-id <ID>

  Die Mandanten-ID des Verzeichnisses, mit dem eine Verbindung hergestellt werden soll. Mit der SingleOrg-Authentifizierung verwenden Der Standardwert ist 22222222-2222-2222-2222-222222222222.

• --callback-path <PATH>

  Der Anforderungspfad innerhalb des Basispfads des Umleitungs-URIs der Anwendung. Mit der SingleOrg- oder IndividualB2C-Authentifizierung verwenden Der Standardwert ist /signin-oidc.

• -r|--org-read-access

  Erteilt der Anwendung Lesezugriff auf das Verzeichnis. Gilt nur für die SingleOrg- oder MultiOrg-Authentifizierung.

• --exclude-launch-settings

  Schließt launchSettings.json aus der generierten Vorlage aus.

• --no-https

  Deaktiviert HTTPS. Diese Option gilt nur, wenn Individual, IndividualB2C, SingleOrg oder MultiOrg nicht für --auth verwendet werden.

• -uld|--use-local-db

  Gibt an, dass LocalDB statt SQLite verwendet werden soll. Gilt nur für die Individual- oder IndividualB2C-Authentifizierung.

• --no-restore

  Führt während der Projekterstellung keine implizite Wiederherstellung durch.

• --kestrelHttpPort

  Portnummer, die für den HTTP-Endpunkt in launchSettings.json verwendet werden soll.

• --kestrelHttpsPort

  Portnummer, die für den HTTPS-Endpunkt in launchSettings.json verwendet werden soll. Diese Option gilt nicht, wenn der Parameter no-https verwendet wird (no-https wird jedoch ignoriert, wenn eine einzelne oder eine Organisationseinstellung für die Authentifizierung für --auth ausgewählt ist).

• --use-program-main

  Wenn angegeben, werden eine explizite Program-Klasse und Main-Methode anstelle von Anweisungen der obersten Ebene verwendet. Verfügbar seit .NET SDK 6.0.300. Standardwert. false.

---

blazor

• -f|--framework <FRAMEWORK>

  Gibt das Zielframework an.

  Diese Vorlage ist für .NET 8 oder höher verfügbar.

• --no-restore

  Führt während der Projekterstellung keine implizite Wiederherstellung durch.

• --exclude-launch-settings

  Schließt launchSettings.json aus der generierten Anwendung aus.

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

  Gibt an, welcher interaktive Rendermodus für interaktive Komponenten verwendet werden soll. Mögliche Werte sind:

  • None - Keine Interaktivität (nur statisches serverseitiges Rendering).
  • Server - (Standard) Führt die Anwendung auf dem Server mit interaktivem serverseitigem Rendering aus.
  • WebAssembly - Führt die Anwendung mit clientseitigem Rendering im Browser mit WebAssembly aus.
  • Auto - Verwendet interaktives serverseitiges Rendering beim Herunterladen des Blazor-Bundles und Aktivieren der Blazor-Laufzeit auf dem Client und verwendet dann das clientseitige Rendering mit WebAssembly.

• --empty

  Lässt Beispielseiten und Formatierungen weg, die grundlegende Verwendungsmuster veranschaulichen.

• -au|--auth <AUTHENTICATION_TYPE>

  Der zu verwendende Authentifizierungstyp. Mögliche Werte sind:

  • None: keine Authentifizierung (Standard)
  • Individual: einzelne Authentifizierung

• -uld|--use-local-db

  Gibt an, dass LocalDB statt SQLite verwendet werden soll. Gilt nur für die Individual-Authentifizierung.

• -ai|--all-interactive

  Macht jede Seite interaktiv, indem sie einen interaktiven Rendermodus auf oberster Ebene anwendet. Wenn false, verwenden Seiten standardmäßig statisches serverseitiges Rendering und können pro Seite oder pro Komponente als interaktiv gekennzeichnet werden. Diese Option ist nur wirksam, wenn die -i|--interactivity-Option nicht auf None gesetzt ist.

• --no-https

  Deaktiviert HTTPS. Diese Option gilt nur, wenn Individual nicht für die -au|--auth-Option ausgewählt ist.

• --use-program-main

  Wenn angegeben, werden eine explizite Program-Klasse und Main-Methode anstelle von Anweisungen der obersten Ebene generiert.

---

blazorwasm

• -f|--framework <FRAMEWORK>

  Gibt das Zielframework an.

  In der folgenden Tabelle sind die Standardwerte entsprechend der von Ihnen verwendeten SDK-Versionsnummer aufgeführt:

  SDK-Version	Standardwert
  8.0	net8.0
  7.0	net7.0
  6.0	net6.0
  5.0	net5.0
  3.1	netcoreapp3.1

  Weitere Informationen zum Erstellen eines Projekts für ein früheres Framework als das des verwendeten SDK finden Sie in diesem Artikel unter --framework für console-Projekte.

• --no-restore

  Führt während der Projekterstellung keine implizite Wiederherstellung durch.

• -ho|--hosted

  Enthält einen ASP.NET Core-Host für die BlazorWebAssembly-App.

• -au|--auth <AUTHENTICATION_TYPE>

  Der zu verwendende Authentifizierungstyp. Mögliche Werte sind:

  • None: keine Authentifizierung (Standard)
  • Individual: einzelne Authentifizierung
  • IndividualB2C: einzelne Authentifizierung mit Azur AD B2C
  • SingleOrg: Organisationauthentifizierung für einzelne Mandanten Externe ENTra-ID-Mandanten verwenden auch SingleOrg.

• --authority <AUTHORITY>

  Die Autorität des OIDC-Anbieters. Mit der Individual-Authentifizierung verwenden Der Standardwert ist https://login.microsoftonline.com/.

• --aad-b2c-instance <INSTANCE>

  Die Azure Active Directory B2C-Instanz, mit der eine Verbindung hergestellt werden soll. Mit der IndividualB2C-Authentifizierung verwenden Der Standardwert ist https://aadB2CInstance.b2clogin.com/.

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

  Die ID der Anmelde- und Registrierungsrichtlinie für dieses Projekt. Mit der IndividualB2C-Authentifizierung verwenden

• --aad-instance <INSTANCE>

  Die Azure Active Directory-Instanz, mit der eine Verbindung hergestellt werden soll. Mit der SingleOrg-Authentifizierung verwenden Der Standardwert ist https://login.microsoftonline.com/.

• --client-id <ID>

  Die Client-ID für dieses Projekt. Wird in eigenständigen Szenarien mit der Authentifizierung IndividualB2C, SingleOrg oder Individual verwendet. Der Standardwert ist 33333333-3333-3333-33333333333333333.

• --domain <DOMAIN>

  Die Domäne für den Verzeichnismandanten. Mit der SingleOrg- oder IndividualB2C-Authentifizierung verwenden Der Standardwert ist qualified.domain.name.

• --app-id-uri <URI>

  Der APP-ID-URI für die Server-API, die aufgerufen werden soll. Mit der SingleOrg- oder IndividualB2C-Authentifizierung verwenden Der Standardwert ist api.id.uri.

• --api-client-id <ID>

  Die Client-ID für die API, die vom Server gehostet wird. Mit der SingleOrg- oder IndividualB2C-Authentifizierung verwenden Der Standardwert ist 11111111-1111-1111-11111111111111111.

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

  Der API-Bereich, der vom Client angefordert werden muss, um ein Zugriffstoken bereitzustellen. Mit der SingleOrg- oder IndividualB2C-Authentifizierung verwenden Der Standardwert ist user_impersonation.

• --tenant-id <ID>

  Die Mandanten-ID des Verzeichnisses, mit dem eine Verbindung hergestellt werden soll. Mit der SingleOrg-Authentifizierung verwenden Der Standardwert ist 22222222-2222-2222-2222-222222222222.

• -r|--org-read-access

  Erteilt der Anwendung Lesezugriff auf das Verzeichnis. Gilt nur für die SingleOrg-Authentifizierung.

• --exclude-launch-settings

  Schließt launchSettings.json aus der generierten Vorlage aus.

• -p|--pwa

  Erzeugt eine progressive Webanwendung (PWA), die Installation und Offlinenutzung unterstützt.

• --no-https

  Deaktiviert HTTPS. Diese Option gilt nur, wenn Individual, IndividualB2C oder SingleOrg für --auth nicht verwendet werden.

• -uld|--use-local-db

  Gibt an, dass LocalDB statt SQLite verwendet werden soll. Gilt nur für die Individual- oder IndividualB2C-Authentifizierung.

• --called-api-url <URL>

  URL der API, die von der Web-App aufgerufen werden soll. Gilt nur für die Authentifizierung SingleOrg oder IndividualB2C ohne Angabe eines ASP.NET Core-Hosts. Standardwert: https://graph.microsoft.com/v1.0/me.

• --calls-graph

  Gibt an, ob die Web-App Microsoft Graph aufruft. Gilt nur für die SingleOrg-Authentifizierung.

• --called-api-scopes <SCOPES>

  Bereiche, die angefordert werden müssen, um die API aus der Web-App aufzurufen. Gilt nur für die Authentifizierung SingleOrg oder IndividualB2C ohne Angabe eines ASP.NET Core-Hosts. Der Standardwert ist user.read.

• --kestrelHttpPort

  Portnummer, die für den HTTP-Endpunkt in launchSettings.json verwendet werden soll.

• --kestrelHttpsPort

  Portnummer, die für den HTTPS-Endpunkt in launchSettings.json verwendet werden soll. Diese Option gilt nicht, wenn der Parameter no-https verwendet wird (no-https wird jedoch ignoriert, wenn eine einzelne oder eine Organisationseinstellung für die Authentifizierung für --auth ausgewählt ist).

• --use-program-main

  Wenn angegeben, werden eine explizite Program-Klasse und Main-Methode anstelle von Anweisungen der obersten Ebene verwendet. Verfügbar seit .NET SDK 6.0.300. Standardwert. false.

---

web

• --exclude-launch-settings

  Schließt launchSettings.json aus der generierten Vorlage aus.

• -f|--framework <FRAMEWORK>

  Gibt das Zielframework an. Die Option ist nicht in .NET Core 2.2 SDK verfügbar.

  In der folgenden Tabelle sind die Standardwerte entsprechend der von Ihnen verwendeten SDK-Versionsnummer aufgeführt:

  SDK-Version	Standardwert
  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

  Weitere Informationen zum Erstellen eines Projekts für ein früheres Framework als das des verwendeten SDK finden Sie in diesem Artikel unter --framework für console-Projekte.

• --no-restore

  Führt während der Projekterstellung keine implizite Wiederherstellung durch.

• --no-https

  Deaktiviert HTTPS.

• --kestrelHttpPort

  Portnummer, die für den HTTP-Endpunkt in launchSettings.json verwendet werden soll.

• --kestrelHttpsPort

  Portnummer, die für den HTTPS-Endpunkt in launchSettings.json verwendet werden soll. Diese Option gilt nicht, wenn der Parameter no-https verwendet wird (no-https wird jedoch ignoriert, wenn eine einzelne oder eine Organisationseinstellung für die Authentifizierung für --auth ausgewählt ist).

• --use-program-main

  Wenn angegeben, werden eine explizite Program-Klasse und Main-Methode anstelle von Anweisungen der obersten Ebene verwendet. Verfügbar seit .NET SDK 6.0.300. Standardwert. false.

---

mvc, webapp

• -au|--auth <AUTHENTICATION_TYPE>

  Der zu verwendende Authentifizierungstyp. Mögliche Werte sind:

  • None: keine Authentifizierung (Standard)
  • Individual: einzelne Authentifizierung
  • IndividualB2C: einzelne Authentifizierung mit Azur AD B2C
  • SingleOrg: Organisationauthentifizierung für einzelne Mandanten Externe ENTra-ID-Mandanten verwenden auch SingleOrg.
  • MultiOrg: Organisationauthentifizierung für mehrere Mandanten
  • Windows: Windows-Authentifizierung

• --aad-b2c-instance <INSTANCE>

  Die Azure Active Directory B2C-Instanz, mit der eine Verbindung hergestellt werden soll. Mit der IndividualB2C-Authentifizierung verwenden Der Standardwert ist https://login.microsoftonline.com/tfp/.

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

  Die ID der Anmelde- und Registrierungsrichtlinie für dieses Projekt. Mit der IndividualB2C-Authentifizierung verwenden

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

  Die Richtlinien-ID zum Zurücksetzen des Kennworts für dieses Projekt. Mit der IndividualB2C-Authentifizierung verwenden

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

  Die Richtlinien-ID zum Bearbeiten des Profils für dieses Projekt. Mit der IndividualB2C-Authentifizierung verwenden

• --aad-instance <INSTANCE>

  Die Azure Active Directory-Instanz, mit der eine Verbindung hergestellt werden soll. Mit der SingleOrg- oder MultiOrg-Authentifizierung verwenden Der Standardwert ist https://login.microsoftonline.com/.

• --client-id <ID>

  Die Client-ID für dieses Projekt. Mit der IndividualB2C-, SingleOrg-oder MultiOrg-Authentifizierung verwenden Der Standardwert ist 11111111-1111-1111-11111111111111111.

• --domain <DOMAIN>

  Die Domäne für den Verzeichnismandanten. Mit der SingleOrg- oder IndividualB2C-Authentifizierung verwenden Der Standardwert ist qualified.domain.name.

• --tenant-id <ID>

  Die Mandanten-ID des Verzeichnisses, mit dem eine Verbindung hergestellt werden soll. Mit der SingleOrg-Authentifizierung verwenden Der Standardwert ist 22222222-2222-2222-2222-222222222222.

• --callback-path <PATH>

  Der Anforderungspfad innerhalb des Basispfads des Umleitungs-URIs der Anwendung. Mit der SingleOrg- oder IndividualB2C-Authentifizierung verwenden Der Standardwert ist /signin-oidc.

• -r|--org-read-access

  Erteilt der Anwendung Lesezugriff auf das Verzeichnis. Gilt nur für die SingleOrg- oder MultiOrg-Authentifizierung.

• --exclude-launch-settings

  Schließt launchSettings.json aus der generierten Vorlage aus.

• --no-https

  Deaktiviert HTTPS. Diese Option gilt nur, wenn Individual, IndividualB2C, SingleOrg oder MultiOrg nicht verwendet werden.

• -uld|--use-local-db

  Gibt an, dass LocalDB statt SQLite verwendet werden soll. Gilt nur für die Individual- oder IndividualB2C-Authentifizierung.

• -f|--framework <FRAMEWORK>

  Gibt das Zielframework an. Die Option ist ab .NET Core 3.0 SDK verfügbar.

  In der folgenden Tabelle sind die Standardwerte entsprechend der von Ihnen verwendeten SDK-Versionsnummer aufgeführt:

  SDK-Version	Standardwert
  8.0	net8.0
  7.0	net7.0
  6.0	net6.0
  5.0	net5.0
  3.1	netcoreapp3.1
  3.0	netcoreapp3.0

  Weitere Informationen zum Erstellen eines Projekts für ein früheres Framework als das des verwendeten SDK finden Sie in diesem Artikel unter --framework für console-Projekte.

• --no-restore

  Führt während der Projekterstellung keine implizite Wiederherstellung durch.

• --use-browserlink

  Schließt BrowserLink in das Projekt ein. Die Option ist nicht in .NET Core 2.2 und 3.1 SDK verfügbar.

• -rrc|--razor-runtime-compilation

  Bestimmt, ob das Projekt zur Verwendung der Razor-Runtimekompilierung in Debugbuilds konfiguriert ist. Die Option ist ab .NET Core SDK 3.1.201 verfügbar.

• --kestrelHttpPort

  Portnummer, die für den HTTP-Endpunkt in launchSettings.json verwendet werden soll.

• --kestrelHttpsPort

  Portnummer, die für den HTTPS-Endpunkt in launchSettings.json verwendet werden soll. Diese Option gilt nicht, wenn der Parameter no-https verwendet wird (no-https wird jedoch ignoriert, wenn eine einzelne oder eine Organisationseinstellung für die Authentifizierung für --auth ausgewählt ist).

• --use-program-main

  Wenn angegeben, werden eine explizite Program-Klasse und Main-Methode anstelle von Anweisungen der obersten Ebene verwendet. Verfügbar seit .NET SDK 6.0.300. Standardwert. false.

---

angular, react

Seit .NET 8 SDK nicht mehr vorhanden.

• -au|--auth <AUTHENTICATION_TYPE>

  Der zu verwendende Authentifizierungstyp. Verfügbar seit .NET Core 3.0 SDK.

  Mögliche Werte sind:

  • None: keine Authentifizierung (Standard)
  • Individual: einzelne Authentifizierung

• --exclude-launch-settings

  Schließt launchSettings.json aus der generierten Vorlage aus.

• --no-restore

  Führt während der Projekterstellung keine implizite Wiederherstellung durch.

• --no-https

  Deaktiviert HTTPS. Diese Option gilt nur, wenn die Authentifizierung None ist.

• -uld|--use-local-db

  Gibt an, dass LocalDB statt SQLite verwendet werden soll. Gilt nur für die Individual- oder IndividualB2C-Authentifizierung. Verfügbar seit .NET Core 3.0 SDK.

• -f|--framework <FRAMEWORK>

  Gibt das Zielframework an. Die Option ist nicht in .NET Core 2.2 SDK verfügbar.

  In der folgenden Tabelle sind die Standardwerte entsprechend der von Ihnen verwendeten SDK-Versionsnummer aufgeführt:

  Hinweis

  Es gibt keine React-Vorlage für net8.0. Wenn Sie React-Apps mit ASP.NET Core entwickeln möchten, finden Sie weitere Informationen unter Übersicht über Single-Page-Webanwendung (SPA) in ASP.NET Core.

  SDK-Version	Standardwert
  7.0	net7.0
  6.0	net6.0
  5.0	net5.0
  3.1	netcoreapp3.1
  3.0	netcoreapp3.0
  2.1	netcoreapp2.0

  Weitere Informationen zum Erstellen eines Projekts für ein früheres Framework als das des verwendeten SDK finden Sie in diesem Artikel unter --framework für console-Projekte.

• --kestrelHttpPort

  Portnummer, die für den HTTP-Endpunkt in launchSettings.json verwendet werden soll.

• --kestrelHttpsPort

  Portnummer, die für den HTTPS-Endpunkt in launchSettings.json verwendet werden soll. Diese Option gilt nicht, wenn der Parameter no-https verwendet wird (no-https wird jedoch ignoriert, wenn eine einzelne oder eine Organisationseinstellung für die Authentifizierung für --auth ausgewählt ist).

• --use-program-main

  Wenn angegeben, werden eine explizite Program-Klasse und Main-Methode anstelle von Anweisungen der obersten Ebene verwendet. Verfügbar seit .NET SDK 6.0.300. Standardwert. false.

---

razorclasslib

• --no-restore

  Führt während der Projekterstellung keine implizite Wiederherstellung durch.

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

  Unterstützt das Hinzufügen von herkömmlichen Razor-Seiten und -Ansichten sowie von Komponenten zu dieser Bibliothek. Verfügbar seit .NET Core 3.0 SDK.

---

webapiaot

Erstellt ein Web-API-Projekt mit aktivierter AOT-Veröffentlichung. Weitere Informationen finden Sie unter Native AOT-Bereitstellung und Web-API-Vorlage (natives AOT).

• --exclude-launch-settings

  Schließt launchSettings.json aus der generierten Vorlage aus.

• -f|--framework <FRAMEWORK>

  Gibt das Zielframework an.

  In der folgenden Tabelle sind die Standardwerte entsprechend der von Ihnen verwendeten SDK-Versionsnummer aufgeführt:

  SDK-Version	Standardwert
  8.0	net8.0

• --no-restore

  Führt während der Projekterstellung keine implizite Wiederherstellung durch.

• --use-program-main

  Wenn angegeben, werden eine explizite Program-Klasse und Main-Methode anstelle von Anweisungen der obersten Ebene verwendet. Verfügbar seit .NET SDK 6.0.300. Standardwert. false.

---

webapi

• -au|--auth <AUTHENTICATION_TYPE>

  Der zu verwendende Authentifizierungstyp. Mögliche Werte sind:

  • None: keine Authentifizierung (Standard)
  • IndividualB2C: einzelne Authentifizierung mit Azur AD B2C
  • SingleOrg: Organisationauthentifizierung für einzelne Mandanten Externe ENTra-ID-Mandanten verwenden auch SingleOrg.
  • Windows: Windows-Authentifizierung

• --aad-b2c-instance <INSTANCE>

  Die Azure Active Directory B2C-Instanz, mit der eine Verbindung hergestellt werden soll. Mit der IndividualB2C-Authentifizierung verwenden Der Standardwert ist https://login.microsoftonline.com/tfp/.

• -minimal|--use-minimal-apis

  Erstellen Sie ein Projekt, das die minimale ASP.NET Core-API verwendet. Der Standardwert ist false, aber diese Option wird von -controllers außer Kraft gesetzt. Da der Standardwert für -controllersfalse ist, wird durch die Eingabe von dotnet new webapi ohne Angabe einer Option ein Minimal-API-Projekt erstellt.

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

  Die ID der Anmelde- und Registrierungsrichtlinie für dieses Projekt. Mit der IndividualB2C-Authentifizierung verwenden

• --aad-instance <INSTANCE>

  Die Azure Active Directory-Instanz, mit der eine Verbindung hergestellt werden soll. Mit der SingleOrg-Authentifizierung verwenden Der Standardwert ist https://login.microsoftonline.com/.

• --client-id <ID>

  Die Client-ID für dieses Projekt. Mit der IndividualB2C- oder SingleOrg-Authentifizierung verwenden Der Standardwert ist 11111111-1111-1111-11111111111111111.

• -controllers|--use-controllers

  Gibt an, ob Controller anstelle von Minimal-APIs verwendet werden sollen. Wenn diese Option und -minimal angegeben werden, setzt diese Option den durch -minimal angegebenen Wert außer Kraft. Der Standardwert ist false. Verfügbar ab dem .NET 8 SDK.

• --domain <DOMAIN>

  Die Domäne für den Verzeichnismandanten. Mit der IndividualB2C- oder SingleOrg-Authentifizierung verwenden Der Standardwert ist qualified.domain.name.

• --tenant-id <ID>

  Die Mandanten-ID des Verzeichnisses, mit dem eine Verbindung hergestellt werden soll. Mit der SingleOrg-Authentifizierung verwenden Der Standardwert ist 22222222-2222-2222-2222-222222222222.

• -r|--org-read-access

  Erteilt der Anwendung Lesezugriff auf das Verzeichnis. Gilt nur für die SingleOrg-Authentifizierung.

• --exclude-launch-settings

  Schließt launchSettings.json aus der generierten Vorlage aus.

• --no-openapi

  Deaktiviert die Unterstützung von OpenAPI (Swagger). AddSwaggerGen, UseSwagger und UseSwaggerUI werden nicht aufgerufen.

• --no-https

  Deaktiviert HTTPS. In launchSettings.json wird kein HTTPS-Startprofil erstellt. app.UseHsts und app.UseHttpsRedirection werden in Program.cs/Startup.cs nicht aufgerufen. Diese Option gilt nur, wenn IndividualB2C oder SingleOrg nicht für die Authentifizierung verwendet werden.

• -uld|--use-local-db

  Gibt an, dass LocalDB statt SQLite verwendet werden soll. Gilt nur für die IndividualB2C-Authentifizierung.

• -f|--framework <FRAMEWORK>

  Gibt das Zielframework an. Die Option ist nicht in .NET Core 2.2 SDK verfügbar.

  In der folgenden Tabelle sind die Standardwerte entsprechend der von Ihnen verwendeten SDK-Versionsnummer aufgeführt:

  SDK-Version	Standardwert
  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

  Weitere Informationen zum Erstellen eines Projekts für ein früheres Framework als das des verwendeten SDK finden Sie in diesem Artikel unter --framework für console-Projekte.

• --no-restore

  Führt während der Projekterstellung keine implizite Wiederherstellung durch.

• --use-program-main

  Wenn angegeben, werden eine explizite Program-Klasse und Main-Methode anstelle von Anweisungen der obersten Ebene verwendet. Verfügbar seit .NET SDK 6.0.300. Standardwert. false.

---

apicontroller

API-Controller mit oder ohne Lese-/Schreibaktionen.

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

  Der Namespace für den erstellten Code. Der Standardwert ist MyApp.Namespace.

• -ac|--actions

  Erstellen Sie einen Controller mit Lese-/Schreibaktionen. Der Standardwert ist false.

---

globaljson

• --sdk-version <VERSION_NUMBER>

  Gibt die Version des .NET SDK an, die in der Datei global.json verwendet werden soll

editorconfig

Erstellt eine EDITORCONFIG-Datei zum Konfigurieren von Codeformateinstellungen.

• --empty

  Erstellt leere EDITORCONFIG-Datei anstelle der Standardwerte für .NET.

Siehe auch

• Befehl „dotnet new“
• Befehl „dotnet new list“
• Custom templates for dotnet new (Benutzerdefinierte Vorlagen für dotnet new)
• Erstellen eines benutzerdefinierten Vorlagen-Assistenten
• Implizite using-Anweisungen