dotnet newdotnet new

Этот раздел применим к: ✓Пакет SDK для .NET Core 1.xПакет SDK для .NET Core 2.xThis topic applies to: ✓ .NET Core 1.x SDK .NET Core 2.x SDK

nameName

dotnet new — создает проект, файл конфигурации или решений на основе указанного шаблона.dotnet new - Creates a new project, configuration file, or solution based on the specified template.

Краткий обзорSynopsis

.NET Core 2.2..NET Core 2.2

dotnet new <TEMPLATE> [--dry-run] [--force] [-i|--install] [-lang|--language] [-n|--name] [--nuget-source] [-o|--output] [-u|--uninstall] [Template options]
dotnet new <TEMPLATE> [-l|--list] [--type]
dotnet new [-h|--help]
dotnet new <TEMPLATE> [--force] [-i|--install] [-lang|--language] [-n|--name] [--nuget-source] [-o|--output] [-u|--uninstall] [Template options]
dotnet new <TEMPLATE> [-l|--list] [--type]
dotnet new [-h|--help]

ОписаниеDescription

Команда dotnet new предоставляет удобный способ инициализации проекта .NET Core.The dotnet new command provides a convenient way to initialize a valid .NET Core project.

Она вызывает подсистему шаблонов, чтобы создать артефакты на диске на основе заданных параметров и шаблона.The command calls the template engine to create the artifacts on disk based on the specified template and options.

АргументыArguments

TEMPLATE

Шаблон для создания экземпляров при вызове команды.The template to instantiate when the command is invoked. Каждый шаблон может иметь отдельные параметры, доступные для передачи.Each template might have specific options you can pass. Дополнительные сведения см. в разделе Параметры шаблона.For more information, see Template options.

Если значение TEMPLATE не в точности совпадает с текстом в столбце Шаблоны или Короткое имя, для этих двух столбцов выполняется поиск совпадений в подстроках.If the TEMPLATE value isn't an exact match on text in the Templates or Short Name column, a substring match is performed on those two columns.

.NET Core 2.2..NET Core 2.2

Команда содержит список шаблонов по умолчанию.The command contains a default list of templates. Используйте dotnet new -l, чтобы получить список доступных шаблонов.Use dotnet new -l to obtain a list of the available templates. В следующей таблице показаны шаблоны, которые устанавливаются вместе с пакетом SDK для .NET Core 2.2.100.The following table shows the templates that come pre-installed with the .NET Core SDK 2.2.100. Язык по умолчанию для шаблона указан внутри квадратных скобок.The default language for the template is shown inside the brackets.

