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

Referências de projeto

Pacotes NuGet

Comandos NuGet

Comandos de carga de trabalho

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.

Ferramentas adicionais

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

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

• Variáveis de ambiente utilizadas pelo SDK .NET, CLI do .NET e runtime do .NET
• Ficheiros de Configuração do Runtime
• Definições de configuração do runtime .NET