Atualizar ou remover dotnetup

Note

dotnetup está em versão prévia pública. Seus recursos e comportamento podem mudar antes da disponibilidade geral.

Este artigo descreve como gerenciar a própria ferramenta dotnetup. Para atualizar ou remover os SDKs .NET e os runtimes que dotnetup gerencia, consulte Atualizar instalações.

Verificar a versão dotnetup

Mostrar a versão de dotnetup:

dotnetup --version

Para também mostrar o commit, a arquitetura, o identificador de runtime e as instalações verificadas, execute:

dotnetup --info

Atualizar dotnetup

dotnetup não tem um comando para atualizá-lo. Para atualizar dotnetup, execute o script de download novamente. O script substitui o executável existente dotnetup no diretório de instalação.

No macOS ou Linux, execute:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh | bash

Em Windows, execute:

irm https://aka.ms/dotnetup/get-dotnetup.ps1 | iex

O script instala o build mais recente preview por padrão. Se você usar o daily build ou um diretório de instalação personalizado, passe as mesmas opções usadas para a primeira instalação. Por exemplo, no macOS ou linux:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh |
  bash -s -- --quality daily --install-dir /opt/dotnetup

Em Windows:

iex "& { $(irm https://aka.ms/dotnetup/get-dotnetup.ps1) } -Quality daily -InstallDir C:\tools\dotnetup"

Uma atualização de dotnetup não altera suas instalações, sua configuração de ambiente ou suas especificações de instalação controladas.

Remover dotnetup

Para remover dotnetup e tudo o que ele gerencia, conclua estas etapas em ordem.

1. Encontre seus diretórios de instalação

Liste as raízes de instalação que dotnetup rastreia:

dotnetup list

Registre cada raiz de instalação que não está no diretório de dados dotnetup. Você exclui essas pastas em uma etapa posterior.

2. Remover a configuração do ambiente

Remova as PATH e dotnetup alterações que DOTNET_ROOT fez:

dotnetup env clear

No shell modo, execute esse comando no shell cujo perfil dotnetup foi alterado ou selecione esse shell com a opção --shell . No modo everywhere no Windows, esse comando altera o PATH do sistema e requer elevação.

Esse comando não remove SDKs ou runtimes. Para obter mais informações, consulte Remover configuração de ambiente.

3. Excluir as raízes de instalação e o diretório de dados

Exclua cada raiz de instalação que você registrou na etapa 1.

Em seguida, exclua o diretório de dados dotnetup. Esse diretório contém a raiz de instalação padrão, o manifesto, o arquivo de configuração e o cache de download.

Sistema operacional Diretório de dados padrão
Windows %LOCALAPPDATA%\dotnetup
macOS ~/Library/Application Support/dotnetup
Linux $XDG_DATA_HOME/dotnetupou ~/.local/share/dotnetup quando XDG_DATA_HOME não está definido

Se você definir a variável de ambiente DOTNET_DOTNETUP_DATA_DIR, exclua esse diretório em vez disso e remova a variável.

4. Excluir o executável dotnetup

Exclua o diretório que contém o dotnetup executável. Por padrão, o script de download instala dotnetup em ~/.dotnetup. Se você adicionou esse diretório PATH manualmente, remova essa entrada do seu perfil de shell ou das variáveis de ambiente do usuário.

Abra um novo terminal para usar o ambiente atualizado.

Consulte também

  • Última atualização em