dotnet tool update

Este artigo se aplica a: ✔️ SDK do .NET Core 2.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>] [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive] [--no-cache]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

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

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

dotnet tool update -h|--help

Descrição

O comando fornece uma maneira de atualizar as ferramentas do .NET em seu computador para dotnet tool update 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 --global opção
  • Para atualizar uma ferramenta global que foi instalada em um local personalizado, use a --tool-path opção .
  • Para atualizar uma ferramenta local, use a --local opção .

As ferramentas locais estão disponíveis a partir do SDK do .NET Core 3.0.

Argumentos

  • PACKAGE_ID

    Nome/ID do pacote NuGet que contém a ferramenta global do .NET a ser atualizada. Encontre o nome do pacote usando o comando dotnet tool list.

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 alguma ordem de precedência. Se o mesmo pacote e versão estiver em vários feeds, o feed mais rápido vence. para obter mais informações, consulte o que acontece quando um pacote de NuGet é instalado?.

  • --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 Common NuGet configurations.

  • --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 destina-se a uma ferramenta de todos os usuários. Não pode ser combinada com a opção --tool-path. Omitir --global e especifica que a ferramenta a ser atualizada é uma ferramenta --tool-path 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 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 opção --tool-path .

  • --no-cache

    Não armazenar em cache pacotes e solicitações HTTP.

  • --tool-manifest <PATH>

    Caminho para o arquivo de manifesto.

  • --tool-path <PATH>

    Especifica o local em que a ferramenta global está instalada. PATH pode ser absoluto ou relativo. Não pode ser combinada com a opção --global. Omitir --global e especifica que a ferramenta a ser atualizada é uma ferramenta --tool-path 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 a ser atualizado. Isso não pode ser usado para fazer downgrade de versões, você deve uninstall primeiro ter versões mais recentes.

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 Windows específico.

  • 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 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 --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 2.1.0 versão seria instalada. Para obter mais informações sobre intervalos de controle de versão semânticos, consulte NuGet de versão de empacotamento.

Confira também