Atualizar instalações do .NET rastreadas com o dotnetup

Note

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

dotnetup armazena o canal solicitado separadamente da versão resolvida. Uma atualização resolve cada canal contínuo novamente.

Escolher um escopo de atualização

Use um destes comandos:

# Update all tracked SDK and runtime requirements.
dotnetup update

# Update SDK requirements only.
dotnetup sdk update

# Update SDK and runtime requirements.
dotnetup sdk update --all

# Update runtime requirements only.
dotnetup runtime update

As atualizações de runtime incluem os runtimes principais do .NET e do ASP.NET Core. Em Windows, eles também incluem requisitos de runtime do Windows Desktop.

Limitar a raiz de instalação

Por padrão, uma atualização pode processar requisitos para todos os roots no manifesto selecionado. Use --install-path para limitar a operação:

dotnetup update --install-path D:\tools\dotnet

Atualizar arquivos de repositório

Os requisitos do SDK podem usar global.json como fonte. Para gravar a versão do SDK recém-resolvida em cada arquivo de origem, execute:

dotnetup sdk update --update-global-json

Sem essa opção, o dotnetup instala a atualização, mas não edita o arquivo de repositório.

Uma atualização processa os requisitos armazenados antes que a coleta de lixo atualize as fontes global.json alteradas. Depois de alterar o global.json de um repositório, execute dotnetup sdk install nesse repositório antes de atualizar seus requisitos armazenados. Caso contrário, a primeira atualização ainda poderá processar o requisito anterior.

Entenda o comportamento da atualização

  • As versões exatas do SDK e do runtime são ignoradas – elas foram solicitadas explicitamente, portanto, nunca podem ser atualizadas.
  • Cada requisito de instalação é processado de forma independente.
  • O processamento de todos os requisitos de instalação continua após uma falha individual.
  • O comando indica falha depois de processar todos os requisitos de instalação restantes.
  • Atualizações bem-sucedidas executam a coleta de resíduos – um processo de limpeza que remove todos os componentes instalados de que nenhum dos requisitos de instalação configurados realmente precisa.
  • Uma versão instalada permanecerá se outro requisito ainda precisar dela.

Examinar o resultado

Verifique o estado rastreado e as instalações em disco:

dotnetup list

Para saída legível pelo computador:

dotnetup list --format json

Consulte também

  • Última atualização em