Команда dotnetdotnet command

Этот раздел применим к: ✓Пакет 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 — средство для управления исходным кодом .NET и двоичными объектами.dotnet - A tool for managing .NET source code and binaries.

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

dotnet [command] [arguments] [--additional-deps] [--additionalprobingpath] [-d|--diagnostics] [--fx-version]
    [-h|--help] [--info] [--list-runtimes] [--list-sdks] [--roll-forward-on-no-candidate-fx] [-v|--verbosity] [--version]

ОписаниеDescription

dotnet — это средство для управления исходным кодом .NET и двоичными объектами.dotnet is a tool for managing .NET source code and binaries. Он предоставляет команды, выполняющие определенные задачи, такие как dotnet build и dotnet run.It exposes commands that perform specific tasks, such as dotnet build and dotnet run. Каждая команда определяет свои аргументы.Each command defines its own arguments. Введите --help после каждой команды для доступа к краткой справочной документации.Type --help after each command to access brief help documentation.

dotnet можно использовать для запуска приложений путем указания библиотеки DLL приложения, например dotnet myapp.dll.dotnet can be used to run applications, by specifying an application DLL, such as dotnet myapp.dll. Дополнительные сведения о параметрах развертывания см. в разделе Развертывание приложений .NET Core.See .NET Core application deployment for to learn about deployment options.

ПараметрыOptions

--additional-deps <PATH>

Путь к дополнительному файлу deps.json.Path to additional deps.json file.

--additionalprobingpath <PATH>

Путь, содержащий политику проверки и проверяемые сборки.Path containing probing policy and assemblies to probe.

-d|--diagnostics

Включает вывод диагностических данных.Enables diagnostic output.

--fx-version <VERSION>

Версия среды выполнения .NET Core, используемой для запуска приложения.Version of the .NET Core runtime to use to run the application.

-h|--help

Выводит на экран документацию для определенной команды, например dotnet build --help.Prints out documentation for a given command, such as dotnet build --help. dotnet --help выводит список доступных команд.dotnet --help prints a list of available commands.

--info

Выводит подробные сведения об установке .NET Core и среде компьютера, например текущую операционную систему и фиксацию SHA версии .NET Core.Prints out detailed information about a .NET Core installation and the machine environment, such as the current operating system, and commit SHA of the .NET Core version.

--list-runtimes

Отображает установленные среды выполнения .NET Core.Displays the installed .NET Core runtimes.

--list-sdks

Отображает установленные пакеты SDK для .NET Core.Displays the installed .NET Core SDKs.

--roll-forward-on-no-candidate-fx <N>

Определяет поведение, когда требуемая общая платформа недоступна.Defines behavior when the required shared framework is not available. Параметр N может принимать следующие значения:N can be:

  • 0 — отключает увеличение дополнительных версий.0 - Disable even minor version roll forward.
  • 1 — позволяет увеличивать дополнительный номер версии, но не основной.1 - Roll forward on minor version, but not on major version. Это поведение установлено по умолчанию.This is the default behavior.
  • 2 — включает увеличение основных и дополнительных версий.2 - Roll forward on minor and major versions.

Дополнительные сведения о накате можно найти в этой статье.For more information, see Roll forward.

-v|--verbosity <LEVEL>

Задает уровень детализации команды.Sets the verbosity level of the command. Допустимые значения: q[uiet], m[inimal], n[ormal], d[etailed] и diag[nostic].Allowed values are q[uiet], m[inimal], n[ormal], d[etailed], and diag[nostic]. Поддерживается не во всех командах. Дополнительную информацию см. на странице определенной команды.Not supported in every command; see specific command page to determine if this option is available.

--version

Выводит версию используемого пакета SDK для .NET Core.Prints out the version of the .NET Core SDK in use.

Команды dotnetdotnet commands

ОбщиеGeneral

