Partilhar via

comando dotnet

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

Nome

dotnet - O driver genérico para a CLI .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 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 .NET.

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

  • Ele executa aplicativos .NET.

    Você especifica 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 Implantação de aplicativos .NET para saber mais sobre as opções de implantação.

Opções

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

  • Exibição de 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 é usado por si só, sem especificar um comando ou um aplicativo para executar. Por exemplo, dotnet --info ou dotnet --version. Eles imprimem informações sobre o meio ambiente.

  • --info

    Imprime informações detalhadas sobre uma instalação do .NET e o ambiente da máquina, como o sistema operacional atual, e confirma o 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 estiver instalado.

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

    Imprime uma lista dos tempos de execução do .NET instalados para a arquitetura do .dotnet Uma versão x86 lista apenas tempos de dotnet execução x86 e uma versão x64 lista apenas tempos de dotnet execução x64.

    O .NET 10 e versões posteriores suportam o --arch argumento. Se especificado e não igual à dotnet arquitetura, procura uma instalação .NET da arquitetura especificada e imprime todos os tempos de execução 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 .NET instalados para a arquitetura do arquivo dotnet. Uma versão x86 lista dotnet apenas SDKs x86 e uma versão x64 lista dotnet apenas SDKs x64.

    O .NET 10 e versões posteriores suportam o --arch argumento. Se especificado e não igual à dotnet arquitetura, procura uma instalação .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 com um comando. Por exemplo, dotnet build --help ou dotnet build --verbosity diagnostic.

  • -d|--diagnostics

    Permite 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. Consulte a página de comando 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 a ajuda para o build comando.

  • command options

    Cada comando define opções específicas para esse comando. Consulte a página de comando 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 contendo política de sondagem e assemblies a serem investigados. Repita a opção para especificar vários caminhos.

  • --additional-deps <PATH>

    Caminho para um arquivo .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 de tempo de execução no GitHub.

  • --roll-forward <SETTING>

    Controla como a marcha rolante é aplicada ao aplicativo. O SETTING pode ser um dos seguintes valores. Se não for especificado, Minor é o padrão.

    • LatestPatch - Avançar para a versão mais alta do patch. Isso desativa o roll forward da versão secundária.
    • Minor - Avançar para a versão secundária superior mais baixa, se a versão secundária solicitada estiver faltando. Se a versão secundária solicitada estiver presente, a política LatestPatch será usada.
    • Major - Avançar para a versão principal mais baixa e a versão secundária mais baixa, se a versão principal solicitada estiver faltando. Se a versão principal solicitada estiver presente, a política Secundária será usada.
    • LatestMinor - Avançar para a versão secundária mais alta, mesmo que a versão secundária solicitada esteja presente. Destinado a cenários de hospedagem de componentes.
    • LatestMajor - Avançar para a versão principal mais alta e a versão secundária mais alta, mesmo que a versão principal solicitada esteja presente. Destinado a cenários de hospedagem de componentes.
    • Disable - Não role para a frente. Vincular somente à versão especificada. Esta política não é recomendada para uso geral porque desativa a capacidade de avançar para os patches mais recentes. Este valor só é recomendado para testes.

    Com exceção do Disable, 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 tempo de execução e uma variável de ambiente. Para obter mais informações, consulte Roll-forward de tempo de execução da versão principal.

  • --fx-version <VERSION>

    Versão do tempo de execução do .NET a ser usada para executar o aplicativo.

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

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

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

  • --depsfile <PATH>

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

  • --runtimeconfig <PATH>

    Caminho para um arquivo runtimeconfig.json . Um ficheiroruntimeconfig.json contém definições de tempo de execução e é normalmente nomeado <nome de aplicação>.runtimeconfig.json. Para obter mais informações, consulte definições de configuração de tempo de execução do .NET.

comandos dotnet

Geral

Comando Função
dotnet construir Cria um aplicativo .NET.
dotnet build-server Interage com servidores iniciados por uma compilação.
dotnet limpar Saídas de compilação limpas.
Dotnet Executive Executa um aplicativo .NET.
Ajuda dotnet Mostra documentação online mais detalhada para o comando.
msbuild dotnet Fornece acesso à linha de comando MSBuild.
dotnet novo Inicializa um projeto C# ou F# para um determinado modelo.
Pacote Dotnet Cria um pacote NuGet do seu código.
dotnet publicar Publica um aplicativo dependente do .NET Framework ou independente.
restauração dotnet Restaura as dependências de um determinado aplicativo.
Dotnet Run Executa o aplicativo a partir do código-fonte.
verificação dotnet sdk 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.
Loja Dotnet Armazena assemblies no repositório de pacotes de tempo de execução.
dotnet teste Executa testes usando um executor de teste.

Referências do projeto

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

Pacotes NuGet

Comando Função
dotnet pacote adicionar Adiciona um pacote NuGet.
Lista de pacotes dotnet Lista pacotes NuGet.
dotnet pacote remover Remove um pacote NuGet.
pesquisa de pacotes dotnet Procura um pacote NuGet.

Comandos NuGet

Comando Função
dotnet nuget excluir Exclui ou cancela a lista de um pacote do servidor.
dotnet nuget empurrar Envia um pacote para o servidor e o publica.
Moradores 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 toda a máquina.
dotnet nuget adicionar fonte Adiciona uma fonte NuGet.
dotnet nuget desativar fonte Desabilita uma fonte do NuGet.
dotnet nuget ativar fonte Habilita uma fonte NuGet.
Fonte da lista nuget dotnet Lista todas as fontes NuGet configuradas.
dotnet nuget remover fonte Remove uma fonte do NuGet.
Fonte de atualização do Dotnet NuGet Atualiza uma fonte do NuGet.

Comandos de carga de trabalho

Comando Função
dotnet carga de trabalho limpa Remove componentes da carga de trabalho.
Configuração da carga de trabalho dotnet Habilita ou desabilita o modo de atualização do conjunto de carga de trabalho.
histórico de carga de trabalho dotnet Mostra todas as ações de instalação da carga de trabalho.
carga de trabalho dotnet instalar Instala uma carga de trabalho opcional.
Lista de carga de trabalho dotnet Lista todas as cargas de trabalho instaladas.
Reparo da carga de trabalho dotnet Repara todas as cargas de trabalho instaladas.
Restauração da carga de trabalho dotnet Restaure as cargas de trabalho necessárias para um projeto.
Pesquisa de carga de trabalho dotnet Liste as 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 dotnet Reinstala todas as cargas de trabalho instaladas.

Comandos globais, de caminho de ferramenta e de ferramentas locais

Ferramentas são aplicativos de console instalados a partir de pacotes NuGet e invocados a partir do prompt de comando. Você mesmo pode escrever ferramentas 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 .NET.

Comando Função
instalação da ferramenta dotnet Instala uma ferramenta na sua máquina.
Lista de ferramentas dotnet Lista todas as ferramentas globais, de caminho de ferramenta ou locais atualmente instaladas em sua máquina.
Pesquisa da ferramenta DotNet As pesquisas NuGet.org por ferramentas que tenham o termo de pesquisa especificado em seu nome ou metadados.
desinstalação da ferramenta dotnet Desinstala uma ferramenta da sua máquina.
atualização da ferramenta dotnet Atualiza uma ferramenta instalada na sua máquina.

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 utilizador Gerencia segredos de usuário de desenvolvimento.
assista Um inspetor de arquivos que reinicia ou recarrega a quente um aplicativo quando deteta 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 .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

Ver também

  • Last updated on