2016-01-05 02:25:15 +00:00
% DOTNET(1)
2016-04-15 17:36:31 +00:00
% Microsoft Corporation dotnetclifeedback@microsoft.com
2016-06-14 13:42:21 +00:00
% June 2016
2015-11-16 14:37:00 +00:00
2016-06-14 13:42:21 +00:00
## NAME
2015-11-16 14:37:00 +00:00
2016-06-14 13:42:21 +00:00
dotnet -- General driver for running the command-line commands
2015-11-16 14:37:00 +00:00
2016-06-14 13:42:21 +00:00
## SYNOPSIS
2015-11-16 14:37:00 +00:00
2016-06-14 13:42:21 +00:00
`dotnet [--version] [--help] [--verbose] [--info] <command> [<args>]`
2015-11-16 14:37:00 +00:00
2016-06-14 13:42:21 +00:00
## DESCRIPTION
`dotnet` is a generic driver for the Command Line Interface (CLI) toolchain. Invoked on its own, it will give out brief usage instructions.
2015-11-16 14:37:00 +00:00
2016-06-14 13:42:21 +00:00
Each specific feature is implemented as a command. In order to use the feature, the command is specified after `dotnet` , such as [`dotnet build` ](dotnet-build.md ). All of the arguments following the command are its own arguments.
2015-11-16 14:37:00 +00:00
2016-06-14 13:42:21 +00:00
The only time `dotnet` is used as a command on its own is to run portable apps. Just specify a portable application DLL after the `dotnet` verb to execute the application.
2015-11-16 14:37:00 +00:00
2016-06-14 13:42:21 +00:00
## OPTIONS
2016-01-05 02:25:15 +00:00
`-v, --verbose`
2015-11-16 14:37:00 +00:00
2016-06-14 13:42:21 +00:00
Enables verbose output.
2015-11-16 14:37:00 +00:00
2016-01-05 02:25:15 +00:00
`--version`
2015-11-16 14:37:00 +00:00
2016-06-14 13:42:21 +00:00
Prints out the version of the CLI tooling.
2016-01-05 02:25:15 +00:00
2016-03-24 20:36:58 +00:00
`--info`
2016-06-14 13:42:21 +00:00
Prints out more detailed information about the CLI tooling, such as the current operating system, commit SHA for the version, etc.
2016-03-24 20:36:58 +00:00
2016-01-05 02:25:15 +00:00
`-h, --help`
2016-06-14 13:42:21 +00:00
Prints out a short help and a list of current commands.
2016-01-05 02:25:15 +00:00
2016-06-14 13:42:21 +00:00
## DOTNET COMMANDS
2016-01-05 02:25:15 +00:00
2016-06-14 13:42:21 +00:00
The following commands exist for dotnet:
2016-01-05 02:25:15 +00:00
2016-06-14 13:42:21 +00:00
* [dotnet-new ](dotnet-new.md )
* Initializes a C# or F# console application project.
* [dotnet-restore ](dotnet-restore.md )
* Restores the dependencies for a given application.
* [dotnet-build ](dotnet-build.md )
* Builds a .NET Core application.
* [dotnet-publish ](dotnet-publish.md )
* Publishes a .NET portable or self-contained application.
* [dotnet-run ](dotnet-run.md )
* Runs the application from source.
* [dotnet-test ](dotnet-test.md )
* Runs tests using a test runner specified in the project.json.
* [dotnet-pack ](dotnet-pack.md )
* Creates a NuGet package of your code.
2016-01-05 02:25:15 +00:00
2016-06-14 13:42:21 +00:00
## EXAMPLES
2016-01-05 02:25:15 +00:00
2016-03-18 04:27:33 +00:00
`dotnet new`
2016-01-05 02:25:15 +00:00
2016-06-14 13:42:21 +00:00
Initializes a sample .NET Core console application that can be compiled and run.
2016-01-05 02:25:15 +00:00
`dotnet restore`
2016-06-14 13:42:21 +00:00
Restores dependencies for a given application.
2016-01-05 02:25:15 +00:00
`dotnet compile`
2016-06-14 13:42:21 +00:00
Compiles the application in a given directory.
2016-01-05 02:25:15 +00:00
2016-06-14 13:42:21 +00:00
`dotnet myapp.dll`
2016-01-05 02:25:15 +00:00
2016-06-14 13:42:21 +00:00
Runs a portable app named `myapp.dll` .
2016-01-05 02:25:15 +00:00
2016-06-14 13:42:21 +00:00
## ENVIRONMENT
2016-01-05 02:25:15 +00:00
2016-06-14 13:42:21 +00:00
`DOTNET_PACKAGES`
2016-01-05 02:25:15 +00:00
2016-06-14 13:42:21 +00:00
The primary package cache. If not set, it defaults to $HOME/.nuget/packages on Unix or %HOME%\NuGet\Packages on Windows.
2016-01-05 02:25:15 +00:00
`DOTNET_SERVICING`
2016-06-14 13:42:21 +00:00
Specifies the location of the servicing index to use by the shared host when loading the runtime.
`DOTNET_CLI_TELEMETRY_OPTOUT`
2015-11-16 14:37:00 +00:00
2016-06-14 13:42:21 +00:00
Specifies whether data about the .NET Core tools usage is collected and sent to Microsoft. **true** to opt-out of the telemetry feature (values true, 1 or yes accepted); otherwise, **false** (values false, 0 or no accepted). If not set, it defaults to **false** , that is, the telemetry feature is on.