КомандаCommand ФункцияFunction
dotnet builddotnet build Выполняет сборку приложения .NET Core.Builds a .NET Core application.
dotnet build-serverdotnet build-server Взаимодействует с серверами, запущенными сборкой.Interacts with servers started by a build.
dotnet cleandotnet clean Очищает выходные данные сборки.Clean build outputs.
dotnet helpdotnet help Выводит более подробную документацию из Интернета для команды.Shows more detailed documentation online for the command.
dotnet migratedotnet migrate Переносит допустимый проект предварительной версии 2 в проект пакета SDK .NET Core 1.0.Migrates a valid Preview 2 project to a .NET Core SDK 1.0 project.
dotnet msbuilddotnet msbuild Обеспечивает доступ к командной строке MSBuild.Provides access to the MSBuild command line.
dotnet newdotnet new Инициализирует проект C# или F# для заданного шаблона.Initializes a C# or F# project for a given template.
dotnet packdotnet pack Создает пакет NuGet с кодом.Creates a NuGet package of your code.
dotnet publishdotnet publish Публикует платформозависимое или автономное приложение .NET.Publishes a .NET framework-dependent or self-contained application.
dotnet restoredotnet restore Восстанавливает зависимости для данного приложения.Restores the dependencies for a given application.
dotnet rundotnet run Запускает приложение из источника.Runs the application from source.
dotnet slndotnet sln Параметры для добавления, удаления и перечисления проектов в файле решения.Options to add, remove, and list projects in a solution file.
dotnet storedotnet store Сохраняет сборки в хранилище пакетов среды выполнения.Stores assemblies in the runtime package store.
dotnet testdotnet test Выполняет тесты с помощью средства запуска тестов.Runs tests using a test runner.

Ссылки на проектыProject references

КомандаCommand ФункцияFunction
dotnet add referencedotnet add reference Добавляет ссылку на проект.Adds a project reference.
dotnet list referencedotnet list reference Перечисляет ссылки на проекты.Lists project references.
dotnet remove referencedotnet remove reference Удаляет ссылку на проект.Removes a project reference.

Пакеты NuGetNuGet packages

КомандаCommand ФункцияFunction
dotnet add packagedotnet add package Добавляет пакет NuGet.Adds a NuGet package.
dotnet remove packagedotnet remove package Удаляет пакет NuGet.Removes a NuGet package.

Команды NuGetNuGet commands

КомандаCommand ФункцияFunction
dotnet nuget deletedotnet nuget delete Удаляет пакет с сервера или из списка.Deletes or unlists a package from the server.
dotnet nuget localsdotnet nuget locals Очищает или перечисляет локальные ресурсы NuGet в кэше HTTP-запросов, временном кэше или папке пакетов, используемой на уровне компьютера.Clears or lists local NuGet resources such as http-request cache, temporary cache, or machine-wide global packages folder.
dotnet nuget pushdotnet nuget push Отправляет пакет на сервер и публикует его.Pushes a package to the server and publishes it.

Команды глобальных средствGlobal Tools commands

Глобальные средства .NET Core появились в пакете SDK для .NET Core, начиная с версии 2.1.300:.NET Core Global Tools are available starting with .NET Core SDK 2.1.300:

КомандаCommand ФункцияFunction
dotnet tool installdotnet tool install Устанавливает глобальное средство на локальном компьютере.Installs a Global Tool on your machine.
dotnet tool listdotnet tool list Перечисляет выводит все глобальные средства, установленные на компьютере в каталоге по умолчанию или по указанному пути.Lists all Global Tools currently installed in the default directory on your machine or in the specified path.
dotnet tool uninstalldotnet tool uninstall Удаляет глобальное средство с компьютера.Uninstalls a Global Tool from your machine.
dotnet tool updatedotnet tool update Обновляет глобальное средство на локальном компьютере.Updates a Global Tool on your machine.

Дополнительные средстваAdditional tools

Ряд средств, которые ранее были доступны только для отдельных проектов через DotnetCliToolReference, стали частью пакета SDK для .NET начиная с версии 2.1.300.Starting with .NET Core SDK 2.1.300, a number of tools that were available only on a per project basis using DotnetCliToolReference are now available as part of the .NET Core SDK. Эти средства перечислены в следующей таблице.These tools are listed in the following table:

