Instalação da ferramenta dotnet

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

Nome

dotnet tool install – Instala a ferramenta .NET especificada no computador.

Sinopse

dotnet tool install <PACKAGE_NAME> -g|--global
    [--allow-downgrade] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> --tool-path <PATH>
    [--allow-downgrade] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install <PACKAGE_NAME> [--local]
    [--allow-downgrade] [--allow-roll-forward] [-a|--arch <ARCHITECTURE>]
    [--add-source <SOURCE>] [--configfile <FILE>]
    [--create-manifest-if-needed] [--disable-parallel]
    [--framework <FRAMEWORK>] [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>] [-v|--verbosity <LEVEL>]
    [--version <VERSION_NUMBER>]

dotnet tool install -h|--help

Descrição

O comando dotnet tool install fornece uma maneira de instalar no computador as ferramentas .NET. Para usar o comando, especifique uma das seguintes opções de instalação:

Para instalar uma ferramenta global no local padrão, use a opção --global.
Para instalar uma ferramenta global em um local personalizado, use a opção --tool-path.
Para instalar uma ferramenta local, omita as opções --global e --tool-path.

Aviso

Verifique se o diretório especificado com a opção --tool-path é seguro. As ferramentas instaladas nesse local podem ser executadas diretamente, portanto, o uso de um caminho não confiável ou compartilhado pode introduzir riscos de segurança.

Locais de instalação

Ferramentas globais

As ferramentas globais são instaladas nos seguintes diretórios por padrão quando você especifica a opção -g ou --global:

Sistema operacional	Caminho
Linux/macOS	`$HOME/.dotnet/tools`
Windows	`%USERPROFILE%\.dotnet\tools`

Os executáveis são gerados nessas pastas para cada ferramenta instalada globalmente, embora os binários de ferramentas reais sejam aninhados profundamente no diretório .store irmão.

Observação

No Linux, após a instalação de uma ferramenta de linha de comando com dotnet tool, a ferramenta só pode ser executada a partir do $HOME/.dotnet/tools caminho. Para tornar a ferramenta executável a partir de qualquer diretório, atualize a PATH variável de ambiente. Para tornar a variável de ambiente atualizada PATH permanente em seu shell, atualize suas configurações de shell. Para Bash, este é o $HOME/.bashrc arquivo.

Ferramentas `--tool-path`

Ferramentas com caminhos de ferramenta explícitos são armazenadas para onde quer que você tenha especificado que o parâmetro --tool-path seja apontado. Elas são armazenadas da mesma forma que as ferramentas globais: um binário executável com os binários reais em um diretório .store irmão.

Ferramentas locais

As ferramentas locais são armazenadas no diretório global do NuGet, conforme você o tenha definido. Há arquivos shim em $HOME/.dotnet/toolResolverCache de cada ferramenta local que apontam para onde as ferramentas estão nesse local.

As referências às ferramentas locais são adicionadas a um arquivo dotnet-tools.json em um diretório .config no diretório atual. A partir do .NET 10, se um arquivo de manifesto ainda não existir, um será criado automaticamente. Você também pode criar um manualmente executando o seguinte comando:

dotnet new tool-manifest

Para obter mais informações, confira Instalar uma ferramenta local.

Argumentos

PACKAGE_NAME

Nome/ID do pacote NuGet que contém a ferramenta do .NET a ser instalada.

A partir do SDK do .NET 10.0.100, use o nome/ID e a versão separada para @ instalar uma ferramenta .NET.

Opções

--allow-downgrade

Permitir o downgrade do pacote ao instalar ou atualizar um pacote de ferramentas do .NET. Suprime o aviso: "A versão solicitada x.x.x é inferior à versão existente x.x.x."
--allow-roll-forward

Disponível a partir do SDK do .NET 9.0. Permitir que a ferramenta use uma versão mais recente do runtime do .NET se o runtime de destino não estiver instalado.
-a|--arch <ARCHITECTURE>

Especifica a arquitetura de destino. Essa é uma sintaxe abreviada para definir o RID (Identificador de Runtime), em que o valor fornecido é combinado com o RID padrão. Por exemplo, em um computador win-x64, a especificação de --arch x86 define o RID como win-x86. Se você usar essa opção, não use a opção -r|--runtime. Disponível desde a versão prévia 7 do .NET 6.
--add-source <SOURCE>

Adiciona outra origem do pacote NuGet a ser usada durante a instalação. Os feeds são acessados em paralelo, não sequencialmente em uma ordem de precedência. Se o mesmo pacote e a mesma versão estiverem em vários feeds, o feed mais rápido vencerá. Para obter mais informações, confira O que acontece quando um pacote NuGet é instalado?.
--configfile <FILE>

O arquivo de configuração do NuGet (nuget.config) a ser usado. Se esse arquivo for especificado, serão usadas somente as configurações dele. Se ele não for especificado, será usada a hierarquia de arquivos de configuração do diretório atual. Para obter mais informações, confira Configurações comuns do NuGet.
--create-manifest-if-needed

Disponível a partir do SDK do .NET 8.

