Comando dotnetdotnet command

Este tópico aplica-se ao: ✓ SDK do .NET Core 1.x SDK do .NET Core 2.xThis topic applies to: ✓ .NET Core 1.x SDK .NET Core 2.x SDK

NomeName

dotnet – Uma ferramenta para gerenciar o código-fonte e os binários do .NET.dotnet - A tool for managing .NET source code and binaries.

SinopseSynopsis

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]

DescriçãoDescription

dotnet é uma ferramenta para gerenciar o código-fonte e os binários do .NET.dotnet is a tool for managing .NET source code and binaries. Ela expõe comandos que realizam tarefas específicas, como dotnet build e dotnet run.It exposes commands that perform specific tasks, such as dotnet build and dotnet run. Cada comando define seus próprios argumentos.Each command defines its own arguments. Digite --help após cada comando para acessar uma breve documentação de ajuda.Type --help after each command to access brief help documentation.

dotnet pode ser usado para executar aplicativos, especificando uma DLL de aplicativo, como dotnet myapp.dll.dotnet can be used to run applications, by specifying an application DLL, such as dotnet myapp.dll. Consulte Implantação de um aplicativo .NET Core para saber mais sobre as opções de implantação.See .NET Core application deployment for to learn about deployment options.

OpçõesOptions

--additional-deps <PATH>

Caminho para o arquivo deps.json adicional.Path to additional deps.json file.

--additionalprobingpath <PATH>

Caminho que contém a política de investigação e os assemblies a serem investigados.Path containing probing policy and assemblies to probe.

-d|--diagnostics

Habilita a saída de diagnóstico.Enables diagnostic output.

--fx-version <VERSION>

Versão do tempo de execução do .NET Core a ser usada para executar o aplicativo.Version of the .NET Core runtime to use to run the application.

-h|--help

Imprime a documentação para um determinado comando, como dotnet build --help.Prints out documentation for a given command, such as dotnet build --help. dotnet --help imprime uma lista de comandos disponíveis.dotnet --help prints a list of available commands.

--info

Imprime informações detalhadas sobre uma instalação do .NET Core e o ambiente do computador, como o sistema operacional atual, e o SHA da confirmação da versão do .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

Exibe os tempos de execução do .NET Core instalado.Displays the installed .NET Core runtimes.

--list-sdks

Exibe os tempos de execução dos SDKs .NET Core instalados.Displays the installed .NET Core SDKs.

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

Define o comportamento quando a estrutura compartilhada necessária não está disponível.Defines behavior when the required shared framework is not available. N pode ser:N can be:

  • 0 – Desabilitar até mesmo o roll forward da versão secundária.0 - Disable even minor version roll forward.
  • 1 – Efetuar roll forward da versão secundária, mas não da versão principal.1 - Roll forward on minor version, but not on major version. Este é o comportamento padrão.This is the default behavior.
  • 2 – Efetuar roll forward das versões secundária e principal.2 - Roll forward on minor and major versions.

Para saber mais, confira Efetuar roll forward.For more information, see Roll forward.

-v|--verbosity <LEVEL>

Define o nível de detalhes do comando.Sets the verbosity level of the command. Os valores permitidos são q[uiet], m[inimal], n[ormal], d[etailed] e diag[nostic].Allowed values are q[uiet], m[inimal], n[ormal], d[etailed], and diag[nostic]. Não compatível com todos os comandos. Veja a página de comando específica para determinar se essa opção está disponível.Not supported in every command; see specific command page to determine if this option is available.

--version

Imprime a versão do SDK do .NET Core em uso.Prints out the version of the .NET Core SDK in use.

Comandos dotnetdotnet commands

GeralGeneral

