Partilhar via


comando dotnet

Este artigo aplica-se a: ✔️ SDK .NET Core 3.1 e versões posteriores

Name

dotnet - O controlador genérico da CLI de .NET.

Sinopse

Para obter informações sobre os comandos disponíveis e o ambiente:

dotnet [--version] [--info] [--list-runtimes] [--list-sdks]

dotnet -h|--help

Para executar um comando (requer a instalação do SDK):

dotnet <COMMAND> [-d|--diagnostics] [-h|--help] [--verbosity <LEVEL>]
    [command-options] [arguments]

Para executar uma aplicação:

dotnet [--additionalprobingpath <PATH>] [--additional-deps <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    <PATH_TO_APPLICATION> [arguments]

dotnet exec [--additionalprobingpath] [--additional-deps <PATH>]
    [--depsfile <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    [--runtimeconfig <PATH>]
    <PATH_TO_APPLICATION> [arguments]

Description

O dotnet comando tem duas funções:

  • Fornece comandos para trabalhar com projetos .NET.

    Por exemplo, dotnet build cria um projeto. Cada comando define as suas próprias opções e argumentos. Todos os comandos suportam a opção --help para imprimir documentação breve sobre como utilizar o comando.

  • Executa aplicações .NET.

    Especifique o caminho para um ficheiro de aplicação .dll para executar a aplicação. Executar a aplicação significa localizar e executar o ponto de entrada, que no caso das aplicações de consola é o Main método . Por exemplo, dotnet myapp.dll executa a aplicação myapp . Veja Implementação de aplicações .NET para saber mais sobre as opções de implementação.

Opções

Estão disponíveis diferentes opções para:

  • Apresentar informações sobre o ambiente.
  • Executar um comando.
  • Executar uma aplicação.

Opções para apresentar informações do ambiente e comandos disponíveis

As seguintes opções estão disponíveis quando dotnet são utilizadas por si só, sem especificar um comando ou uma aplicação para executar. Por exemplo, dotnet --info ou dotnet --version. Imprime informações sobre o ambiente.

  • --info

    Imprime informações detalhadas sobre uma instalação .NET e o ambiente do computador, como o sistema operativo atual, e consolida SHA da versão .NET.

  • --version

Imprime a versão do SDK .NET utilizada pelos dotnet comandos, que podem ser afetados por um ficheiro global.json . Disponível apenas quando o SDK estiver instalado.

  • --list-runtimes

    Imprime uma lista dos runtimes do .NET instalados. Uma versão x86 do SDK lista apenas runtimes x86 e uma versão x64 do SDK lista apenas runtimes x64.

  • --list-sdks

    Imprime uma lista dos SDKs .NET instalados.

  • -?|-h|--help

    Imprime uma lista de comandos disponíveis.

Opções para executar um comando

As seguintes opções são para dotnet com um comando. Por exemplo, dotnet build --help ou dotnet build --verbosity diagnostic.

  • -d|--diagnostics

    Ativa a saída de diagnóstico.

  • -v|--verbosity <LEVEL>

    Define o nível de verbosidade do comando. Os valores permitidos são q[uiet], m[inimal], n[ormal], d[etailed]e diag[nostic]. Não suportado em todos os comandos. Veja a página de comandos específica para determinar se esta opção está disponível.

  • -?|-h|--help

    Imprime a documentação de um determinado comando. Por exemplo, dotnet build --help apresenta ajuda para o build comando .

  • command options

    Cada comando define opções específicas a esse comando. Veja a página de comandos específica para obter uma lista de opções disponíveis.

Opções para executar uma aplicação

As seguintes opções estão disponíveis quando dotnet executa uma aplicação. Por exemplo, dotnet --roll-forward Major myapp.dll.

  • --additionalprobingpath <PATH>

    Caminho que contém a política de pesquisa e assemblagens a sondar. Repita a opção para especificar vários caminhos.

  • --additional-deps <PATH>

    Caminho para um ficheiro .deps.json adicional. Um ficheiro deps.json contém uma lista de dependências, dependências de compilação e informações de versão utilizadas para resolver conflitos de assemblagem. Para obter mais informações, veja Runtime Configuration Files on GitHub (Ficheiros de Configuração do Runtime no GitHub).

  • --roll-forward <SETTING>

    Controla a forma como o roll forward é aplicado à aplicação. Pode SETTING ser um dos seguintes valores. Se não for especificado, Minor é a predefinição.

    • LatestPatch - Avançar para a versão de patch mais elevada. Esta ação desativa o roll forward de versões secundárias.
    • Minor - Avançar para a versão secundária mais baixa mais baixa, se a versão secundária pedida estiver em falta. Se a versão secundária pedida estiver presente, será utilizada a política LatestPatch.
    • Major - Avançar para a versão principal mais baixa e para a versão secundária mais baixa, se a versão principal pedida estiver em falta. Se a versão principal pedida estiver presente, será utilizada a política Secundária.
    • LatestMinor - Avançar para a versão secundária mais alta, mesmo que esteja presente a versão secundária pedida. Destina-se a cenários de alojamento de componentes.
    • LatestMajor - Avance para a versão principal e secundária mais elevada, mesmo que esteja presente o major pedido. Destina-se a cenários de alojamento de componentes.
    • Disable - Não avançar. Vincular apenas à versão especificada. Esta política não é recomendada para utilização geral porque desativa a capacidade de avançar para os patches mais recentes. Este valor só é recomendado para testes.

    Com exceção de Disable, todas as definições utilizarão a versão de patch mais elevada disponível.

    O comportamento de roll forward também pode ser configurado numa propriedade de ficheiro de projeto, numa propriedade de ficheiro de configuração de runtime e numa variável de ambiente. Para obter mais informações, veja Versão principal do runtime roll forward.

  • --fx-version <VERSION>

    Versão do runtime do .NET a utilizar para executar a aplicação.

    Esta opção substitui a versão da primeira referência de arquitetura no ficheiro da .runtimeconfig.json aplicação. Isto significa que só funciona conforme esperado se existir apenas uma referência de arquitetura. Se a aplicação tiver mais do que uma referência de arquitetura, a utilização desta opção poderá causar erros.

Opções para executar uma aplicação com o exec comando

As seguintes opções só estão disponíveis quando dotnet executa uma aplicação com o exec comando . Por exemplo, dotnet exec --runtimeconfig myapp.runtimeconfig.json myapp.dll.

  • --depsfile <PATH>

    Caminho para um ficheiro deps.json . Um ficheiro deps.json é um ficheiro de configuração que contém informações sobre as dependências necessárias para executar a aplicação. Este ficheiro é gerado pelo SDK .NET.

  • --runtimeconfig <PATH>

    Caminho para um ficheiro runtimeconfig.json . Um ficheiro runtimeconfig.json contém definições de tempo de execução e é normalmente denominado <applicationname.runtimeconfig.json>. Para obter mais informações, veja Definições de configuração do runtime do .NET.

comandos do .NET

Geral

Comando Função
compilação dotnet Cria uma aplicação .NET.
dotnet build-server Interage com servidores iniciados por uma compilação.
dotnet clean Saídas de compilação limpas.
dotnet exec Executa uma aplicação .NET.
ajuda dotnet Mostra documentação mais detalhada online para o comando.
migrar dotnet Migra um projeto de Pré-visualização 2 válido para um projeto .NET Core SDK 1.0.
dotnet msbuild Fornece acesso à linha de comandos MSBuild.
dotnet novo Inicializa um projeto C# ou F# para um determinado modelo.
pacote dotnet Cria um pacote NuGet do seu código.
publicação dotnet Publica uma aplicação dependente do .NET Framework ou autónoma.
restauro dotnet Restaura as dependências de uma determinada aplicação.
execução dotnet Executa a aplicação a partir da origem.
verificação do sdk dotnet Mostra o estado atualizado das versões SDK e Runtime instaladas.
dotnet sln Opções para adicionar, remover e listar projetos num ficheiro de solução.
loja dotnet Armazena assemblagens no arquivo de pacotes de runtime.
teste dotnet Executa testes com um corredor de teste.

Referências de projeto

Comando Função
dotnet adicionar referência Adiciona uma referência de projeto.
referência de lista dotnet Lista referências de projetos.
dotnet remove reference Remove uma referência de projeto.

Pacotes NuGet

Comando Função
dotnet adicionar pacote Adiciona um pacote NuGet.
pacote de remoção do dotnet Remove um pacote NuGet.

Comandos NuGet

Comando Função
dotnet nuget delete Elimina ou desativa a lista de um pacote do servidor.
dotnet nuget push Envia um pacote para o servidor e publica-o.
dotnet nuget locals Limpa ou lista os recursos nuGet locais, como a cache de pedidos http, a cache temporária ou a pasta de pacotes globais em todo o computador.
dotnet nuget adicionar origem Adiciona uma origem NuGet.
dotnet nuget disable source Desativa uma origem NuGet.
dotnet nuget ativar origem Ativa uma origem NuGet.
origem da lista dotnet nuget Lista todas as origens NuGet configuradas.
dotnet nuget remove source Remove uma origem NuGet.
dotnet nuget update source Atualizações uma origem NuGet.

Comandos de carga de trabalho

Comando Função
instalação da carga de trabalho do dotnet Instala uma carga de trabalho opcional.
lista de cargas de trabalho dotnet Lista todas as cargas de trabalho instaladas.
reparação da carga de trabalho do dotnet Repara todas as cargas de trabalho instaladas.
pesquisa de cargas de trabalho dotnet Listar cargas de trabalho selecionadas ou todas as cargas de trabalho disponíveis.
desinstalar carga de trabalho dotnet Desinstala uma carga de trabalho.
atualização da carga de trabalho dotnet Reinstala todas as cargas de trabalho instaladas.

Comandos globais, de caminho de ferramentas e de ferramentas locais

As ferramentas são aplicações de consola instaladas a partir de pacotes NuGet e que são invocadas a partir da linha de comandos. Pode escrever ferramentas por si próprio ou instalar ferramentas escritas por terceiros. As ferramentas também são conhecidas como ferramentas globais, ferramentas de caminho de ferramentas e ferramentas locais. Para obter mais informações, veja Descrição geral das ferramentas .NET.

Comando Função
instalação da ferramenta dotnet Instala uma ferramenta no seu computador.
lista de ferramentas dotnet Lista todas as ferramentas globais, de caminho de ferramentas ou locais atualmente instaladas no seu computador.
pesquisa de ferramentas dotnet Procura NuGet.org ferramentas que tenham o termo de pesquisa especificado no respetivo nome ou metadados.
desinstalação da ferramenta dotnet Desinstala uma ferramenta do seu computador.
atualização da ferramenta dotnet Atualizações uma ferramenta instalada no seu computador.

Ferramentas adicionais

As seguintes ferramentas adicionais estão disponíveis como parte do SDK .NET:

Ferramenta Função
dev-certs Cria e gere certificados de desenvolvimento.
ef Ferramentas de linha de comandos do Entity Framework Core.
user-secrets Gere segredos de utilizadores de desenvolvimento.
watch Um observador de ficheiros que reinicia ou recarrega frequentemente uma aplicação quando deteta alterações no código fonte.

Para obter mais informações sobre cada ferramenta, escreva dotnet <tool-name> --help.

Exemplos

Criar uma nova aplicação de consola .NET:

dotnet new console

Crie um projeto e as respetivas dependências num determinado diretório:

dotnet build

Executar uma aplicação:

dotnet exec myapp.dll
dotnet myapp.dll

Ver também