Aplica-se a ferramentas locais. Para localizar um manifesto, o algoritmo de pesquisa faz uma pesquisa na árvore de diretórios por dotnet-tools.json ou uma pasta .config que contenha um arquivo dotnet-tools.json.

Se um manifesto de ferramenta não puder ser encontrado e a opção --create-manifest-if-needed estiver definida como false, o CannotFindAManifestFile erro ocorrerá.

Se um manifesto de ferramenta não puder ser encontrado e a opção --create-manifest-if-needed estiver definida true como (ou, em versões posteriores e .NET 10, quando não for especificada), a ferramenta criará um manifesto automaticamente. Escolhe uma pasta para o manifesto, conforme o seguinte:
- Percorra a árvore de diretórios procurando um diretório que tenha uma subpasta .git. Encontrado o diretório, crie o manifesto nele.
- Se a etapa anterior não encontrar um diretório, suba na árvore de diretórios procurando um diretório que tenha um .sln arquivo ou .git . Encontrado o diretório, crie o manifesto nele.
- Se você não encontrar o diretório em nenhuma das duas etapas anteriores, crie o manifesto no diretório de trabalho atual.
Para obter mais informações sobre como os manifestos são localizados, consulte Instalar uma ferramenta local.

A partir do .NET 10, um manifesto será criado automaticamente se nenhum manifesto de ferramentas for encontrado. Essa alteração pode ser uma alteração significativa. Você pode recusar passando --create-manifest-if-needed=false.

Aviso

Não execute comandos de ferramenta na pasta Downloads ou em qualquer local compartilhado. A CLI orienta a árvore de diretório para encontrar um manifesto de ferramenta, o que pode fazer com que ele use um manifesto que você não espera. Sempre execute comandos de ferramenta de um diretório confiável e específico do projeto.
--disable-parallel

Previne a restauração de vários projetos paralelamente.
--framework <FRAMEWORK>

Especifica a estrutura de destino para a qual instalar a ferramenta. Por padrão, o SDK do .NET tenta escolher a estrutura de destino mais apropriada.
-g|--global

Especifica que a instalação é de todos os usuários. Não pode ser combinada com a opção --tool-path. Omitir --global e --tool-path especifica uma instalação de ferramenta local.
--source <SOURCE>

Especifica a origem dos pacotes NuGet. Essa origem substitui todas as fontes do pacote NuGet.
-?|-h|--help

Imprime uma descrição de como usar o comando.
--ignore-failed-sources

Tratar as falhas de origem de pacote como avisos.
--interactive

Permite que o comando pare e aguarde entrada ou ação do usuário. Por exemplo, para concluir a autenticação.
--local

Atualizar a ferramenta e o manifesto de ferramenta local. Essa opção não pode ser combinada com a opção --global ou --tool-path.
--no-cache ou --no-http-cache

Não armazene pacotes e solicitações HTTP em cache.
--prerelease

Incluir pacotes de pré-lançamento.
--tool-manifest <PATH>

Caminho para o arquivo de manifesto.
--tool-path <PATH>

Especifica o local para instalar a Ferramenta Global. PATH pode ser absoluto ou relativo. Se PATH não existir, o comando tentará criá-lo. Omitir --global e --tool-path especifica uma instalação de ferramenta local.
-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]. Para obter mais informações, consulte LoggerVerbosity.
--version <VERSION_NUMBER>

A versão da ferramenta a ser instalada. Por padrão, a última versão estável do pacote é instalada. Use essa opção para instalar a versão prévia ou versões mais antigas da ferramenta.

A partir do .NET 8, --version Major.Minor.Patch refere-se a uma versão principal/secundária/patch específica, incluindo versões não listadas. Para obter a versão mais recente de uma determinada versão maior/menor, use --version Major.Minor.*.

Exemplos

dotnet tool install -g dotnetsay

Instala dotnetsay como uma ferramenta global no local padrão:
dotnet tool install dotnetsay --tool-path c:\global-tools

Instala dotnetsay como uma ferramenta global em um diretório específico do Windows.
dotnet tool install dotnetsay --tool-path ~/bin

Instala dotnetsay como uma ferramenta global em um diretório Linux/macOS específico do Windows.
dotnet tool install -g dotnetsay --version 2.0.0

Instala a versão 2.0.0 de dotnetsay como uma ferramenta global.
dotnet tool install -g dotnetsay@2.1.7

Instala a versão 2.1.7 do dotnetsay como uma ferramenta global.
dotnet tool install dotnetsay

Instala dotnetsay como uma ferramenta local para o diretório atual.
dotnet tool install dotnetsay@2.1.7

Instala a versão 2.1.7 do dotnetsay como uma ferramenta local para o diretório atual.
dotnet tool install -g dotnetsay --verbosity minimal

Instala o dotnetsay como uma ferramenta global com o mínimo de detalhamento. O detalhamento padrão da ferramenta global é silenciosa.
dotnet tool install -g dotnetsay --allow-roll-forward

Instala o dotnetsay como uma ferramenta global e permite que ele seja executado em versões mais recentes do .NET se o runtime de destino não estiver disponível.

Confira também

Comentários

Esta página foi útil?

Last updated on 2025-11-12