Aktualizowanie śledzonych instalacji .NET za pomocą narzędzia dotnetup

Uwaga

dotnetup jest dostępna w publicznej wersji zapoznawczej. Jego funkcje i zachowanie mogą ulec zmianie przed ogólną dostępnością.

dotnetup przechowuje żądany kanał oddzielnie od ustalonej wersji. Aktualizacja ponownie naprawia każdy kanał aktualizacji.

Te aktualizacje nie aktualizują pliku wykonywalnego dotnetup. Aby zaktualizować samo narzędzie, użyj polecenia dotnetup self update.

Wybieranie zakresu aktualizacji

Użyj jednego z następujących poleceń:

# 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

Aktualizacje środowiska uruchomieniowego obejmują środowiska uruchomieniowe .NET Core i ASP.NET Core. W systemie Windows obejmują one również wymagania środowiska uruchomieniowego Windows Desktop.

Ogranicz katalog główny instalacji

Domyślnie aktualizacja może przetwarzać wymagania dotyczące wszystkich korzeni w wybranym manifeście. Użyj --install-path, aby ograniczyć operację:

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

Zaktualizuj pliki repozytorium

Wymagania dotyczące zestawu SDK mogą pochodzić z global.json. Aby zapisać nowo określoną wersję zestawu SDK z powrotem do każdego pliku źródłowego, uruchom polecenie:

dotnetup sdk update --update-global-json

Bez tej opcji dotnetup instaluje aktualizację, ale nie edytuje pliku repozytorium.

Aktualizacja przetwarza przechowywane wymagania, zanim odśmiecanie odświeży zmienione global.json źródła. Po zmianie global.json repozytorium uruchom polecenie dotnetup sdk install z tego repozytorium przed zaktualizowaniem przechowywanych wymagań. W przeciwnym razie pierwsza aktualizacja może nadal przetwarzać poprzednie wymaganie.

Zrozum działanie aktualizacji

  • Dokładne wersje zestawu SDK i środowiska uruchomieniowego są pomijane — zostały jawnie żądane, więc nigdy nie można ich zaktualizować.
  • Każde wymaganie instalacji jest przetwarzane niezależnie.
  • Przetwarzanie wszystkich wymagań dotyczących instalacji jest kontynuowane po wystąpieniu pojedynczego błędu.
  • Polecenie zgłasza błąd po przetworzeniu wszystkich pozostałych wymagań dotyczących instalacji.
  • Pomyślne aktualizacje uruchamiają odśmiecanie pamięci — proces oczyszczania, który usuwa wszystkie zainstalowane składniki, których nie wymagają żadne ze skonfigurowanych wymagań instalacyjnych.
  • Zainstalowana wersja pozostaje, jeśli inne wymaganie nadal jej wymaga.

Przejrzyj wynik

Sprawdź stan śledzony i instalacje na dysku:

dotnetup list

Dane wyjściowe czytelne maszynowo:

dotnetup list --format json

Usuń śledzone wymaganie

Aby usunąć wymaganie dotyczące zestawu SDK, przekaż zapisany kanał lub dokładną wersję:

dotnetup sdk uninstall 10.0.1xx

Odinstaluj usuwa zależność, a następnie czyści instalacje, do których nie ma już odwołań, w całym wybranym katalogu głównym. Ostrzega, jeśli inne wymaganie powoduje zachowanie żądanej instalacji lub jeśli czyszczenie usuwa dodatkowe instalacje. Przed potwierdzeniem operacji przejrzyj te ostrzeżenia. W przypadku automatyzacji nieinteraktywnej użyj polecenia --non-interactive , aby pominąć potwierdzenie, a nie ostrzeżenia.

W przypadku wymagań środowiska uruchomieniowego użyj dotnetup runtime uninstall. Aby uzyskać szczegółowe informacje, zobacz odinstalowywanie zestawu SDK i odinstalowywanie środowiska uruchomieniowego.

Informacje dodatkowe

  • Ostatnia aktualizacja o