ComandoCommand FunçãoFunction
dotnet builddotnet build Compila um aplicativo .NET Core.Builds a .NET Core application.
dotnet build-serverdotnet build-server Interage com servidores iniciados por um build.Interacts with servers started by a build.
dotnet cleandotnet clean Limpa saídas de build.Clean build outputs.
dotnet helpdotnet help Mostra uma documentação mais detalhada online para o comando.Shows more detailed documentation online for the command.
dotnet migratedotnet migrate Migra um projeto válido da Visualização 2 para um projeto do SDK 1.0 do .NET Core.Migrates a valid Preview 2 project to a .NET Core SDK 1.0 project.
dotnet msbuilddotnet msbuild Oferece acesso à linha de comando do MSBuild.Provides access to the MSBuild command line.
dotnet newdotnet new Inicializa um projeto do C# ou F# de um modelo especificado.Initializes a C# or F# project for a given template.
dotnet packdotnet pack Cria um pacote NuGet do seu código.Creates a NuGet package of your code.
dotnet publishdotnet publish Publica um aplicativo dependente do .NET Framework ou autocontido.Publishes a .NET framework-dependent or self-contained application.
dotnet restoredotnet restore Restaura as dependências para um determinado aplicativo.Restores the dependencies for a given application.
dotnet rundotnet run Executa o aplicativo na origem.Runs the application from source.
dotnet slndotnet sln Opções para adicionar, remover e listar projetos em um arquivo de solução.Options to add, remove, and list projects in a solution file.
dotnet storedotnet store Armazena os assemblies no repositório de pacotes de tempo de execução.Stores assemblies in the runtime package store.
dotnet testdotnet test Executa testes usando um executor de teste.Runs tests using a test runner.

Referências de projetoProject references

ComandoCommand FunçãoFunction
dotnet add referencedotnet add reference Adiciona uma referência ao projeto.Adds a project reference.
dotnet list referencedotnet list reference Lista referências ao projeto.Lists project references.
dotnet remove referencedotnet remove reference Remove uma referência ao projeto.Removes a project reference.

Pacotes NuGetNuGet packages

ComandoCommand FunçãoFunction
dotnet add packagedotnet add package Adiciona um pacote NuGet.Adds a NuGet package.
dotnet remove packagedotnet remove package Remove um pacote NuGet.Removes a NuGet package.

Comandos NuGetNuGet commands

ComandoCommand FunçãoFunction
dotnet nuget deletedotnet nuget delete Exclui ou retira da lista um pacote do servidor.Deletes or unlists a package from the server.
dotnet nuget localsdotnet nuget locals Limpa ou lista os recursos locais do NuGet, como cache de solicitação http, cache temporário ou pasta de pacotes globais em todo o computador.Clears or lists local NuGet resources such as http-request cache, temporary cache, or machine-wide global packages folder.
dotnet nuget pushdotnet nuget push Envia um pacote ao servidor e os publica.Pushes a package to the server and publishes it.

Comandos de ferramentas globaisGlobal Tools commands

Ferramentas Globais do .NET Core estão disponíveis a partir do SDK do .NET Core 2.1.300:.NET Core Global Tools are available starting with .NET Core SDK 2.1.300:

ComandoCommand FunçãoFunction
dotnet tool installdotnet tool install Instala uma Ferramenta Global no seu computador.Installs a Global Tool on your machine.
dotnet tool listdotnet tool list Lista todas as Ferramentas Globais atualmente instaladas no diretório padrão do computador ou no caminho especificado.Lists all Global Tools currently installed in the default directory on your machine or in the specified path.
dotnet tool uninstalldotnet tool uninstall Desinstala uma Ferramenta Global do computador.Uninstalls a Global Tool from your machine.
dotnet tool updatedotnet tool update Atualiza uma Ferramenta Global no computador.Updates a Global Tool on your machine.

Ferramentas adicionaisAdditional tools

A partir do SDK do .NET Core 2.1.300, várias ferramentas que estavam disponíveis apenas por projeto usando DotnetCliToolReference agora estão disponíveis como parte do SDK do .NET Core.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. Essas ferramentas estão listadas na tabela a seguir:These tools are listed in the following table:

