Compartilhar via

Comando dotnet

Este artigo se aplica a: ✔️ SDK do .NET 6 e versões posteriores

Nome

dotnet - O driver genérico para a CLI do .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 instalação do SDK):

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

Para executar um aplicativo:

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

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

Descrição

O dotnet comando tem duas funções:

  • Ele fornece comandos para trabalhar com projetos do .NET.

    Por exemplo, dotnet build compila um projeto. Cada comando define suas próprias opções e argumentos. Todos os comandos dão suporte à opção --help de imprimir uma breve documentação sobre como usar o comando.

  • Ele executa aplicativos .NET.

    Especifique o caminho para um arquivo de aplicativo .dll para executar o aplicativo. Executar o aplicativo significa localizar e executar o ponto de entrada, que no caso de aplicativos de console é o método #D0. Por exemplo, dotnet myapp.dll executa o myapp aplicativo. Consulte a implantação do aplicativo .NET para saber mais sobre as opções de implantação.

Opções

Opções diferentes estão disponíveis para:

  • Exibindo informações sobre o ambiente.
  • Executando um comando.
  • Executando um aplicativo.

Opções para exibir informações de ambiente e comandos disponíveis

As opções a seguir estão disponíveis quando dotnet são usadas por si só, sem especificar um comando ou um aplicativo a ser executado. Por exemplo, dotnet --info ou dotnet --version. Eles imprimem informações sobre o ambiente.

  • --info

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

  • --version

Imprime a versão do SDK do .NET usada pelos dotnet comandos, que pode ser afetada por um arquivo global.json . Disponível somente quando o SDK é instalado.

  • --list-runtimes [--arch <ARCH>]

    Imprime uma lista dos runtimes do .NET instalados para a arquitetura do invocado dotnet. Uma versão x86 de dotnet listas apenas runtimes x86 e uma versão x64 de dotnet listas somente runtimes x64.

    O .NET 10 e versões posteriores dão suporte ao --arch argumento. Se especificado e não o mesmo que a dotnet arquitetura, pesquisa uma instalação do .NET da arquitetura especificada e imprime todos os runtimes instalados lá. Os valores permitidos incluem arm64, x64 e x86. O repositório dotnet/runtime tem a lista completa de valores de arquitetura válidos.

  • --list-sdks [--arch <ARCH>]

    Imprime uma lista dos SDKs do .NET instalados para a arquitetura do invocado dotnet. Uma versão x86 de dotnet listas apenas SDKs x86 e uma versão x64 de dotnet listas apenas de SDKs x64.

    O .NET 10 e versões posteriores dão suporte ao --arch argumento. Se especificado e não o mesmo que a dotnet arquitetura, pesquisa uma instalação do .NET da arquitetura especificada e imprime todos os SDKs instalados lá. Os valores permitidos incluem arm64, x64 e x86. O repositório dotnet/runtime tem a lista completa de valores de arquitetura válidos.

  • -?|-h|--help

    Imprime uma lista de comandos disponíveis.

Opções para executar um comando

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

  • -d|--diagnostics

    Habilita a saída de diagnóstico.

  • -v|--verbosity <LEVEL>

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

  • -?|-h|--help

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

  • command options

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

Opções para executar um aplicativo

As opções a seguir estão disponíveis quando dotnet um aplicativo é executado. Por exemplo, dotnet --roll-forward Major myapp.dll.

  • --additionalprobingpath <PATH>

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

  • --additional-deps <PATH>

    Caminho para um arquivo de.deps.json adicional. Um arquivo deps.json contém uma lista de dependências, dependências de compilação e informações de versão usadas para resolver conflitos de assembly. Para obter mais informações, consulte Arquivos de Configuração do Runtime no GitHub.

  • --roll-forward <SETTING>

    Controla como o roll forward é aplicado ao aplicativo. Pode SETTING ser um dos seguintes valores. Se não for especificado, o padrão será Minor.

    • LatestPatch - Encaminhe para a versão mais alta do patch. Isso desabilita o roll forward de versão secundária.
    • Minor - Encaminhe para a versão secundária mais baixa, se a versão secundária solicitada estiver ausente. Se a versão secundária solicitada estiver presente, a política LatestPatch será usada.
    • Major - Avance para a versão principal mais baixa e a versão secundária mais baixa, se a versão principal solicitada estiver ausente. Se a versão principal solicitada estiver presente, a política Secundária será usada.
    • LatestMinor – Encaminhe para a versão secundária mais alta, mesmo se a versão secundária solicitada estiver presente. Destinado a cenários de hospedagem de componentes.
    • LatestMajor – Encaminhe para a versão secundária mais alta e mais alta, mesmo que o major solicitado esteja presente. Destinado a cenários de hospedagem de componentes.
    • Disable - Não role para frente. Associar somente à versão especificada. Essa política não é recomendada para uso geral porque desabilita a capacidade de encaminhar para os patches mais recentes. Esse valor só é recomendado para teste.

    Com exceção de #B0, todas as configurações usarão a versão de patch mais alta disponível.

    O comportamento de roll forward também pode ser configurado em uma propriedade de arquivo de projeto, uma propriedade de arquivo de configuração de runtime e uma variável de ambiente. Para obter mais informações, consulte Roll forward de runtime da versão principal.

  • --fx-version <VERSION>

    Versão do runtime do .NET a ser usada para executar o aplicativo.

    Essa opção substitui a versão da primeira referência de estrutura no arquivo do .runtimeconfig.json aplicativo. Isso significa que ele só funcionará conforme o esperado se houver apenas uma referência de estrutura. Se o aplicativo tiver mais de uma referência de estrutura, usar essa opção poderá causar erros.