ШаблоныTemplates Краткое имяShort Name ЯзыкLanguage ТегиTags
Консольное приложениеConsole Application console [C#], F#, VB[C#], F#, VB Общее/консольCommon/Console
Библиотека классовClass library classlib [C#], F#, VB[C#], F#, VB Общее/библиотекаCommon/Library
Проект модульного тестаUnit Test Project mstest [C#], F#, VB[C#], F#, VB Тест/MSTestTest/MSTest
Тестовый проект NUnit 3NUnit 3 Test Project nunit [C#], F#, VB[C#], F#, VB Тест/NUnitTest/NUnit
Элемент теста NUnit 3NUnit 3 Test Item nunit-test [C#], F#, VB[C#], F#, VB Тест/NUnitTest/NUnit
Тестовый проект xUnitxUnit Test Project xunit [C#], F#, VB[C#], F#, VB Тест/xUnitTest/xUnit
Страница RazorRazor Page page [C#][C#] Веб/ASP.NETWeb/ASP.NET
MVC ViewImportsMVC ViewImports viewimports [C#][C#] Веб/ASP.NETWeb/ASP.NET
MVC ViewStartMVC ViewStart viewstart [C#][C#] Веб/ASP.NETWeb/ASP.NET
Пустой ASP.NET CoreASP.NET Core Empty web [C#], F#[C#], F# Веб/пустоWeb/Empty
Веб-приложение ASP.NET Core (Model-View-Controller)ASP.NET Core Web App (Model-View-Controller) mvc [C#], F#[C#], F# Веб/MVCWeb/MVC
Веб-приложение ASP.NET CoreASP.NET Core Web App webapp, razorwebapp, razor [C#][C#] Веб/MVC и Razor PagesWeb/MVC/Razor Pages
ASP.NET Core с AngularASP.NET Core with Angular angular [C#][C#] MVC/Веб/SPAWeb/MVC/SPA
ASP.NET Core с React.jsASP.NET Core with React.js react [C#][C#] MVC/Веб/SPAWeb/MVC/SPA
ASP.NET Core с React.js и ReduxASP.NET Core with React.js and Redux reactredux [C#][C#] MVC/Веб/SPAWeb/MVC/SPA
Библиотека классов RazorRazor Class Library razorclasslib [C#][C#] Веб/Razor/Библиотека/Библиотека классов RazorWeb/Razor/Library/Razor Class Library
Веб-API ASP.NET CoreASP.NET Core Web API webapi [C#], F#[C#], F# Веб/веб-APIWeb/WebAPI
Файл global.jsonglobal.json file globaljson ConfigConfig
Конфигурация NuGetNuGet Config nugetconfig ConfigConfig
Веб-конфигурацияWeb Config webconfig ConfigConfig
Файл решенияSolution File sln РешениеSolution

Команда содержит список шаблонов по умолчанию.The command contains a default list of templates. Используйте dotnet new -l, чтобы получить список доступных шаблонов.Use dotnet new -l to obtain a list of the available templates. В приведенной ниже таблице представлены шаблоны, которые устанавливаются вместе с пакетом SDK для .NET Core 2.1.300.The following table shows the templates that come pre-installed with the .NET Core SDK 2.1.300. Язык по умолчанию для шаблона указан внутри квадратных скобок.The default language for the template is shown inside the brackets.

ШаблоныTemplates Краткое имяShort Name ЯзыкLanguage ТегиTags
Консольное приложениеConsole Application console [C#], F#, VB[C#], F#, VB Общее/консольCommon/Console
Библиотека классовClass library classlib [C#], F#, VB[C#], F#, VB Общее/библиотекаCommon/Library
Проект модульного тестаUnit Test Project mstest [C#], F#, VB[C#], F#, VB Тест/MSTestTest/MSTest
Тестовый проект xUnitxUnit Test Project xunit [C#], F#, VB[C#], F#, VB Тест/xUnitTest/xUnit
Страница RazorRazor Page page [C#][C#] Веб/ASP.NETWeb/ASP.NET
MVC ViewImportsMVC ViewImports viewimports [C#][C#] Веб/ASP.NETWeb/ASP.NET
MVC ViewStartMVC ViewStart viewstart [C#][C#] Веб/ASP.NETWeb/ASP.NET
Пустой ASP.NET CoreASP.NET Core Empty web [C#], F#[C#], F# Веб/пустоWeb/Empty
Веб-приложение ASP.NET Core (Model-View-Controller)ASP.NET Core Web App (Model-View-Controller) mvc [C#], F#[C#], F# Веб/MVCWeb/MVC
Веб-приложение ASP.NET CoreASP.NET Core Web App razor [C#][C#] Веб/MVC и Razor PagesWeb/MVC/Razor Pages
ASP.NET Core с AngularASP.NET Core with Angular angular [C#][C#] MVC/Веб/SPAWeb/MVC/SPA
ASP.NET Core с React.jsASP.NET Core with React.js react [C#][C#] MVC/Веб/SPAWeb/MVC/SPA
ASP.NET Core с React.js и ReduxASP.NET Core with React.js and Redux reactredux [C#][C#] MVC/Веб/SPAWeb/MVC/SPA
Библиотека классов RazorRazor Class Library razorclasslib [C#][C#] Веб/Razor/Библиотека/Библиотека классов RazorWeb/Razor/Library/Razor Class Library
Веб-API ASP.NET CoreASP.NET Core Web API webapi [C#], F#[C#], F# Веб/веб-APIWeb/WebAPI
Файл global.jsonglobal.json file globaljson ConfigConfig
Конфигурация NuGetNuGet Config nugetconfig ConfigConfig
Веб-конфигурацияWeb Config webconfig ConfigConfig
Файл решенияSolution File sln РешениеSolution

ПараметрыOptions

.NET Core 2.2..NET Core 2.2

--dry-run

Отображает сводку того, что произойдет, если выполнить команду и это приведет к созданию шаблона.Displays a summary of what would happen if the given command were run if it would result in a template creation.

--force

Принудительное создание содержимого, даже если при этом изменяются существующие файлы.Forces content to be generated even if it would change existing files. Это требуется, когда выходной каталог уже содержит проект.This is required when the output directory already contains a project.

-h|--help

Распечатывает справку для команды.Prints out help for the command. Его можно вызвать для самой команды dotnet new или для любого шаблона, например dotnet new mvc --help.It can be invoked for the dotnet new command itself or for any template, such as dotnet new mvc --help.

-i|--install <PATH|NUGET_ID>

Устанавливает исходный пакет или пакет шаблона из указанного пути PATH или по указанному идентификатору NUGET_ID.Installs a source or template pack from the PATH or NUGET_ID provided. Если вы хотите установить предварительную версию пакета шаблонов, необходимо указать версию в формате <package-name>::<package-version>.If you want to install a prerelease version of a template package, you need to specify the version in the format of <package-name>::<package-version>. По умолчанию dotnet new передает * для версии, что указывает на последнюю стабильную версию пакета.By default, dotnet new passes * for the version, which represents the last stable package version. См. пример в разделе Примеры.See an example at the Examples section.

Сведения о создании пользовательских шаблонов см. в статье Пользовательские шаблоны для команды dotnet new.For information on creating custom templates, see Custom templates for dotnet new.

-l|--list

Перечисляет шаблоны с указанным именем.Lists templates containing the specified name. При вызове для команды dotnet new перечисляет возможные шаблоны, доступные для заданного каталога.If invoked for the dotnet new command, it lists the possible templates available for the given directory. Например, если каталог уже содержит проект, он не будет перечислять все шаблоны проекта.For example if the directory already contains a project, it doesn't list all project templates.

-lang|--language {C#|F#|VB}

Язык создаваемого шаблона.The language of the template to create. Допустимый язык зависит от шаблона (см. значения по умолчанию в разделе об аргументах).The language accepted varies by the template (see defaults in the arguments section). Не является допустимым для некоторых шаблонов.Not valid for some templates.

Примечание

Некоторые оболочки интерпретируют # как специальный символ.Some shells interpret # as a special character. В таких случаях необходимо заключить значение параметра языка в символы, например dotnet new console -lang "F#".In those cases, you need to enclose the language parameter value, such as dotnet new console -lang "F#".

-n|--name <OUTPUT_NAME>

Имя создаваемых выходных данных.The name for the created output. Если имя не указано, используется имя текущего каталога.If no name is specified, the name of the current directory is used.

--nuget-source

Задает источник пакетов NuGet для использования во время установки.Specifies a NuGet source to use during install.

-o|--output <OUTPUT_DIRECTORY>

Расположение, в котором размещаются созданные выходные данные.Location to place the generated output. Значением по умолчанию является текущий каталог.The default is the current directory.

--type

Фильтрует шаблоны по доступным типам.Filters templates based on available types. Предопределенные значения: "project", "item" или "other".Predefined values are "project", "item", or "other".

-u|--uninstall <PATH|NUGET_ID>

Удаляет исходный пакет или пакет шаблона по указанному пути PATH или идентификатору NUGET_ID.Uninstalls a source or template pack at the PATH or NUGET_ID provided. При исключении значения <PATH|NUGET_ID> отображаются все установленные пакеты шаблонов и связанные с ними шаблоны.When excluding the <PATH|NUGET_ID> value, all currently installed template packs and their associated templates are displayed.

Примечание

Чтобы удалить шаблон с помощью PATH, вам необходимо указать полный путь.To uninstall a template using a PATH, you need to fully qualify the path. Например, C:/Users/<ПОЛЬЗОВАТЕЛЬ>/Documents/Templates/GarciaSoftware.ConsoleTemplate.CSharp будет работать, а ./GarciaSoftware.ConsoleTemplate.CSharp — нет.For example, C:/Users/<USER>/Documents/Templates/GarciaSoftware.ConsoleTemplate.CSharp will work, but ./GarciaSoftware.ConsoleTemplate.CSharp from the containing folder will not. Кроме того, путь к шаблону не должен содержать конечную косую черту закрытия каталога.Additionally, do not include a final terminating directory slash on your template path.

--force

Принудительное создание содержимого, даже если при этом изменяются существующие файлы.Forces content to be generated even if it would change existing files. Это требуется, когда выходной каталог уже содержит проект.This is required when the output directory already contains a project.

-h|--help

Распечатывает справку для команды.Prints out help for the command. Его можно вызвать для самой команды dotnet new или для любого шаблона, например dotnet new mvc --help.It can be invoked for the dotnet new command itself or for any template, such as dotnet new mvc --help.

-i|--install <PATH|NUGET_ID>

Устанавливает исходный пакет или пакет шаблона из указанного пути PATH или по указанному идентификатору NUGET_ID.Installs a source or template pack from the PATH or NUGET_ID provided. Если вы хотите установить предварительную версию пакета шаблонов, необходимо указать версию в формате <package-name>::<package-version>.If you want to install a prerelease version of a template package, you need to specify the version in the format of <package-name>::<package-version>. По умолчанию dotnet new передает * для версии, что указывает на последнюю стабильную версию пакета.By default, dotnet new passes * for the version, which represents the last stable package version. См. пример в разделе Примеры.See an example at the Examples section.

Сведения о создании пользовательских шаблонов см. в статье Пользовательские шаблоны для команды dotnet new.For information on creating custom templates, see Custom templates for dotnet new.

-l|--list

Перечисляет шаблоны с указанным именем.Lists templates containing the specified name. При вызове для команды dotnet new перечисляет возможные шаблоны, доступные для заданного каталога.If invoked for the dotnet new command, it lists the possible templates available for the given directory. Например, если каталог уже содержит проект, он не будет перечислять все шаблоны проекта.For example if the directory already contains a project, it doesn't list all project templates.

-lang|--language {C#|F#|VB}

Язык создаваемого шаблона.The language of the template to create. Допустимый язык зависит от шаблона (см. значения по умолчанию в разделе об аргументах).The language accepted varies by the template (see defaults in the arguments section). Не является допустимым для некоторых шаблонов.Not valid for some templates.

Примечание

Некоторые оболочки интерпретируют # как специальный символ.Some shells interpret # as a special character. В таких случаях необходимо заключить значение параметра языка в символы, например dotnet new console -lang "F#".In those cases, you need to enclose the language parameter value, such as dotnet new console -lang "F#".

-n|--name <OUTPUT_NAME>

Имя создаваемых выходных данных.The name for the created output. Если имя не указано, используется имя текущего каталога.If no name is specified, the name of the current directory is used.

--nuget-source

Задает источник пакетов NuGet для использования во время установки.Specifies a NuGet source to use during install.

-o|--output <OUTPUT_DIRECTORY>

Расположение, в котором размещаются созданные выходные данные.Location to place the generated output. Значением по умолчанию является текущий каталог.The default is the current directory.

--type

Фильтрует шаблоны по доступным типам.Filters templates based on available types. Предварительно определенные значения: project, item и other.Predefined values are "project", "item" or "other".

-u|--uninstall <PATH|NUGET_ID>

Удаляет исходный пакет или пакет шаблона по указанному пути PATH или идентификатору NUGET_ID.Uninstalls a source or template pack at the PATH or NUGET_ID provided.

Примечание

Чтобы удалить шаблон с помощью PATH, вам необходимо указать полный путь.To uninstall a template using a PATH, you need to fully qualify the path. Например, C:/Users/<ПОЛЬЗОВАТЕЛЬ>/Documents/Templates/GarciaSoftware.ConsoleTemplate.CSharp будет работать, а ./GarciaSoftware.ConsoleTemplate.CSharp — нет.For example, C:/Users/<USER>/Documents/Templates/GarciaSoftware.ConsoleTemplate.CSharp will work, but ./GarciaSoftware.ConsoleTemplate.CSharp from the containing folder will not. Кроме того, путь к шаблону не должен содержать конечную косую черту закрытия каталога.Additionally, do not include a final terminating directory slash on your template path.

Параметры шаблонаTemplate options

Каждый шаблон проекта может содержать дополнительные доступные параметры.Each project template may have additional options available. Основные шаблоны имеют следующие дополнительные параметры:The core templates have the following additional options:

.NET Core 2.2..NET Core 2.2

Консольconsole

--langVersion <VERSION_NUMBER> — задает свойство LangVersion в созданном файле проекта.--langVersion <VERSION_NUMBER> - Sets the LangVersion property in the created project file. Например, вам требуется --langVersion 7.3, чтобы использовать C# 7.3.For example, use --langVersion 7.3 to use C# 7.3. Не поддерживается для F#.Not supported for F#.

--no-restore — во время создания проекта не выполняется неявное восстановление.--no-restore - Doesn't execute an implicit restore during project creation.

angular, react, reactreduxangular, react, reactredux

--exclude-launch-settings — исключает файл launchSettings.json из создаваемого шаблона.--exclude-launch-settings - Exclude launchSettings.json from the generated template.

--no-restore — во время создания проекта не выполняется неявное восстановление.--no-restore - Doesn't execute an implicit restore during project creation.

--no-https — проекту не требуется HTTPS.--no-https - Project doesn't require HTTPS. Этот параметр применяется, только если IndividualAuth или OrganizationalAuth не используются.This option only applies if IndividualAuth or OrganizationalAuth are not being used.

razorclasslibrazorclasslib

--no-restore — во время создания проекта не выполняется неявное восстановление.--no-restore - Doesn't execute an implicit restore during project creation.

classlibclasslib

-f|--framework <FRAMEWORK> — указывает целевую платформу.-f|--framework <FRAMEWORK> - Specifies the framework to target. Значения: netcoreapp2.2 для создания библиотеки классов .NET Core или netstandard2.0 для создания стандартной библиотеки классов .NET.Values: netcoreapp2.2 to create a .NET Core Class Library or netstandard2.0 to create a .NET Standard Class Library. Значение по умолчанию — netstandard2.0.The default value is netstandard2.0.

--langVersion <VERSION_NUMBER> — задает свойство LangVersion в созданном файле проекта.--langVersion <VERSION_NUMBER> - Sets the LangVersion property in the created project file. Например, вам требуется --langVersion 7.3, чтобы использовать C# 7.3.For example, use --langVersion 7.3 to use C# 7.3. Не поддерживается для F#.Not supported for F#.

--no-restore — во время создания проекта не выполняется неявное восстановление.--no-restore - Doesn't execute an implicit restore during project creation.

mstest, xunitmstest, xunit

-p|--enable-pack — включает упаковку проекта с помощью команды dotnet pack.-p|--enable-pack - Enables packaging for the project using dotnet pack.

--no-restore — во время создания проекта не выполняется неявное восстановление.--no-restore - Doesn't execute an implicit restore during project creation.

nunitnunit

-f|--framework <FRAMEWORK> — указывает целевую платформу.-f|--framework <FRAMEWORK> - Specifies the framework to target. Значение по умолчанию — netcoreapp2.1.The default value is netcoreapp2.1.

-p|--enable-pack — включает упаковку проекта с помощью команды dotnet pack.-p|--enable-pack - Enables packaging for the project using dotnet pack.

--no-restore — во время создания проекта не выполняется неявное восстановление.--no-restore - Doesn't execute an implicit restore during project creation.

pagepage

-na|--namespace <NAMESPACE_NAME> — пространство имен для сформированного кода.-na|--namespace <NAMESPACE_NAME> - Namespace for the generated code. Значение по умолчанию — MyApp.Namespace.The default value is MyApp.Namespace.

-np|--no-pagemodel — создает страницу без PageModel.-np|--no-pagemodel - Creates the page without a PageModel.

viewimportsviewimports

-na|--namespace <NAMESPACE_NAME> — пространство имен для сформированного кода.-na|--namespace <NAMESPACE_NAME> - Namespace for the generated code. Значение по умолчанию — MyApp.Namespace.The default value is MyApp.Namespace.

webweb

--exclude-launch-settings — исключает файл launchSettings.json из создаваемого шаблона.--exclude-launch-settings - Exclude launchSettings.json from the generated template.

--no-restore — во время создания проекта не выполняется неявное восстановление.--no-restore - Doesn't execute an implicit restore during project creation.

--no-https — проекту не требуется HTTPS.--no-https - Project doesn't require HTTPS. Этот параметр применяется, только если IndividualAuth или OrganizationalAuth не используются.This option only applies if IndividualAuth or OrganizationalAuth are not being used.

mvc, webappmvc, webapp

-au|--auth <AUTHENTICATION_TYPE> — тип проверки подлинности.-au|--auth <AUTHENTICATION_TYPE> - The type of authentication to use. Допустимые значения:The possible values are:

  • None — без проверки подлинности (по умолчанию).None - No authentication (Default).
  • Individual — индивидуальная проверка подлинности.Individual - Individual authentication.
  • IndividualB2C — индивидуальная проверка подлинности с помощью Azure AD B2C.IndividualB2C - Individual authentication with Azure AD B2C.
  • SingleOrg — проверка подлинности организации для отдельного клиента.SingleOrg - Organizational authentication for a single tenant.
  • MultiOrg — проверка подлинности организации для нескольких клиентов.MultiOrg - Organizational authentication for multiple tenants.
  • Windows — проверка подлинности Windows.Windows - Windows authentication.

--aad-b2c-instance <INSTANCE> — экземпляр Azure Active Directory B2C, к которому выполняется подключение.--aad-b2c-instance <INSTANCE> - The Azure Active Directory B2C instance to connect to. Используется с проверкой подлинности IndividualB2C.Use with IndividualB2C authentication. Значение по умолчанию — https://login.microsoftonline.com/tfp/.The default value is https://login.microsoftonline.com/tfp/.

-ssp|--susi-policy-id <ID> — идентификатор политики входа и регистрации для этого проекта.-ssp|--susi-policy-id <ID> - The sign-in and sign-up policy ID for this project. Используется с проверкой подлинности IndividualB2C.Use with IndividualB2C authentication.

-rp|--reset-password-policy-id <ID> — идентификатор политики сброса паролей для этого проекта.-rp|--reset-password-policy-id <ID> - The reset password policy ID for this project. Используется с проверкой подлинности IndividualB2C.Use with IndividualB2C authentication.

-ep|--edit-profile-policy-id <ID> — идентификатор политики изменения профилей для этого проекта.-ep|--edit-profile-policy-id <ID> - The edit profile policy ID for this project. Используется с проверкой подлинности IndividualB2C.Use with IndividualB2C authentication.

--aad-instance <INSTANCE> — экземпляр Azure Active Directory, к которому выполняется подключение.--aad-instance <INSTANCE> - The Azure Active Directory instance to connect to. Используется с проверкой подлинности SingleOrg или MultiOrg.Use with SingleOrg or MultiOrg authentication. Значение по умолчанию — https://login.microsoftonline.com/.The default value is https://login.microsoftonline.com/.

--client-id <ID> — идентификатор клиента для этого проекта.--client-id <ID> - The Client ID for this project. Используется с проверкой подлинности IndividualB2C, SingleOrg или MultiOrg.Use with IndividualB2C, SingleOrg, or MultiOrg authentication. Значение по умолчанию — 11111111-1111-1111-11111111111111111.The default value is 11111111-1111-1111-11111111111111111.

--domain <DOMAIN> — домен клиента каталога.--domain <DOMAIN> - The domain for the directory tenant. Используется с проверкой подлинности SingleOrg или IndividualB2C.Use with SingleOrg or IndividualB2C authentication. Значение по умолчанию — qualified.domain.name.The default value is qualified.domain.name.

--tenant-id <ID> — идентификатор TenantId каталога, к которому устанавливается подключение.--tenant-id <ID> - The TenantId ID of the directory to connect to. Используется с проверкой подлинности SingleOrg.Use with SingleOrg authentication. Значение по умолчанию — 22222222-2222-2222-2222-222222222222.The default value is 22222222-2222-2222-2222-222222222222.

--callback-path <PATH> — путь запроса по базовому пути кода URI перенаправления для приложения.--callback-path <PATH> - The request path within the application's base path of the redirect URI. Используется с проверкой подлинности SingleOrg или IndividualB2C.Use with SingleOrg or IndividualB2C authentication. Значение по умолчанию — /signin-oidc.The default value is /signin-oidc.

-r|--org-read-access — предоставляет приложению доступ к каталогу для чтения.-r|--org-read-access - Allows this application read-access to the directory. Применяется только при проверке подлинности SingleOrg или MultiOrg.Only applies to SingleOrg or MultiOrg authentication.

--exclude-launch-settings — исключает файл launchSettings.json из создаваемого шаблона.--exclude-launch-settings - Exclude launchSettings.json from the generated template.

--no-https — проекту не требуется HTTPS.--no-https - Project doesn't require HTTPS. app.UseHsts и app.UseHttpsRedirection не добавляются к Startup.Configure.app.UseHsts and app.UseHttpsRedirection aren't added to Startup.Configure. Этот параметр применяется, только если Individual, IndividualB2C, SingleOrg или MultiOrg не используются.This option only applies if Individual, IndividualB2C, SingleOrg, or MultiOrg aren't being used.

-uld|--use-local-db — указывает, что вместо SQLite следует использовать LocalDB.-uld|--use-local-db - Specifies LocalDB should be used instead of SQLite. Применяется только при проверке подлинности Individual или IndividualB2C.Only applies to Individual or IndividualB2C authentication.

--no-restore — во время создания проекта не выполняется неявное восстановление.--no-restore - Doesn't execute an implicit restore during project creation.

webapiwebapi

-au|--auth <AUTHENTICATION_TYPE> — тип проверки подлинности.-au|--auth <AUTHENTICATION_TYPE> - The type of authentication to use. Допустимые значения:The possible values are:

  • None — без проверки подлинности (по умолчанию).None - No authentication (Default).
  • IndividualB2C — индивидуальная проверка подлинности с помощью Azure AD B2C.IndividualB2C - Individual authentication with Azure AD B2C.
  • SingleOrg — проверка подлинности организации для отдельного клиента.SingleOrg - Organizational authentication for a single tenant.
  • Windows — проверка подлинности Windows.Windows - Windows authentication.

--aad-b2c-instance <INSTANCE> — экземпляр Azure Active Directory B2C, к которому выполняется подключение.--aad-b2c-instance <INSTANCE> - The Azure Active Directory B2C instance to connect to. Используется с проверкой подлинности IndividualB2C.Use with IndividualB2C authentication. Значение по умолчанию — https://login.microsoftonline.com/tfp/.The default value is https://login.microsoftonline.com/tfp/.

-ssp|--susi-policy-id <ID> — идентификатор политики входа и регистрации для этого проекта.-ssp|--susi-policy-id <ID> - The sign-in and sign-up policy ID for this project. Используется с проверкой подлинности IndividualB2C.Use with IndividualB2C authentication.

--aad-instance <INSTANCE> — экземпляр Azure Active Directory, к которому выполняется подключение.--aad-instance <INSTANCE> - The Azure Active Directory instance to connect to. Используется с проверкой подлинности SingleOrg.Use with SingleOrg authentication. Значение по умолчанию — https://login.microsoftonline.com/.The default value is https://login.microsoftonline.com/.

--client-id <ID> — идентификатор клиента для этого проекта.--client-id <ID> - The Client ID for this project. Используется с проверкой подлинности IndividualB2C или SingleOrg.Use with IndividualB2C or SingleOrg authentication. Значение по умолчанию — 11111111-1111-1111-11111111111111111.The default value is 11111111-1111-1111-11111111111111111.

--domain <DOMAIN> — домен клиента каталога.--domain <DOMAIN> - The domain for the directory tenant. Используется с проверкой подлинности SingleOrg или IndividualB2C.Use with SingleOrg or IndividualB2C authentication. Значение по умолчанию — qualified.domain.name.The default value is qualified.domain.name.

--tenant-id <ID> — идентификатор TenantId каталога, к которому устанавливается подключение.--tenant-id <ID> - The TenantId ID of the directory to connect to. Используется с проверкой подлинности SingleOrg.Use with SingleOrg authentication. Значение по умолчанию — 22222222-2222-2222-2222-222222222222.The default value is 22222222-2222-2222-2222-222222222222.

-r|--org-read-access — предоставляет приложению доступ к каталогу для чтения.-r|--org-read-access - Allows this application read-access to the directory. Применяется только при проверке подлинности SingleOrg или MultiOrg.Only applies to SingleOrg or MultiOrg authentication.

--exclude-launch-settings — исключает файл launchSettings.json из создаваемого шаблона.--exclude-launch-settings - Exclude launchSettings.json from the generated template.

--no-https — проекту не требуется HTTPS.--no-https - Project doesn't require HTTPS. app.UseHsts и app.UseHttpsRedirection не добавляются к Startup.Configure.app.UseHsts and app.UseHttpsRedirection aren't added to Startup.Configure. Этот параметр применяется, только если Individual, IndividualB2C, SingleOrg или MultiOrg не используются.This option only applies if Individual, IndividualB2C, SingleOrg, or MultiOrg aren't being used.

-uld|--use-local-db — указывает, что вместо SQLite следует использовать LocalDB.-uld|--use-local-db - Specifies LocalDB should be used instead of SQLite. Применяется только при проверке подлинности Individual или IndividualB2C.Only applies to Individual or IndividualB2C authentication.

--no-restore — во время создания проекта не выполняется неявное восстановление.--no-restore - Doesn't execute an implicit restore during project creation.

globaljsonglobaljson

--sdk-version <VERSION_NUMBER> — задает версию пакета SDK для .NET Core, используемую в файле global.json.--sdk-version <VERSION_NUMBER> - Specifies the version of the .NET Core SDK to use in the global.json file.

console, angular, react, reactredux, razorclasslibconsole, angular, react, reactredux, razorclasslib

--no-restore — во время создания проекта не выполняется неявное восстановление.--no-restore - Doesn't execute an implicit restore during project creation.

classlibclasslib

-f|--framework <FRAMEWORK> — указывает целевую платформу.-f|--framework <FRAMEWORK> - Specifies the framework to target. Значения: netcoreapp2.1 для создания библиотеки классов .NET Core или netstandard2.0 для создания стандартной библиотеки классов .NET.Values: netcoreapp2.1 to create a .NET Core Class Library or netstandard2.0 to create a .NET Standard Class Library. Значение по умолчанию — netstandard2.0.The default value is netstandard2.0.

--no-restore — во время создания проекта не выполняется неявное восстановление.--no-restore - Doesn't execute an implicit restore during project creation.

mstest, xunitmstest, xunit

-p|--enable-pack — включает упаковку проекта с помощью команды dotnet pack.-p|--enable-pack - Enables packaging for the project using dotnet pack.

--no-restore — во время создания проекта не выполняется неявное восстановление.--no-restore - Doesn't execute an implicit restore during project creation.

globaljsonglobaljson

--sdk-version <VERSION_NUMBER> — задает версию пакета SDK для .NET Core, используемую в файле global.json.--sdk-version <VERSION_NUMBER> - Specifies the version of the .NET Core SDK to use in the global.json file.

webweb

--exclude-launch-settings — исключает файл launchSettings.json из создаваемого шаблона.--exclude-launch-settings - Exclude launchSettings.json from the generated template.

--no-restore — во время создания проекта не выполняется неявное восстановление.--no-restore - Doesn't execute an implicit restore during project creation.

--no-https — проекту не требуется HTTPS.--no-https - Project doesn't require HTTPS. Этот параметр применяется, только если IndividualAuth или OrganizationalAuth не используются.This option only applies if IndividualAuth or OrganizationalAuth are not being used.

webapiwebapi

-au|--auth <AUTHENTICATION_TYPE> — тип проверки подлинности.-au|--auth <AUTHENTICATION_TYPE> - The type of authentication to use. Допустимые значения:The possible values are:

  • None — без проверки подлинности (по умолчанию).None - No authentication (Default).
  • IndividualB2C — индивидуальная проверка подлинности с помощью Azure AD B2C.IndividualB2C - Individual authentication with Azure AD B2C.
  • SingleOrg — проверка подлинности организации для отдельного клиента.SingleOrg - Organizational authentication for a single tenant.
  • Windows — проверка подлинности Windows.Windows - Windows authentication.

--aad-b2c-instance <INSTANCE> — экземпляр Azure Active Directory B2C, к которому выполняется подключение.--aad-b2c-instance <INSTANCE> - The Azure Active Directory B2C instance to connect to. Используется с проверкой подлинности IndividualB2C.Use with IndividualB2C authentication. Значение по умолчанию — https://login.microsoftonline.com/tfp/.The default value is https://login.microsoftonline.com/tfp/.

-ssp|--susi-policy-id <ID> — идентификатор политики входа и регистрации для этого проекта.-ssp|--susi-policy-id <ID> - The sign-in and sign-up policy ID for this project. Используется с проверкой подлинности IndividualB2C.Use with IndividualB2C authentication.

--aad-instance <INSTANCE> — экземпляр Azure Active Directory, к которому выполняется подключение.--aad-instance <INSTANCE> - The Azure Active Directory instance to connect to. Используется с проверкой подлинности SingleOrg.Use with SingleOrg authentication. Значение по умолчанию — https://login.microsoftonline.com/.The default value is https://login.microsoftonline.com/.

--client-id <ID> — идентификатор клиента для этого проекта.--client-id <ID> - The Client ID for this project. Используется с проверкой подлинности IndividualB2C или SingleOrg.Use with IndividualB2C or SingleOrg authentication. Значение по умолчанию — 11111111-1111-1111-11111111111111111.The default value is 11111111-1111-1111-11111111111111111.

--domain <DOMAIN> — домен клиента каталога.--domain <DOMAIN> - The domain for the directory tenant. Используется с проверкой подлинности SingleOrg или IndividualB2C.Use with SingleOrg or IndividualB2C authentication. Значение по умолчанию — qualified.domain.name.The default value is qualified.domain.name.

--tenant-id <ID> — идентификатор TenantId каталога, к которому устанавливается подключение.--tenant-id <ID> - The TenantId ID of the directory to connect to. Используется с проверкой подлинности SingleOrg.Use with SingleOrg authentication. Значение по умолчанию — 22222222-2222-2222-2222-222222222222.The default value is 22222222-2222-2222-2222-222222222222.

-r|--org-read-access — предоставляет приложению доступ к каталогу для чтения.-r|--org-read-access - Allows this application read-access to the directory. Применяется только при проверке подлинности SingleOrg или MultiOrg.Only applies to SingleOrg or MultiOrg authentication.

--exclude-launch-settings — исключает файл launchSettings.json из создаваемого шаблона.--exclude-launch-settings - Exclude launchSettings.json from the generated template.

-uld|--use-local-db — указывает, что вместо SQLite следует использовать LocalDB.-uld|--use-local-db - Specifies LocalDB should be used instead of SQLite. Применяется только при проверке подлинности Individual или IndividualB2C.Only applies to Individual or IndividualB2C authentication.

--no-restore — во время создания проекта не выполняется неявное восстановление.--no-restore - Doesn't execute an implicit restore during project creation.

--no-https — проекту не требуется HTTPS.--no-https - Project doesn't require HTTPS. app.UseHsts и app.UseHttpsRedirection не добавляются к Startup.Configure.app.UseHsts and app.UseHttpsRedirection aren't added to Startup.Configure. Этот параметр применяется, только если Individual, IndividualB2C, SingleOrg или MultiOrg не используются.This option only applies if Individual, IndividualB2C, SingleOrg, or MultiOrg aren't being used.

mvc, razormvc, razor

-au|--auth <AUTHENTICATION_TYPE> — тип проверки подлинности.-au|--auth <AUTHENTICATION_TYPE> - The type of authentication to use. Допустимые значения:The possible values are:

  • None — без проверки подлинности (по умолчанию).None - No authentication (Default).
  • Individual — индивидуальная проверка подлинности.Individual - Individual authentication.
  • IndividualB2C — индивидуальная проверка подлинности с помощью Azure AD B2C.IndividualB2C - Individual authentication with Azure AD B2C.
  • SingleOrg — проверка подлинности организации для отдельного клиента.SingleOrg - Organizational authentication for a single tenant.
  • MultiOrg — проверка подлинности организации для нескольких клиентов.MultiOrg - Organizational authentication for multiple tenants.
  • Windows — проверка подлинности Windows.Windows - Windows authentication.

--aad-b2c-instance <INSTANCE> — экземпляр Azure Active Directory B2C, к которому выполняется подключение.--aad-b2c-instance <INSTANCE> - The Azure Active Directory B2C instance to connect to. Используется с проверкой подлинности IndividualB2C.Use with IndividualB2C authentication. Значение по умолчанию — https://login.microsoftonline.com/tfp/.The default value is https://login.microsoftonline.com/tfp/.

-ssp|--susi-policy-id <ID> — идентификатор политики входа и регистрации для этого проекта.-ssp|--susi-policy-id <ID> - The sign-in and sign-up policy ID for this project. Используется с проверкой подлинности IndividualB2C.Use with IndividualB2C authentication.

-rp|--reset-password-policy-id <ID> — идентификатор политики сброса паролей для этого проекта.-rp|--reset-password-policy-id <ID> - The reset password policy ID for this project. Используется с проверкой подлинности IndividualB2C.Use with IndividualB2C authentication.

-ep|--edit-profile-policy-id <ID> — идентификатор политики изменения профилей для этого проекта.-ep|--edit-profile-policy-id <ID> - The edit profile policy ID for this project. Используется с проверкой подлинности IndividualB2C.Use with IndividualB2C authentication.

--aad-instance <INSTANCE> — экземпляр Azure Active Directory, к которому выполняется подключение.--aad-instance <INSTANCE> - The Azure Active Directory instance to connect to. Используется с проверкой подлинности SingleOrg или MultiOrg.Use with SingleOrg or MultiOrg authentication. Значение по умолчанию — https://login.microsoftonline.com/.The default value is https://login.microsoftonline.com/.

--client-id <ID> — идентификатор клиента для этого проекта.--client-id <ID> - The Client ID for this project. Используется с проверкой подлинности IndividualB2C, SingleOrg или MultiOrg.Use with IndividualB2C, SingleOrg, or MultiOrg authentication. Значение по умолчанию — 11111111-1111-1111-11111111111111111.The default value is 11111111-1111-1111-11111111111111111.

--domain <DOMAIN> — домен клиента каталога.--domain <DOMAIN> - The domain for the directory tenant. Используется с проверкой подлинности SingleOrg или IndividualB2C.Use with SingleOrg or IndividualB2C authentication. Значение по умолчанию — qualified.domain.name.The default value is qualified.domain.name.

--tenant-id <ID> — идентификатор TenantId каталога, к которому устанавливается подключение.--tenant-id <ID> - The TenantId ID of the directory to connect to. Используется с проверкой подлинности SingleOrg.Use with SingleOrg authentication. Значение по умолчанию — 22222222-2222-2222-2222-222222222222.The default value is 22222222-2222-2222-2222-222222222222.

--callback-path <PATH> — путь запроса по базовому пути кода URI перенаправления для приложения.--callback-path <PATH> - The request path within the application's base path of the redirect URI. Используется с проверкой подлинности SingleOrg или IndividualB2C.Use with SingleOrg or IndividualB2C authentication. Значение по умолчанию — /signin-oidc.The default value is /signin-oidc.

-r|--org-read-access — предоставляет приложению доступ к каталогу для чтения.-r|--org-read-access - Allows this application read-access to the directory. Применяется только при проверке подлинности SingleOrg или MultiOrg.Only applies to SingleOrg or MultiOrg authentication.

--exclude-launch-settings — исключает файл launchSettings.json из создаваемого шаблона.--exclude-launch-settings - Exclude launchSettings.json from the generated template.

--use-browserlink — включает BrowserLink в проект.--use-browserlink - Includes BrowserLink in the project.

-uld|--use-local-db — указывает, что вместо SQLite следует использовать LocalDB.-uld|--use-local-db - Specifies LocalDB should be used instead of SQLite. Применяется только при проверке подлинности Individual или IndividualB2C.Only applies to Individual or IndividualB2C authentication.

--no-restore — во время создания проекта не выполняется неявное восстановление.--no-restore - Doesn't execute an implicit restore during project creation.

--no-https — проекту не требуется HTTPS.--no-https - Project doesn't require HTTPS. app.UseHsts и app.UseHttpsRedirection не добавляются к Startup.Configure.app.UseHsts and app.UseHttpsRedirection aren't added to Startup.Configure. Этот параметр применяется, только если Individual, IndividualB2C, SingleOrg или MultiOrg не используются.This option only applies if Individual, IndividualB2C, SingleOrg, or MultiOrg aren't being used.

pagepage

-na|--namespace <NAMESPACE_NAME> — пространство имен для сформированного кода.-na|--namespace <NAMESPACE_NAME> - Namespace for the generated code. Значение по умолчанию — MyApp.Namespace.The default value is MyApp.Namespace.

-np|--no-pagemodel — создает страницу без PageModel.-np|--no-pagemodel - Creates the page without a PageModel.

viewimportsviewimports

-na|--namespace <NAMESPACE_NAME> — пространство имен для сформированного кода.-na|--namespace <NAMESPACE_NAME> - Namespace for the generated code. Значение по умолчанию — MyApp.Namespace.The default value is MyApp.Namespace.

ПримерыExamples

Создайте проект консольного приложения на C#, указав имя шаблона:Create a C# console application project by specifying the template name:

dotnet new "Console Application"

Создание проекта консольного приложения F# в текущем каталоге:Create an F# console application project in the current directory:

dotnet new console -lang F#

Создание проекта библиотеки классов .NET Standard в указанном каталоге (доступно только при использовании пакета SDK для .NET Core 2.0 или более поздней версии):Create a .NET Standard class library project in the specified directory (available only with .NET Core SDK 2.0 or later versions):

dotnet new classlib -lang VB -o MyLibrary

Создайте новый проект MVC ASP.NET Core C# в текущем каталоге без проверки подлинности:Create a new ASP.NET Core C# MVC project in the current directory with no authentication:

dotnet new mvc -au None

Создайте новый проект xUnit:Create a new xUnit project:

dotnet new xunit

Перечислите все шаблоны, доступные для MVC:List all templates available for MVC:

dotnet new mvc -l

Список всех шаблонов, соответствующих подстроке we.List all templates matching the we substring. Точное совпадение не найдено, поэтому сравнение подстрок выполняется по короткому имени и столбцам имен.No exact match is found, so substring matching runs against both the short name and name columns.

dotnet new we -l

Попытайтесь вызвать шаблон, соответствующий ng.Attempt to invoke the template matching ng. Если точное совпадение не найдено, выведите шаблоны с частичным совпадением.If a single match can't be determined, list the templates that are partial matches.

dotnet new ng

Установите версию 2.0 шаблонов одностраничного приложения для ASP.NET Core (параметр команды доступен в .NET Core SDK 1.1 и более поздних версиях):Install version 2.0 of the Single Page Application templates for ASP.NET Core (command option available for .NET Core SDK 1.1 and later versions only):

dotnet new -i Microsoft.DotNet.Web.Spa.ProjectTemplates::2.0.0

Создайте global.json в текущем каталоге, указав версию пакета SDK 2.0.0 (доступно только для пакета SDK для .NET Core 2.0 или более поздней версии):Create a global.json in the current directory setting the SDK version to 2.0.0 (available only with .NET Core SDK 2.0 or later versions):

dotnet new globaljson --sdk-version 2.0.0

См. такжеSee also