Atualizar ou remover dotnetup

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

Vê a versão dotnetup

Mostrar a versão de dotnetup:

dotnetup --version

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

dotnetup --info

Atualize dotnetup

dotnetup não tem um comando que se atualize sozinho. Para atualizar dotnetup, execute novamente o script de download. 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

No sistema Windows, execute o seguinte:

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

O script instala a build mais recente preview por defeito. Se usares a daily compilação ou uma pasta de instalação personalizada, passa as mesmas opções que usaste na 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

No Windows:

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

Uma atualização de dotnetup não altera as tuas instalações, a configuração do ambiente ou as tuas especificações de instalação monitorizadas.

Eliminar dotnetup

Para remover dotnetup e tudo o que gere, complete estes passos por ordem.

1. Localize os diretórios raiz da instalação

Liste as raízes da instalação que dotnetup acompanha:

dotnetup list

Regista cada raiz de instalação que não esteja no diretório de dados dotnetup. Apague estas pastas numa etapa posterior.

2. Remova a configuração do ambiente

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

dotnetup env clear

No shell modo, executa este comando a partir do shell cujo perfil dotnetup mudou, ou seleciona esse shell com essa --shell opção. No modo everywhere no Windows, este comando altera o PATH do sistema e requer elevação.

Este comando não remove SDKs nem runtimes. Para mais informações, consulte Remover configuração do ambiente.

3. Eliminar as pastas de instalação e o diretório de dados

Apaga cada raiz de instalação que registaste no passo 1.

Depois apaga o diretório de dados dotnetup. Este diretório contém a raiz de instalação por defeito, o manifesto, o ficheiro de configuração e a cache de download.

Se definires a DOTNET_DOTNETUP_DATA_DIR variável de ambiente, elimina esse diretório em vez disso e depois remove a variável.

4. Eliminar o executável dotnetup

Apague o diretório que contém o dotnetup executável. Por defeito, o script de download instala dotnetup em ~/.dotnetup. Se adicionares este diretório a PATH manualmente, remove essa entrada do teu perfil de shell ou das variáveis do ambiente do utilizador.

Abra um novo terminal para usar o ambiente atualizado.

Ver também

• Como funciona o dotnetup
• Configuração do ambiente dotnetup
• Comece com o dotnetup