次の方法で共有

dotnet new 用の .NET の既定のテンプレート

  • [アーティクル]

.NET SDK をインストールすると、コンソール アプリ、クラス ライブラリ、単体テスト プロジェクト、ASP.NET Core アプリ (Angular プロジェクトと React プロジェクトを含む)、構成ファイルなど、プロジェクトやファイルを作成するための 12 個を超える組み込みテンプレートが提供されます。 組み込みテンプレートの一覧を表示するには、dotnet new list コマンドを実行します。

dotnet new list

次の表は、.NET SDK にプレインストールされているテンプレートを示しています。 テンプレートの既定の言語は、角かっこで示されます。 短い名前のリンクをクリックすると、特定のテンプレート オプションが表示されます。

テンプレート 短い名前 言語 Tags 導入時期
コンソール アプリケーション console [C#], F#, VB Common/Console 1.0
クラス ライブラリ classlib [C#], F#, VB Common/Library 1.0
WPF アプリケーション wpf [C#]、VB Common/WPF 3.0 (VB の場合は 5.0)
WPF クラス ライブラリ wpflib [C#]、VB Common/WPF 3.0 (VB の場合は 5.0)
WPF カスタム コントロール ライブラリ wpfcustomcontrollib [C#]、VB Common/WPF 3.0 (VB の場合は 5.0)
WPF ユーザー コントロール ライブラリ wpfusercontrollib [C#]、VB Common/WPF 3.0 (VB の場合は 5.0)
Windows フォーム (WinForms) アプリケーション winforms [C#]、VB Common/WinForms 3.0 (VB の場合は 5.0)
Windows フォーム (WinForms) クラス ライブラリ winformslib [C#]、VB Common/WinForms 3.0 (VB の場合は 5.0)
Worker Service worker [C#] Common/Worker/Web 3.0
MSTest テスト プロジェクト mstest [C#], F#, VB Test/MSTest 1.0
MSTest テスト クラス mstest-class [C#], F#, VB Test/MSTest 1.0
NUnit 3 テスト プロジェクト nunit [C#], F#, VB Test/NUnit 2.1.400
NUnit 3 テスト項目 nunit-test [C#], F#, VB Test/NUnit 2.2
xUnit テスト プロジェクト xunit [C#], F#, VB Test/xUnit 1.0
Razor コンポーネント razorcomponent [C#] Web/ASP.NET 3.0
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 アプリ blazor [C#] Web/Blazor 8.0.100
BlazorWebAssembly スタンドアロン アプリ blazorwasm [C#] Web/Blazor/WebAssembly/PWA 3.1.300
ASP.NET Core 空 web [C#], F# Web/Empty 1.0
ASP.NET Core Web アプリ (モデル ビュー コントローラー) mvc [C#], F# Web/MVC 1.0
ASP.NET Core Web アプリ webapp, razor [C#] Web/MVC/Razor Pages 2.2、2.0
Razor クラス ライブラリ razorclasslib [C#] Web/Razor/Library/Razor Class Library 2.1
ASP.NET Core Web API webapi [C#], F# Web/Web API/API/Service/WebAPI 1
ASP.NET Core API webapiaot [C#] Web/Web API/API/Service 8.0
ASP.NET Core API コントローラー apicontroller [C#] Web/ASP.NET 8.0
ASP.NET Core gRPC サービス grpc [C#] Web/gRPC 3.0
dotnet gitignore ファイル gitignore 構成 3.0
global.json file globaljson 構成 2.0
NuGet 構成 nugetconfig 構成 1.0
dotnet ローカル ツール マニフェスト ファイル tool-manifest 構成 3.0
Web 構成 webconfig 構成 1.0
ソリューション ファイル sln ソリューション 1.0
プロトコル バッファー ファイル proto Web/gRPC 3.0
EditorConfig ファイル editorconfig Config 6.0

次の表は、廃止され、.NET SDK と共にプレインストールされなくなったテンプレートを示しています。 短い名前のリンクをクリックすると、特定のテンプレート オプションが表示されます。

テンプレート 短い名前 言語 タグ 以降廃止
Angular 付きの ASP.NET Core angular [C#] Web/MVC/SPA 8.0
React.js 付きの ASP.NET Core react [C#] Web/MVC/SPA 8.0
Blazor サーバー アプリ blazorserver [C#] Web/Blazor 8.0
Blazor サーバー アプリが空 blazorserver-empty [C#] Web/Blazor 8.0
BlazorWebAssembly アプリが空 blazorwasm-empty [C#] Web/Blazor/WebAssembly 8.0

テンプレート オプション

各テンプレートでは、追加のオプションを使用できる場合があります。 テンプレートで使用できる追加のオプションを表示するには、--help オプションをテンプレート名引数と共に使用します (例: dotnet new console --help)。 テンプレートで複数の言語がサポートされている場合は、このコマンドにより、テンプレートのヘルプが既定の言語で表示されます。 これを --language オプションと組み合わせると、ヘルプを他の言語で表示できます: dotnet new console --help --language F#。 .NET SDK に付属するテンプレートには、次の追加オプションがあります。

console

  • -f|--framework <FRAMEWORK>

    ターゲットにするフレームワークが指定されます。 .NET Core 3.0 SDK 以降で使用できます。

    次の表は、使用する SDK バージョンに対応した既定値を示しています。

    SDK バージョン 既定値
    8.0 net8.0
    7.0 net7.0
    6.0 net6.0
    3.1 netcoreapp3.1

    以前の TFM 用のプロジェクトを作成できるかどうかは、そのバージョンの SDK がインストールされているかどうかによります。 たとえば、.NET 7 SDK のみがインストールされている場合、--framework に使用できる値は net7.0 のみです。 .NET 6 SDK をインストールすると、--framework に値 net6.0 を使用できるようになります。 .NET Core 3.1 SDK をインストールすると、netcoreapp3.1 が使用できるようになるといった具合です。 そのため、--framework netcoreapp3.1 を指定することで、.NET 6 SDK で dotnet new を実行中でも .NET Core 3.1 を対象にすることができます。

    また、使用している SDK より前のフレームワークをターゲットにしたプロジェクトを作成するには、テンプレートの NuGet パッケージをインストールして実行することもできる場合があります。 共通、Web、SPA のプロジェクトの種類には、ターゲット フレームワーク モニカー (TFM) ごとに異なるパッケージが使用されます。 たとえば、netcoreapp1.0 をターゲットにした console プロジェクトを作成するには、Microsoft.DotNet.Common.ProjectTemplates.1.x に対して dotnet new install を実行します。

  • --langVersion <VERSION_NUMBER>

    作成されたプロジェクト ファイルの LangVersion プロパティが設定されます。 たとえば、C# 7.3 を使うには --langVersion 7.3 を使います。 F# に対してはサポートされません。 .NET Core 2.2 SDK 以降で利用できます。

    既定の C# バージョンの一覧については、「既定値」をご覧ください。

  • --no-restore

    指定した場合、プロジェクトの作成中には暗黙的な復元が実行されません。 .NET Core 2.2 SDK 以降で利用できます。

  • --use-program-main

    指定した場合、最上位レベルのステートメントの代わりに、明示的な Program クラスと Main メソッドが使用されます。 .NET SDK 6.0.300 以降で使用可能です。 既定値: false。 C# でのみ使用できます。

classlib

  • -f|--framework <FRAMEWORK>

    ターゲットにするフレームワークが指定されます。 値: .NET クラス ライブラリを作成するための net8.0、 net7.0、または net6.0 、または .NET Standard クラス ライブラリを作成するための netstandard2.1 または netstandard2.0 。 .NET SDK 8.0.x の既定値は net8.0 です。

    使用している SDK よりも前のフレームワークをターゲットにしたプロジェクトを作成するには、この記事で前述したconsole プロジェクト用の --frameworkを参照してください。

  • --langVersion <VERSION_NUMBER>

    作成されたプロジェクト ファイルの LangVersion プロパティが設定されます。 たとえば、C# 7.3 を使うには --langVersion 7.3 を使います。 F# に対してはサポートされません。 .NET Core 2.2 SDK 以降で利用できます。

    既定の C# バージョンの一覧については、「既定値」をご覧ください。

  • --no-restore

    プロジェクトの作成中に暗黙的な復元は実行されません。

wpf、 wpflib、 wpfcustomcontrollib、 wpfusercontrollib

  • -f|--framework <FRAMEWORK>

    ターゲットにするフレームワークが指定されます。 .NET 8 SDK の場合、既定値は net8.0 です。 .NET Core 3.1 SDK 以降で利用できます。

  • --langVersion <VERSION_NUMBER>

    作成されたプロジェクト ファイルの LangVersion プロパティが設定されます。 たとえば、C# 7.3 を使うには --langVersion 7.3 を使います。

    既定の C# バージョンの一覧については、「既定値」をご覧ください。

  • --no-restore

    プロジェクトの作成中に暗黙的な復元は実行されません。

winforms, winformslib

  • --langVersion <VERSION_NUMBER>

    作成されたプロジェクト ファイルの LangVersion プロパティが設定されます。 たとえば、C# 7.3 を使うには --langVersion 7.3 を使います。

    既定の C# バージョンの一覧については、「既定値」をご覧ください。

  • --no-restore

    プロジェクトの作成中に暗黙的な復元は実行されません。

worker, grpc

  • -f|--framework <FRAMEWORK>

    ターゲットにするフレームワークが指定されます。 .NET 8 SDK の既定値は net8.0 です。 .NET Core 3.1 SDK 以降で利用できます。

    使用している SDK よりも前のフレームワークをターゲットにしたプロジェクトを作成するには、この記事で前述したconsole プロジェクト用の --frameworkを参照してください。

  • --exclude-launch-settings

    生成されたテンプレートから launchSettings.json が除外されます。

  • --no-restore

    プロジェクトの作成中に暗黙的な復元は実行されません。

  • --use-program-main

    指定した場合、最上位レベルのステートメントの代わりに、明示的な Program クラスと Main メソッドが使用されます。 .NET SDK 6.0.300 以降で使用可能です。 既定値: false。

mstest

  • -f|--framework <FRAMEWORK>

    ターゲットにするフレームワークが指定されます。 .NET Core 3.0 SDK 以降で利用できるオプションです。

    次の表は、使用する SDK バージョン番号に対応した既定値を示しています。

    SDK バージョン 規定値
    9.0 net9.0
    8.0 net8.0
    7.0 net7.0
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1

以前の TFM 用のプロジェクトを作成できるかどうかは、そのバージョンの SDK がインストールされているかどうかによります。 たとえば、.NET 6 SDK のみがインストールされている場合、--framework に使用できる値は net6.0 のみです。 .NET 5 SDK をインストールすると、--framework に値 net5.0 を使用できるようになります。 .NET Core 3.1 SDK をインストールすると、netcoreapp3.1 が使用できるようになるといった具合です。 そのため、--framework netcoreapp3.1 を指定することで、.NET 6 SDK で dotnet new を実行中でも .NET Core 3.1 を対象にすることができます。

  • --no-restore

    プロジェクトの作成中に暗黙的な復元は実行されません。

  • --sdk

    MSTest.Sdk プロジェクト スタイルを使用します。

  • --test-runner <TEST_RUNNER>

    テスト プロジェクトのランナー/プラットフォーム。 指定できる値は、

    • VSTest - VSTest プラットフォーム (既定)。
    • MSTest - MSTest Runner (つまり、Microsoft.Testing.Platform)。

  • --coverage-tool <COVERAGE_TOOL>

    テスト プロジェクトに使用するカバレッジ ツール。 指定できる値は、

    • Microsoft.CodeCoverage - Microsoft コード カバレッジ (既定)。
    • coverlet - カバーレット カバレッジ ツール。

  • --extensions-profile <EXTENSIONS_PROFILE>

    MSTest Runner を使用する場合の SDK 拡張機能プロファイル。 指定できる値は、

    • Default - 既定の拡張機能プロファイル (既定)。
    • None - 拡張機能は何も有効化されません。
    • AllMicrosoft - Microsoft からのすべての拡張機能 (制限付きライセンスの拡張機能も含まれます) が有効になります。

  • --fixture <FIXTURE>

    テスト プロジェクトに含めるフィクスチャの種類。 指定できる値は、

    • None - フィクスチャ メソッドはありません。
    • AssemblyInitialize - AssemblyInitialize フィクスチャ メソッド。
    • AssemblyCleanup - AssemblyCleanup フィクスチャ メソッド。
    • ClassInitialize - ClassInitialize フィクスチャ メソッド。
    • ClassCleanup - ClassCleanup フィクスチャ メソッド。
    • TestInitialize - TestInitialize フィクスチャ メソッド。
    • TestCleanup - TestCleanup フィクスチャ メソッド。

    複数の値が許可されている場合。

  • -p|--enable-pack

    dotnet pack を使用してプロジェクトのパッケージ化が有効化されます。

mstest-class

  • --fixture <FIXTURE>

    テスト プロジェクトに含めるフィクスチャの種類。 指定できる値は、

    • None - フィクスチャ メソッドはありません。
    • AssemblyInitialize - AssemblyInitialize フィクスチャ メソッド。
    • AssemblyCleanup - AssemblyCleanup フィクスチャ メソッド。
    • ClassInitialize - ClassInitialize フィクスチャ メソッド。
    • ClassCleanup - ClassCleanup フィクスチャ メソッド。
    • TestInitialize - TestInitialize フィクスチャ メソッド。
    • TestCleanup - TestCleanup フィクスチャ メソッド。

    複数の値が許可されている場合。

xunit

  • -f|--framework <FRAMEWORK>

    ターゲットにするフレームワークが指定されます。 .NET Core 3.0 SDK 以降で利用できるオプションです。

    次の表は、使用する SDK バージョン番号に対応した既定値を示しています。

    SDK バージョン 規定値
    9.0 net9.0
    8.0 net8.0
    7.0 net7.0
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1

以前の TFM 用のプロジェクトを作成できるかどうかは、そのバージョンの SDK がインストールされているかどうかによります。 たとえば、.NET 6 SDK のみがインストールされている場合、--framework に使用できる値は net6.0 のみです。 .NET 5 SDK をインストールすると、--framework に値 net5.0 を使用できるようになります。 .NET Core 3.1 SDK をインストールすると、netcoreapp3.1 が使用できるようになるといった具合です。 そのため、--framework netcoreapp3.1 を指定することで、.NET 6 SDK で dotnet new を実行中でも .NET Core 3.1 を対象にすることができます。

  • -p|--enable-pack

    dotnet pack を使用してプロジェクトのパッケージ化が有効化されます。

  • --no-restore

    プロジェクトの作成中に暗黙的な復元は実行されません。

nunit

  • -f|--framework <FRAMEWORK>

    ターゲットにするフレームワークが指定されます。

    次の表は、使用する SDK バージョン番号に対応した既定値を示しています。

    SDK バージョン 規定値
    9.0 net9.0
    8.0 net8.0
    7.0 net7.0
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1

以前の TFM 用のプロジェクトを作成できるかどうかは、そのバージョンの SDK がインストールされているかどうかによります。 たとえば、.NET 6 SDK のみがインストールされている場合、--framework に使用できる値は net6.0 のみです。 .NET 5 SDK をインストールすると、--framework に値 net5.0 を使用できるようになります。 .NET Core 3.1 SDK をインストールすると、netcoreapp3.1 が使用できるようになるといった具合です。 そのため、--framework netcoreapp3.1 を指定することで、.NET 6 SDK で dotnet new を実行中でも .NET Core 3.1 を対象にすることができます。

  • -p|--enable-pack

    dotnet pack を使用してプロジェクトのパッケージ化が有効化されます。

  • --no-restore

    プロジェクトの作成中に暗黙的な復元は実行されません。

page

  • -na|--namespace <NAMESPACE_NAME>

    生成されるコードの名前空間です。 既定値は MyApp.Namespace です。

  • -np|--no-pagemodel

    PageModel なしでページが作成されます。

viewimports, proto

  • -na|--namespace <NAMESPACE_NAME>

    生成されるコードの名前空間です。 既定値は MyApp.Namespace です。

blazorserver

.NET 8 SDK 以降で廃止されました。

  • -au|--auth <AUTHENTICATION_TYPE>

    使う認証の種類。 次の値を指定できます。

    • None - 認証は行われません (既定)。
    • Individual - 個別認証です。
    • IndividualB2C - Azure AD B2C での個別認証。
    • SingleOrg - 単一のテナントに対する組織認証。 Entra 外部 ID テナントも SingleOrg を使用します。
    • MultiOrg - 複数のテナントに対する組織認証です。
    • Windows - Windows 認証。

  • --aad-b2c-instance <INSTANCE>

    接続先の Azure Active Directory B2C インスタンス。 IndividualB2C 認証で使用します。 既定値は https://login.microsoftonline.com/tfp/ です。

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

    このプロジェクト用のサインインおよびサインアップ ポリシー ID です。 IndividualB2C 認証で使用します。

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

    このプロジェクトのリセット パスワード ポリシー ID です。 IndividualB2C 認証で使用します。

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

    このプロジェクトの編集プロファイル ポリシー ID です。 IndividualB2C 認証で使用します。

  • --aad-instance <INSTANCE>

    接続先の Azure Active Directory インスタンスです。 SingleOrg 認証または MultiOrg 認証で使用します。 既定値は https://login.microsoftonline.com/ です。

  • --client-id <ID>

    このプロジェクトのクライアント ID です。 IndividualB2C 認証、SingleOrg 認証、または MultiOrg 認証で使用します。 既定値は 11111111-1111-1111-11111111111111111 です。

  • --domain <DOMAIN>

    ディレクトリ テナントのドメインです。 SingleOrg 認証または IndividualB2C 認証で使用します。 既定値は qualified.domain.name です。

  • --tenant-id <ID>

    接続先のディレクトリの TenantId ID です。 SingleOrg 認証で使用します。 既定値は 22222222-2222-2222-2222-222222222222 です。

  • --callback-path <PATH>

    リダイレクト URI のアプリケーションの基本パス内の要求パスです。 SingleOrg 認証または IndividualB2C 認証で使用します。 既定値は /signin-oidc です。

  • -r|--org-read-access

    このアプリケーションにディレクトリへの読み取りアクセスを許可します。 SingleOrg 認証または MultiOrg 認証にのみ適用されます。

  • --exclude-launch-settings

    生成されたテンプレートから launchSettings.json が除外されます。

  • --no-https

    HTTPS を無効にします。 このオプションは、Individual、IndividualB2C、SingleOrg、または MultiOrg が --auth 用に使用されない場合にのみ適用されます。

  • -uld|--use-local-db

    SQLite ではなく LocalDB が使用されるように指定されます。 Individual 認証または IndividualB2C 認証にのみ適用されます。

  • --no-restore

    プロジェクトの作成中に暗黙的な復元は実行されません。

  • --kestrelHttpPort

    launchSettings.json で HTTP エンドポイントに使用するポート番号。

  • --kestrelHttpsPort

    launchSettings.json で HTTPS エンドポイントに使用するポート番号。 このオプションは、パラメーター no-https が使用されている場合には適用されません (ただし、--auth で個人または組織の認証設定が選択されている場合、no-https は無視されます)。

  • --use-program-main

    指定した場合、最上位レベルのステートメントの代わりに、明示的な Program クラスと Main メソッドが使用されます。 .NET SDK 6.0.300 以降で使用可能です。 既定値: false。

blazor

  • -f|--framework <FRAMEWORK>

    ターゲットにするフレームワークが指定されます。

    このテンプレートは、.NET 8 以降で使用できます。

  • --no-restore

    プロジェクトの作成中に暗黙的な復元は実行されません。

  • --exclude-launch-settings

    生成されたアプリから launchSettings.json が除外されます。

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

    対話型コンポーネントに使用する対話型レンダリング モードが指定されます。 指定できる値は、

    • None - インタラクティビティなし (静的サーバー側レンダリングのみ)。
    • Server - (既定) 対話型のサーバー側レンダリングを使用して、サーバー上でアプリを実行します。
    • WebAssembly - WebAssembly を使用してブラウザーでクライアント側レンダリングを使用してアプリを実行します。
    • Auto - Blazor バンドルをダウンロードし、クライアントで Blazor ランタイムをアクティブ化するときに対話型のサーバー側レンダリングを使用し、その後 WebAssembly でクライアント側レンダリングを使用します。

  • --empty

    基本的な使用パターンを示すサンプル ページとスタイル設定が省略されます。

  • -au|--auth <AUTHENTICATION_TYPE>

    使う認証の種類。 次の値を指定できます。

    • None - 認証は行われません (既定)。
    • Individual - 個別認証です。

  • -uld|--use-local-db

    SQLite ではなく LocalDB が使用されるように指定されます。 Individual 認証にのみ適用されます。

  • -ai|--all-interactive

    最上位レベルで対話型レンダリング モードを適用して、すべてのページを対話型にします。 false の場合、ページは既定で静的サーバー側レンダリングを使用し、ページ単位またはコンポーネント単位で対話型としてマークすることができます。 このオプションは、-i|--interactivity オプションが None に設定されていない場合にのみ有効です。

  • --no-https

    HTTPS を無効にします。 このオプションは、-au|--auth オプションに Individual が選択されていない場合にのみ適用されます。

  • --use-program-main

    指定した場合、最上位レベルのステートメントの代わりに、明示的な Program クラスと Main メソッドが生成されます。

blazorwasm

  • -f|--framework <FRAMEWORK>

    ターゲットにするフレームワークが指定されます。

    次の表は、使用する SDK バージョン番号に対応した既定値を示しています。

    SDK バージョン 既定値
    8.0 net8.0
    7.0 net7.0
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1

    使用している SDK よりも前のフレームワークをターゲットにしたプロジェクトを作成するには、この記事で前述したconsole プロジェクト用の --frameworkを参照してください。

  • --no-restore

    プロジェクトの作成中に暗黙的な復元は実行されません。

  • -ho|--hosted

    BlazorWebAssembly アプリ用の ASP.NET Core ホストが含まれています。

  • -au|--auth <AUTHENTICATION_TYPE>

    使う認証の種類。 次の値を指定できます。

    • None - 認証は行われません (既定)。
    • Individual - 個別認証です。
    • IndividualB2C - Azure AD B2C での個別認証。
    • SingleOrg - 単一のテナントに対する組織認証。 Entra 外部 ID テナントも SingleOrg を使用します。

  • --authority <AUTHORITY>

    OIDC プロバイダーの機関。 Individual 認証で使用します。 既定値は https://login.microsoftonline.com/ です。

  • --aad-b2c-instance <INSTANCE>

    接続先の Azure Active Directory B2C インスタンス。 IndividualB2C 認証で使用します。 既定値は https://aadB2CInstance.b2clogin.com/ です。

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

    このプロジェクト用のサインインおよびサインアップ ポリシー ID です。 IndividualB2C 認証で使用します。

  • --aad-instance <INSTANCE>

    接続先の Azure Active Directory インスタンスです。 SingleOrg 認証で使用します。 既定値は https://login.microsoftonline.com/ です。

  • --client-id <ID>

    このプロジェクトのクライアント ID です。 スタンドアロンのシナリオで、IndividualB2C、SingleOrg、または Individual 認証と共に使用します。 既定値は 33333333-3333-3333-33333333333333333 です。

  • --domain <DOMAIN>

    ディレクトリ テナントのドメインです。 SingleOrg 認証または IndividualB2C 認証で使用します。 既定値は qualified.domain.name です。

  • --app-id-uri <URI>

    呼び出すサーバー API のアプリ ID URI。 SingleOrg 認証または IndividualB2C 認証で使用します。 既定値は api.id.uri です。

  • --api-client-id <ID>

    サーバーでホストされる API のクライアント ID。 SingleOrg 認証または IndividualB2C 認証で使用します。 既定値は 11111111-1111-1111-11111111111111111 です。

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

    アクセス トークンをプロビジョニングするためにクライアントが要求する必要のある API スコープ。 SingleOrg 認証または IndividualB2C 認証で使用します。 既定値は user_impersonation です。

  • --tenant-id <ID>

    接続先のディレクトリの TenantId ID です。 SingleOrg 認証で使用します。 既定値は 22222222-2222-2222-2222-222222222222 です。

  • -r|--org-read-access

    このアプリケーションにディレクトリへの読み取りアクセスを許可します。 SingleOrg 認証にのみ適用されます。

  • --exclude-launch-settings

    生成されたテンプレートから launchSettings.json が除外されます。

  • -p|--pwa

    インストールとオフライン使用をサポートするプログレッシブ Web アプリケーション (PWA) が生成されます。

  • --no-https

    HTTPS を無効にします。 このオプションは、Individual、IndividualB2C、または SingleOrg が --auth 用に使用されていない場合にのみ適用されます。

  • -uld|--use-local-db

    SQLite ではなく LocalDB が使用されるように指定されます。 Individual 認証または IndividualB2C 認証にのみ適用されます。

  • --called-api-url <URL>

    Web アプリから呼び出すための API の URL。 ASP.NET Core ホストが指定されていない SingleOrg または IndividualB2C 認証にのみ適用されます。 既定値は https://graph.microsoft.com/v1.0/me です。

  • --calls-graph

    Web アプリによって Microsoft Graph が呼び出されるかどうかを指定します。 SingleOrg 認証にのみ適用されます。

  • --called-api-scopes <SCOPES>

    Web アプリから API を呼び出すように要求するスコープ。 ASP.NET Core ホストが指定されていない SingleOrg または IndividualB2C 認証にのみ適用されます。 既定値は、user.read です。

  • --kestrelHttpPort

    launchSettings.json で HTTP エンドポイントに使用するポート番号。

  • --kestrelHttpsPort

    launchSettings.json で HTTPS エンドポイントに使用するポート番号。 このオプションは、パラメーター no-https が使用されている場合には適用されません (ただし、--auth で個人または組織の認証設定が選択されている場合、no-https は無視されます)。

  • --use-program-main

    指定した場合、最上位レベルのステートメントの代わりに、明示的な Program クラスと Main メソッドが使用されます。 .NET SDK 6.0.300 以降で使用可能です。 既定値: false。

web

  • --exclude-launch-settings

    生成されたテンプレートから launchSettings.json が除外されます。

  • -f|--framework <FRAMEWORK>

    ターゲットにするフレームワークが指定されます。 .NET Core 2.2 SDK では使用できません。

    次の表は、使用する SDK バージョン番号に対応した既定値を示しています。

    SDK バージョン 既定値
    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

    使用している SDK よりも前のフレームワークをターゲットにしたプロジェクトを作成するには、この記事で前述したconsole プロジェクト用の --frameworkを参照してください。

  • --no-restore

    プロジェクトの作成中に暗黙的な復元は実行されません。

  • --no-https

    HTTPS を無効にします。

  • --kestrelHttpPort

    launchSettings.json で HTTP エンドポイントに使用するポート番号。

  • --kestrelHttpsPort

    launchSettings.json で HTTPS エンドポイントに使用するポート番号。 このオプションは、パラメーター no-https が使用されている場合には適用されません (ただし、--auth で個人または組織の認証設定が選択されている場合、no-https は無視されます)。

  • --use-program-main

    指定した場合、最上位レベルのステートメントの代わりに、明示的な Program クラスと Main メソッドが使用されます。 .NET SDK 6.0.300 以降で使用可能です。 既定値: false。

mvc, webapp

  • -au|--auth <AUTHENTICATION_TYPE>

    使う認証の種類。 次の値を指定できます。

    • None - 認証は行われません (既定)。
    • Individual - 個別認証です。
    • IndividualB2C - Azure AD B2C での個別認証。
    • SingleOrg - 単一のテナントに対する組織認証。 Entra 外部 ID テナントも SingleOrg を使用します。
    • MultiOrg - 複数のテナントに対する組織認証です。
    • Windows - Windows 認証。

  • --aad-b2c-instance <INSTANCE>

    接続先の Azure Active Directory B2C インスタンス。 IndividualB2C 認証で使用します。 既定値は https://login.microsoftonline.com/tfp/ です。

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

    このプロジェクト用のサインインおよびサインアップ ポリシー ID です。 IndividualB2C 認証で使用します。

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

    このプロジェクトのリセット パスワード ポリシー ID です。 IndividualB2C 認証で使用します。

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

    このプロジェクトの編集プロファイル ポリシー ID です。 IndividualB2C 認証で使用します。

  • --aad-instance <INSTANCE>

    接続先の Azure Active Directory インスタンスです。 SingleOrg 認証または MultiOrg 認証で使用します。 既定値は https://login.microsoftonline.com/ です。

  • --client-id <ID>

    このプロジェクトのクライアント ID です。 IndividualB2C 認証、SingleOrg 認証、または MultiOrg 認証で使用します。 既定値は 11111111-1111-1111-11111111111111111 です。

  • --domain <DOMAIN>

    ディレクトリ テナントのドメインです。 SingleOrg 認証または IndividualB2C 認証で使用します。 既定値は qualified.domain.name です。

  • --tenant-id <ID>

    接続先のディレクトリの TenantId ID です。 SingleOrg 認証で使用します。 既定値は 22222222-2222-2222-2222-222222222222 です。

  • --callback-path <PATH>

    リダイレクト URI のアプリケーションの基本パス内の要求パスです。 SingleOrg 認証または IndividualB2C 認証で使用します。 既定値は /signin-oidc です。

  • -r|--org-read-access

    このアプリケーションにディレクトリへの読み取りアクセスを許可します。 SingleOrg 認証または MultiOrg 認証にのみ適用されます。

  • --exclude-launch-settings

    生成されたテンプレートから launchSettings.json が除外されます。

  • --no-https

    HTTPS を無効にします。 このオプションは、Individual、IndividualB2C、SingleOrg、または MultiOrg が使用されない場合にのみ適用されます。

  • -uld|--use-local-db

    SQLite ではなく LocalDB が使用されるように指定されます。 Individual 認証または IndividualB2C 認証にのみ適用されます。

  • -f|--framework <FRAMEWORK>

    ターゲットにするフレームワークが指定されます。 .NET Core 3.0 SDK 以降で利用できるオプションです。

    次の表は、使用する SDK バージョン番号に対応した既定値を示しています。

    SDK バージョン 既定値
    8.0 net8.0
    7.0 net7.0
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.0

    使用している SDK よりも前のフレームワークをターゲットにしたプロジェクトを作成するには、この記事で前述したconsole プロジェクト用の --frameworkを参照してください。

  • --no-restore

    プロジェクトの作成中に暗黙的な復元は実行されません。

  • --use-browserlink

    プロジェクトに BrowserLink を含めます。 .NET Core 2.2 および 3.1 SDK では使用できません。

  • -rrc|--razor-runtime-compilation

    デバッグ ビルドで Razor ランタイム コンパイルを使用するようにプロジェクトが構成されているかどうかを判断します。 .NET Core 3.1.201 SDK 以降で利用できるオプションです。

  • --kestrelHttpPort

    launchSettings.json で HTTP エンドポイントに使用するポート番号。

  • --kestrelHttpsPort

    launchSettings.json で HTTPS エンドポイントに使用するポート番号。 このオプションは、パラメーター no-https が使用されている場合には適用されません (ただし、--auth で個人または組織の認証設定が選択されている場合、no-https は無視されます)。

  • --use-program-main

    指定した場合、最上位レベルのステートメントの代わりに、明示的な Program クラスと Main メソッドが使用されます。 .NET SDK 6.0.300 以降で使用可能です。 既定値: false。

angular, react

.NET 8 SDK 以降で廃止されました。

  • -au|--auth <AUTHENTICATION_TYPE>

    使う認証の種類。 .NET Core 3.0 SDK 以降で使用できます。

    次の値を指定できます。

    • None - 認証は行われません (既定)。
    • Individual - 個別認証です。

  • --exclude-launch-settings

    生成されたテンプレートから launchSettings.json が除外されます。

  • --no-restore

    プロジェクトの作成中に暗黙的な復元は実行されません。

  • --no-https

    HTTPS を無効にします。 このオプションは、認証が None の場合にのみ適用されます。

  • -uld|--use-local-db

    SQLite ではなく LocalDB が使用されるように指定されます。 Individual 認証または IndividualB2C 認証にのみ適用されます。 .NET Core 3.0 SDK 以降で使用できます。

  • -f|--framework <FRAMEWORK>

    ターゲットにするフレームワークが指定されます。 .NET Core 2.2 SDK では使用できません。

    次の表は、使用する SDK バージョン番号に対応した既定値を示しています。

    Note

    net8.0 の React テンプレートはありませんが、ASP.NET Core を使用した React アプリの開発に関心がある場合は、「ASP.NET Core でのシングルページ アプリケーション (SPA) の概要」を参照してください。

    SDK バージョン 既定値
    7.0 net7.0
    6.0 net6.0
    5.0 net5.0
    3.1 netcoreapp3.1
    3.0 netcoreapp3.0
    2.1 netcoreapp2.0

    使用している SDK よりも前のフレームワークをターゲットにしたプロジェクトを作成するには、この記事で前述したconsole プロジェクト用の --frameworkを参照してください。

  • --kestrelHttpPort

    launchSettings.json で HTTP エンドポイントに使用するポート番号。

  • --kestrelHttpsPort

    launchSettings.json で HTTPS エンドポイントに使用するポート番号。 このオプションは、パラメーター no-https が使用されている場合には適用されません (ただし、--auth で個人または組織の認証設定が選択されている場合、no-https は無視されます)。

  • --use-program-main

    指定した場合、最上位レベルのステートメントの代わりに、明示的な Program クラスと Main メソッドが使用されます。 .NET SDK 6.0.300 以降で使用可能です。 既定値: false。

razorclasslib

  • --no-restore

    プロジェクトの作成中に暗黙的な復元は実行されません。

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

    このライブラリへのコンポーネントに加え、従来の Razor ページとビューの追加がサポートされます。 .NET Core 3.0 SDK 以降で使用できます。

webapiaot

AOT 発行が有効な Web API プロジェクトを作成します。 詳細については、「ネイティブ AOT デプロイ」と「Web API (ネイティブ AOT) テンプレート」を参照してください。

  • --exclude-launch-settings

    生成されたテンプレートから launchSettings.json が除外されます。

  • -f|--framework <FRAMEWORK>

    ターゲットにするフレームワークが指定されます。

    次の表は、使用する SDK バージョン番号に対応した既定値を示しています。

    SDK バージョン 既定値
    8.0 net8.0

  • --no-restore

    プロジェクトの作成中に暗黙的な復元は実行されません。

  • --use-program-main

    指定した場合、最上位レベルのステートメントの代わりに、明示的な Program クラスと Main メソッドが使用されます。 .NET SDK 6.0.300 以降で使用可能です。 既定値: false。

webapi

  • -au|--auth <AUTHENTICATION_TYPE>

    使う認証の種類。 次の値を指定できます。

    • None - 認証は行われません (既定)。
    • IndividualB2C - Azure AD B2C での個別認証。
    • SingleOrg - 単一のテナントに対する組織認証。 Entra 外部 ID テナントも SingleOrg を使用します。
    • Windows - Windows 認証。

  • --aad-b2c-instance <INSTANCE>

    接続先の Azure Active Directory B2C インスタンス。 IndividualB2C 認証で使用します。 既定値は https://login.microsoftonline.com/tfp/ です。

  • -minimal|--use-minimal-apis

    ASP.NET Core の最小限の API を使用するプロジェクトを作成します。 既定値は false ですが、このオプションは -controllers でオーバーライドされます。 -controllers の既定値は false であるため、どちらのオプションも指定せずに dotnet new webapi を入力すると、最小限の API プロジェクトが作成されます。

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

    このプロジェクト用のサインインおよびサインアップ ポリシー ID です。 IndividualB2C 認証で使用します。

  • --aad-instance <INSTANCE>

    接続先の Azure Active Directory インスタンスです。 SingleOrg 認証で使用します。 既定値は https://login.microsoftonline.com/ です。

  • --client-id <ID>

    このプロジェクトのクライアント ID です。 IndividualB2C 認証または SingleOrg 認証で使用します。 既定値は 11111111-1111-1111-11111111111111111 です。

  • -controllers|--use-controllers

    最小限の API の代わりにコントローラーを使用するかどうか。 このオプションと -minimal の両方を指定した場合、このオプションは -minimal で指定された値をオーバーライドします。 既定値は false です。 .NET 8 SDK 以降で利用可能です。

  • --domain <DOMAIN>

    ディレクトリ テナントのドメインです。 IndividualB2C 認証または SingleOrg 認証で使用します。 既定値は qualified.domain.name です。

  • --tenant-id <ID>

    接続先のディレクトリの TenantId ID です。 SingleOrg 認証で使用します。 既定値は 22222222-2222-2222-2222-222222222222 です。

  • -r|--org-read-access

    このアプリケーションにディレクトリへの読み取りアクセスを許可します。 SingleOrg 認証にのみ適用されます。

  • --exclude-launch-settings

    生成されたテンプレートから launchSettings.json が除外されます。

  • --no-openapi

    OpenAPI (Swagger) のサポートをオフにします。 AddSwaggerGen、UseSwagger、UseSwaggerUI は呼び出されません。

  • --no-https

    HTTPS を無効にします。 https 起動プロファイルは launchSettings.json に作成されません。 app.UseHsts と app.UseHttpsRedirection は Program.cs/Startup.cs では呼び出されません。 このオプションは、IndividualB2C または SingleOrg が認証用に使用されない場合にのみ適用されます。

  • -uld|--use-local-db

    SQLite ではなく LocalDB が使用されるように指定されます。 IndividualB2C 認証にのみ適用されます。

  • -f|--framework <FRAMEWORK>

    ターゲットにするフレームワークが指定されます。 .NET Core 2.2 SDK では使用できません。

    次の表は、使用する SDK バージョン番号に対応した既定値を示しています。

    SDK バージョン 既定値
    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

    使用している SDK よりも前のフレームワークをターゲットにしたプロジェクトを作成するには、この記事で前述したconsole プロジェクト用の --frameworkを参照してください。

  • --no-restore

    プロジェクトの作成中に暗黙的な復元は実行されません。

  • --use-program-main

    指定した場合、最上位レベルのステートメントの代わりに、明示的な Program クラスと Main メソッドが使用されます。 .NET SDK 6.0.300 以降で使用可能です。 既定値: false。

apicontroller

読み取り/書き込みアクションの有無にかかわらず、API コントローラー。

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

    生成するコードの名前空間。 既定値は MyApp.Namespace です。

  • -ac|--actions

    読み取り/書き込みアクションを使用してコントローラーを作成します。 既定値は false です。

globaljson

  • --sdk-version <VERSION_NUMBER>

    global.json ファイル内で使用する .NET SDK のバージョンを指定します。

  • --roll-forward <ROLL_FORWARD_POLICY>

    SDK バージョンを選択するときに、特定の SDK バージョンがない場合のフォールバックとして、またはより新しいバージョンを使用するためのディレクティブとして使用するロールフォワード ポリシー。 詳細については、「 global-json」を参照してください。

editorconfig

コード スタイルの基本設定を構成するための .editorconfig ファイルを作成します。

  • --empty

    .NET の既定値の代わりに、空の .editorconfig を作成します。

関連項目