atualização da ferramenta dotnet

  • Artigo

Este artigo aplica-se a: ✔️ SDK do .NET Core 3.1 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>] [--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>] [--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>] [--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

Description

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

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

    Impeça 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.

  • --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 detalhamento do comando. Os valores permitidos são q[uiet], m[inimal], n[ormal], d[etailed], e diag[nostic]. Para obter mais informações, veja 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

Consulte também