Opções para executar um aplicativo com o exec comando

As opções a seguir só estão disponíveis quando dotnet um aplicativo é executado usando o exec comando. Por exemplo, dotnet exec --runtimeconfig myapp.runtimeconfig.json myapp.dll.

  • --depsfile <PATH>

    Caminho para um arquivo dedeps.json . Um arquivo deps.json é um arquivo de configuração que contém informações sobre as dependências necessárias para executar o aplicativo. Esse arquivo é gerado pelo SDK do .NET.

  • --runtimeconfig <PATH>

    Caminho para um arquivo deruntimeconfig.json . Um arquivo runtimeconfig.json contém configurações de runtime e normalmente é chamado <de nome de> aplicativo.runtimeconfig.json. Para obter mais informações, consulte as configurações de tempo de execução do .NET.

Comandos dotnet

Geral

Comando Função
build dotnet Cria um aplicativo .NET.
dotnet build-server Interage com servidores iniciados por um build.
dotnet clean Limpar saídas de build.
dotnet exec Executa um aplicativo .NET.
Ajuda do dotnet Mostra a documentação mais detalhada online para o comando.
dotnet msbuild Fornece acesso à linha de comando do MSBuild.
dotnet new Inicializa um projeto em C# ou F# para um determinado modelo.
pacote dotnet Cria um pacote NuGet do seu código.
dotnet publish Publica um aplicativo independente ou dependente do .NET Framework.
restauração do dotnet Restaura as dependências de um determinado aplicativo.
execução dotnet Executa o aplicativo da origem.
Verificação do sdk do dotnet Mostra up-tostatus de data das versões instaladas do SDK e do Runtime.
dotnet sln Opções para adicionar, remover e listar projetos em um arquivo de solução.
repositório dotnet Armazena assemblies no repositório de pacotes de runtime.
teste dotnet Executa testes usando um executor de teste.

Referências de projeto

Comando Função
adicionar referência do dotnet Adiciona uma referência de projeto.
lista de referência do dotnet Lista referências de projeto.
remoção de referência do dotnet Remove uma referência de projeto.

Pacotes NuGet

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

Comandos do NuGet

Comando Função
dotnet nuget delete Exclui ou deslista um pacote do servidor.
push do dotnet nuget Envia um pacote por push para o servidor e o publica.
locais do dotnet nuget Limpa ou lista recursos locais do NuGet, como cache de solicitação http, cache temporário ou pasta de pacotes globais em todo o computador.
dotnet nuget add source Adiciona uma origem do NuGet.
dotnet nuget disable source Desabilita uma origem do NuGet.
dotnet nuget enable source Habilita uma origem do NuGet.
origem da lista nuget do dotnet Lista todas as fontes do NuGet configuradas.
dotnet nuget remove a origem Remove uma origem do NuGet.
origem da atualização do nuget do dotnet Atualiza uma fonte do NuGet.

Comandos de carga de trabalho

Comando Função
carga de trabalho dotnet limpa Remove componentes da carga de trabalho.
configuração de carga de trabalho dotnet Habilita ou desabilita o modo de atualização do conjunto de cargas de trabalho.
Histórico de cargas de trabalho do dotnet Mostra todas as ações de instalação da carga de trabalho.
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.
Reparo de carga de trabalho dotnet Repara todas as cargas de trabalho instaladas.
restauração da carga de trabalho dotnet Restaurar cargas de trabalho necessárias para um projeto.
Pesquisa de carga de trabalho dotnet Listar cargas de trabalho selecionadas ou todas as cargas de trabalho disponíveis.
desinstalação da carga de trabalho dotnet Desinstala uma carga de trabalho.
atualização da carga de trabalho do dotnet Reinstala todas as cargas de trabalho instaladas.

Comandos globais, de ferramentas e de ferramentas locais

As ferramentas são aplicativos de console instalados a partir de pacotes NuGet e são invocados do prompt de comando. Você pode escrever ferramentas por conta própria ou instalar ferramentas escritas por terceiros. As ferramentas também são conhecidas como ferramentas globais, ferramentas de caminho de ferramenta e ferramentas locais. Para obter mais informações, consulte visão geral das ferramentas do .NET.

Comando Função
Instalação da ferramenta dotnet Instala uma ferramenta em seu computador.
lista de ferramentas dotnet Lista todas as ferramentas globais, de caminho de ferramenta ou locais atualmente instaladas em seu computador.
Pesquisa de ferramentas dotnet Pesquisa NuGet.org ferramentas que têm o termo de pesquisa especificado em seu nome ou metadados.
desinstalação da ferramenta dotnet Desinstala uma ferramenta do computador.
atualização da ferramenta dotnet Atualiza uma ferramenta instalada em seu computador.

Ferramentas adicionais

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

Ferramenta Função
dev-certs Cria e gerencia certificados de desenvolvimento.
Ef Ferramentas de linha de comando do Entity Framework Core.
segredos do usuário Gerencia segredos do usuário de desenvolvimento.
relógio Um observador de arquivos que reinicia ou recarrega um aplicativo quando detecta alterações no código-fonte.

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

Exemplos

Crie um novo aplicativo de console do .NET:

dotnet new console

Crie um projeto e suas dependências em um determinado diretório:

dotnet build

Execute um aplicativo:

dotnet exec myapp.dll

dotnet myapp.dll

Consulte também

  • Last updated on