atualização da ferramenta dotnet

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

Nome

dotnet tool update - Atualiza a ferramenta .NET especificada em sua máquina.

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] [--source <SOURCE>]
    [-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] [--source <SOURCE>]
    [-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] [--source <SOURCE>]
    [--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 .NET em sua máquina 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 instalada no local padrão, use a --global opção
Para atualizar uma ferramenta global instalada em um local personalizado, use a --tool-path opção.
Para atualizar uma ferramenta local, use a --local opção.

Argumentos

PACKAGE_ID

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

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

Você pode encontrar o nome do pacote usando o comando dotnet tool list .

Opções

--add-source <SOURCE>

Adiciona uma fonte de pacote NuGet adicional para usar durante a instalação. Os feeds são acessados em paralelo, não sequencialmente em alguma ordem de precedência. Se o mesmo pacote e versão estiverem em vários feeds, o feed mais rápido vence. Para obter mais informações, consulte 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 .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 especificado, somente as configurações desse arquivo serão usadas. Se não for especificado, a hierarquia de arquivos de configuração do diretório atual será usada. Para obter mais informações, consulte Configurações comuns do NuGet.
--disable-parallel

Impede 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 combinado com a --tool-path opção. Omitindo 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

Trate as falhas de origem do pacote como avisos.
--interactive

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

Atualize a ferramenta e o manifesto da ferramenta local. Não pode ser combinado com a --global opção ou a --tool-path opção.
--no-cache

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

Inclua versões de pré-lançamento.
--source <SOURCE>

Especifica a origem dos pacotes NuGet.
--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 combinado com a --global opção. Omitindo ambos --global e --tool-path especifica que a ferramenta a ser atualizada é uma ferramenta local.
-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]. Para obter mais informações, consulte LoggerVerbosity.
--version <VERSION>

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

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 major.minor, 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 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 Linux/macOS específico.
dotnet tool update dotnetsay

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

Atualiza a ferramenta global dotnetsay para a versão mais recente do patch, com uma versão principal do 2, e uma versão secundária do 0.
dotnet tool update -g dotnetsay@2.1.7*

Atualiza a ferramenta global dotnetsay para a versão mais recente do patch, 2.1.7.
dotnet tool update -g dotnetsay --version (2.0.0,2.1.7)

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

Ver também

Feedback

Esta página foi útil?

Last updated on 2025-11-12