.NET-Standardvorlagen für dotnet new

  • Artikel

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
MSTest Test Project mstest [C#], F#, VB Test/MSTest 1.0
MSTest-Testklasse mstest-class [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 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, oder net6.0 um eine .NET-Klassenbibliothek zu erstellen oder netstandard2.0 netstandard2.1 eine .NET Standard Class Library 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

  • -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
    9.0 net9.0
    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.

  • --no-restore

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

  • --sdk

    Verwenden Sie den MSTest.Sdk-Projektstil.

  • --test-runner <TEST_RUNNER>

    Die Runner/Plattform für das Testprojekt. Mögliche Werte sind:

    • VSTest - VSTest-Plattform (Standard).
    • MSTest - MSTest Runner (d. h. Microsoft.Testing.Platform).

  • --coverage-tool <COVERAGE_TOOL>

    Das Abdeckungstool, das für das Testprojekt verwendet werden soll. Mögliche Werte sind:

    • Microsoft.CodeCoverage - Microsoft Code Coverage (Standard).
    • coverlet - Coverlet-Abdeckungstool.

  • --extensions-profile <EXTENSIONS_PROFILE>

    Das SDK-Erweiterungsprofil bei Verwendung von MSTest Runner. Mögliche Werte sind:

    • Default - Standarderweiterungsprofil (Standard).
    • None – Es sind keine Erweiterungen aktiviert.
    • AllMicrosoft – Aktiviert alle von Microsoft bereitgestellten Erweiterungen (einschließlich der Erweiterungen mit einer restriktiven Lizenz).

  • --fixture <FIXTURE>

    Die Vorrichtungsarten, die in das Testprojekt aufgenommen werden sollen. Mögliche Werte sind:

    • None - Keine Vorrichtungsmethoden.
    • AssemblyInitialize - AssemblyInitialize-Vorrichtungsmethode.
    • AssemblyCleanup - AssemblyCleanup-Vorrichtungsmethode.
    • ClassInitialize - ClassInitialize-Vorrichtungsmethode.
    • ClassCleanup - ClassCleanup-Vorrichtungsmethode.
    • TestInitialize - TestInitialize-Vorrichtungsmethode.
    • TestCleanup - TestCleanup-Vorrichtungsmethode.

    Dabei sind mehrere Werte zulässig.

  • -p|--enable-pack

    Ermöglicht das Packen des Projekts mit dotnet pack.

mstest-class

  • --fixture <FIXTURE>

    Die Vorrichtungsarten, die in das Testprojekt aufgenommen werden sollen. Mögliche Werte sind:

    • None - Keine Vorrichtungsmethoden.
    • AssemblyInitialize - AssemblyInitialize-Vorrichtungsmethode.
    • AssemblyCleanup - AssemblyCleanup-Vorrichtungsmethode.
    • ClassInitialize - ClassInitialize-Vorrichtungsmethode.
    • ClassCleanup - ClassCleanup-Vorrichtungsmethode.
    • TestInitialize - TestInitialize-Vorrichtungsmethode.
    • TestCleanup - TestCleanup-Vorrichtungsmethode.

    Dabei sind mehrere Werte zulässig.

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
    9.0 net9.0
    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
    9.0 net9.0
    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 -controllers false 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

  • --roll-forward <ROLL_FORWARD_POLICY>

    Die Rollforwardrichtlinie, die beim Auswählen einer SDK-Version verwendet werden soll, entweder als Fallback, wenn eine bestimmte SDK-Version fehlt, oder als Anweisung, damit eine spätere Version verwendet wird. Weitere Informationen finden Sie unter global-json.

editorconfig

Erstellt eine EDITORCONFIG-Datei zum Konfigurieren von Codeformateinstellungen.

  • --empty

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

Siehe auch