СредствоTool ФункцияFunction
dev-certsdev-certs Создает сертификаты разработки и управляет ими.Creates and manages development certificates.
efef Средства командной строки для Entity Framework Core.Entity Framework Core command-line tools.
sql-cachesql-cache Средства командной строки для кэша SQL Server.SQL Server cache command-line tools.
user-secretsuser-secrets Управляет секретами пользователей для разработки.Manages development user secrets.
watchwatch Запускает наблюдатель за файлами, который выполняет команду при изменении файлов.Starts a file watcher that runs a command when files change.

Дополнительные сведения о каждом средстве можно получить с помощью команды dotnet <tool-name> --help.For more information about each tool, type dotnet <tool-name> --help.

ПримерыExamples

Создание проекта консольного приложения .NET Core:Creates a new .NET Core console application:

dotnet new console

Восстановление зависимостей для данного приложения:Restore dependencies for a given application:

dotnet restore

Примечание

Начиная с пакета SDK для .NET Core 2.0 нет необходимости выполнять команду dotnet restore, так как она выполняется неявно всеми командами, которые требуют восстановления, например dotnet new, dotnet build и dotnet run.Starting with .NET Core 2.0 SDK, you don't have to run dotnet restore because it's run implicitly by all commands that require a restore to occur, such as dotnet new, dotnet build and dotnet run. Эту команду по-прежнему можно использовать в некоторых сценариях, где необходимо явное восстановление, например в сборках с использованием непрерывной интеграции в Azure DevOps Services или системах сборки, где требуется явно контролировать время восстановления.It's still a valid command in certain scenarios where doing an explicit restore makes sense, such as continuous integration builds in Azure DevOps Services or in build systems that need to explicitly control the time at which the restore occurs.

Сборка проекта и его зависимостей в указанном каталоге:Build a project and its dependencies in a given directory:

dotnet build

Запустите библиотеку DLL приложения, например myapp.dll:Run an application DLL, such as myapp.dll:

dotnet myapp.dll

Переменные средыEnvironment variables

DOTNET_PACKAGES

Основной кэш пакетов.The primary package cache. Если значение не задано, то по умолчанию в Unix используется $HOME/.nuget/packages, а в Windows — %HOME%\NuGet\Packages.If not set, it defaults to $HOME/.nuget/packages on Unix or %HOME%\NuGet\Packages on Windows.

DOTNET_SERVICING

Задает расположение служебного индекса, который будет использоваться общим узлом при загрузке среды выполнения.Specifies the location of the servicing index to use by the shared host when loading the runtime.

DOTNET_CLI_TELEMETRY_OPTOUT

Указывает, собираются ли данные по использованию средств .NET Core для отправки в корпорацию Майкрософт.Specifies whether data about the .NET Core tools usage is collected and sent to Microsoft. Установите значение true, чтобы отказаться от функций телеметрии (поддерживаются значения true, 1 или yes).Set to true to opt-out of the telemetry feature (values true, 1, or yes accepted). Также можно установить значение false, чтобы согласиться на функции телеметрии (поддерживаются значения false, 0 или no).Otherwise, set to false to opt into the telemetry features (values false, 0, or no accepted). Если значение не задано, то по умолчанию используется false, то есть функция телеметрии включена.If not set, the default is false and the telemetry feature is active.

DOTNET_MULTILEVEL_LOOKUP

Указывает, разрешается ли из глобального расположения среда выполнения .NET Core, общая платформа или пакет SDK.Specifies whether .NET Core runtime, shared framework, or SDK are resolved from the global location. Если не задано, используется значение по умолчанию true.If not set, it defaults to true. Задайте значение false, чтобы не разрешать эти сущности из глобального расположения и использовать изолированные установки .NET Core (принимаются значения 0 или false).Set to false to not resolve from the global location and have isolated .NET Core installations (values 0 or false are accepted). Дополнительные сведения о многоуровневом поиске см. в разделе Многоуровневый поиск SharedFX.For more information about multi-level lookup, see Multi-level SharedFX Lookup.

DOTNET_ROLL_FORWARD_ON_NO_CANDIDATE_FX

Отключает накат дополнительных версий, если установлено 0.Disables minor version roll forward, if set to 0. Дополнительные сведения о накате можно найти в этой статье.For more information, see Roll forward.