atualização da ferramenta dotnet

2025-06-19

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

Nome

dotnet tool update - Atualiza a ferramenta .NET especificada em seu computador.

Sinopse

dotnet tool update <PACKAGE_ID> -g|--global
    [--add-source <SOURCE>] [--all] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update <PACKAGE_ID> --tool-path <PATH>
    [--add-source <SOURCE>] [--all] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive] 
    [--no-cache] [--prerelease]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update <PACKAGE_ID> --local
    [--add-source <SOURCE>] [--all] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update -h|--help

Descrição

O dotnet tool update comando fornece uma maneira de atualizar as ferramentas do .NET em seu computador para a versão estável mais recente do pacote. O comando desinstala e reinstala uma ferramenta, atualizando-a efetivamente. Para usar o comando, especifique uma das seguintes opções:

Para atualizar uma ferramenta global que foi instalada no local padrão, use a opção --global
Para atualizar uma ferramenta global que foi instalada em um local personalizado, use a opção --tool-path .
Para atualizar uma ferramenta local, use a opção --local .

Argumentos

PACKAGE_ID

Nome/ID do pacote NuGet que contém a ferramenta global .NET a ser atualizada. Você pode encontrar o nome do pacote usando o comando da lista de ferramentas dotnet .

Opções

--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?.

--all

Atualize todas as ferramentas.

--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."

--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.

--disable-parallel

Impedir a restauração de vários projetos em paralelo.
--framework <FRAMEWORK>

Especifica a estrutura de destino para a qual atualizar a ferramenta.
-g|--global

Especifica que a atualização é para uma ferramenta de todo o usuário. Não pode ser combinada com a opção --tool-path. Omitir ambos --global e --tool-path especifica que a ferramenta a ser atualizada é uma ferramenta local.

-?|-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

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

Inclua versões de pré-lançamento.
--tool-manifest <PATH>

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

Especifica o local onde a ferramenta global está instalada. PATH pode ser absoluto ou relativo. Não pode ser combinada com a opção --global. Omitir ambos --global e --tool-path especifica que a ferramenta a ser atualizada é uma 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>

O intervalo de versão do pacote de ferramentas para o qual atualizar. Isso não pode ser usado para fazer downgrade de versões, primeiro você deve ter uninstall versões mais recentes.

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

Exemplos

dotnet tool update -g dotnetsay

Atualiza a ferramenta global dotnetsay .
dotnet tool update dotnetsay --tool-path c:\global-tools

Atualiza a ferramenta global do dotnetsay localizada em um diretório específico do Windows.
dotnet tool update dotnetsay --tool-path ~/bin

Atualiza a ferramenta global dotnetsay localizada em um diretório Específico do Linux/macOS.
dotnet tool update dotnetsay

Atualiza a ferramenta local do dotnetsay instalada para o diretório atual.
dotnet tool update -g dotnetsay --version 2.0.*

Atualiza a ferramenta global do dotnetsay para a versão mais recente do patch, com uma versão principal e 2uma versão secundária de 0.
dotnet tool update -g dotnetsay --version (2.0.*,2.1.4)

Atualiza a ferramenta global dotnetsay para a versão mais baixa dentro do intervalo (> 2.0.0 && < 2.1.4)especificado, a versão 2.1.0 seria instalada. Para obter mais informações sobre intervalos de versões semânticas, consulte os intervalos de versões de empacotamento do NuGet.

Compartilhar via