FerramentaTool FunçãoFunction
dev-certsdev-certs Cria e gerencia certificados de desenvolvimento.Creates and manages development certificates.
efef Ferramentas de linha de comando do Entity Framework Core.Entity Framework Core command-line tools.
sql-cachesql-cache Ferramentas de linha de comando de cache do SQL Server.SQL Server cache command-line tools.
user-secretsuser-secrets Gerencia os segredos do usuário de desenvolvimento.Manages development user secrets.
watchwatch Inicia um observador de arquivo que executa um comando quando os arquivos são alterados.Starts a file watcher that runs a command when files change.

Para obter mais informações sobre cada ferramenta, digite dotnet <tool-name> --help.For more information about each tool, type dotnet <tool-name> --help.

ExemplosExamples

Cria um novo aplicativo de console do .NET Core:Creates a new .NET Core console application:

dotnet new console

Restaure as dependências para um determinado aplicativo:Restore dependencies for a given application:

dotnet restore

Observação

Começando com o SDK do .NET Core 2.0, não é necessário executar dotnet restore, pois ele é executado implicitamente por todos os comandos que exigem uma restauração, como dotnet new, dotnet build e 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. Ainda é um comando válido em determinados cenários em que realizar uma restauração explícita faz sentido, como builds de integração contínua no Azure DevOps Services ou em sistemas de build que precisam controlar explicitamente o horário em que a restauração ocorrerá.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.

Compile um projeto e suas dependências em um determinado diretório:Build a project and its dependencies in a given directory:

dotnet build

Execute a DLL de um aplicativo, como myapp.dll:Run an application DLL, such as myapp.dll:

dotnet myapp.dll

Variáveis de ambienteEnvironment variables

DOTNET_PACKAGES

O cache do pacote principal.The primary package cache. Se não estiver definido, o padrão será $HOME/.nuget/packages em Unix ou %HOME%\NuGet\Packages no Windows.If not set, it defaults to $HOME/.nuget/packages on Unix or %HOME%\NuGet\Packages on Windows.

DOTNET_SERVICING

Especifica o local do índice de manutenção a ser usado pelo host compartilhado ao carregar o tempo de execução.Specifies the location of the servicing index to use by the shared host when loading the runtime.

DOTNET_CLI_TELEMETRY_OPTOUT

Especifica se os dados sobre o uso de ferramentas .NET Core são coletados e enviados para a Microsoft.Specifies whether data about the .NET Core tools usage is collected and sent to Microsoft. Definido como true para recusar o recurso de telemetria (os valores true, 1 ou yes são aceitos).Set to true to opt-out of the telemetry feature (values true, 1, or yes accepted). Caso contrário, definido como false para aceitar os recursos de telemetria (os valores false, 0 ou no são aceitos).Otherwise, set to false to opt into the telemetry features (values false, 0, or no accepted). Se não estiver definido, o padrão será false, e o recurso de telemetria estará ativo.If not set, the default is false and the telemetry feature is active.

DOTNET_MULTILEVEL_LOOKUP

Especifica se o tempo de execução, a estrutura compartilhada ou o SDK do .NET Core são resolvidos no local global.Specifies whether .NET Core runtime, shared framework, or SDK are resolved from the global location. Se não estiver definida, o padrão será true.If not set, it defaults to true. Definida como false para não resolver no local global e ter instalações do NET Core isoladas (os valores 0 ou false são aceitos).Set to false to not resolve from the global location and have isolated .NET Core installations (values 0 or false are accepted). Para obter mais informações sobre a pesquisa de vários níveis, consulte Pesquisa SharedFX de vários níveis.For more information about multi-level lookup, see Multi-level SharedFX Lookup.

DOTNET_ROLL_FORWARD_ON_NO_CANDIDATE_FX

Desabilita o roll forward da versão secundária, se definido como 0.Disables minor version roll forward, if set to 0. Para saber mais, confira Efetuar roll forward.For more information, see Roll forward.