Instalowanie, aktualizowanie i zarządzanie programem Visual Studio za pomocą parametrów wiersza polecenia

Podczas instalowania programu Visual Studio programowo lub z poziomu wiersza polecenia można użyć różnych parametrów wiersza polecenia do kontrolowania lub dostosowywania instalacji w celu wykonania następujących akcji:

• Uruchom instalację na kliencie z wybranymi wstępnie opcjami i zachowaniami.
• Automatyzowanie procesu instalacji lub aktualizacji.
• Utwórz lub zachowaj układ sieciowy plików produktu na potrzeby instalowania lub aktualizowania maszyn klienckich.

Następujące czasowniki i parametry wiersza polecenia mogą być używane z następującymi plikami wykonywalnymi lub programami:

• Program rozruchowy instalatora, który jest małym plikiem (ok. 1 MB), np. vs_enterprise.exe, inicjuje proces pobierania i początkową instalację.
• Instalator programu Visual Studio, który może być już zainstalowany na maszynie i znajduje się w folderze C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe. Instalator należy zainicjować programowo z innego katalogu, w którym znajduje się instalator. Instalator jest zwykle używany do aktualizowania lub modyfikowania poleceń.
• Za pomocą polecenia winget przy użyciu przełącznika --override winget.
• Aby programowo zaktualizować układ sieciowy, użyj pakietu aktualizacji administratora, który jest dostępny do pobrania z katalogu usługi Microsoft Update. Więcej informacji można znaleźć w artykule dotyczącym aktualizacji lub modyfikowania układu.

Nie wszystkie polecenia lub parametry działają w każdej z tych sytuacji, a wszelkie specjalne zastrzeżenia lub wyjątki są udokumentowane. Ponadto w niektórych scenariuszach być może nie masz dostępu do wszystkich opisanych wcześniej plików wykonywalnych. Na przykład maszyny klienckie mogą mieć instalator dostępny tylko do uruchamiania w sposób programowy, jeśli program Visual Studio został zainstalowany poprzez układ instalacyjny.

Aby uzyskać najnowsze instalatory startowe dla programu Visual Studio 2022, które zawsze instalują najnowszą wersję bieżącego kanału, pobierz jeden z plików z poniższej tabeli. Alternatywnie, aby zainstalować określoną wersję lub określony kanał programu Visual Studio 2022, zobacz stronę Historia wersji programu Visual Studio 2022. Ta strona zawiera linki do stałych wersji programów bootstrappingowych dla każdego wydania serwisowego.

Wydanie	inicjator
Visual Studio 2022 Enterprise	vs_enterprise.exe
Visual Studio 2022 Professional	vs_professional.exe
Visual Studio 2022 Community	vs_community.exe
Visual Studio 2022 Narzędzia kompilacji	vs_buildtools.exe

Napiwek

Jeśli wcześniej pobrano plik programu inicjjącego i chcesz sprawdzić, jaka wersja zostanie zainstalowana, oto jak to zrobić. W systemie Windows otwórz Eksploratora plików, kliknij prawym przyciskiem myszy plik bootstrappera, wybierz pozycję Właściwości, a następnie wybierz kartę Szczegóły. Pole Wersja produktu będzie opisywać kanał oraz wersję, które zostaną zainstalowane przez bootstrapper. Numer wersji powinien być zawsze interpretowany jako "najnowsza określona wersja serwisowania", a kanał to Aktualny, chyba że zostało to wyraźnie określone. Dlatego program rozruchowy z wersją produktu LTSC 17.0 zainstaluje najnowszą wersję serwisową 17.0.x, która jest dostępna w kanale LTSC 17.0. Inicjator z wersją produktu, która po prostu określa Visual Studio 2022, zainstaluje najnowszą wersję Visual Studio 2022 w bieżącym kanale.

Instalowanie, aktualizowanie, modyfikowanie, naprawianie, odinstalowywanie i eksportowanie poleceń oraz parametry wiersza polecenia

Podczas wywoływania inicjatora Visual Studio lub instalatora programowo w celu zainstalowania produktu lub utrzymania układu:

• Pierwszy parametr to polecenie (zlecenie), które opisuje operację do wykonania.
• Kolejne opcjonalne parametry wiersza polecenia, wszystkie poprzedzone dwoma kreskami (--), dodatkowo definiują sposób, w jaki ta operacja ma się zdarzyć.

Wszystkie parametry wiersza polecenia programu Visual Studio nie są rozróżniane pod względem wielkości liter, a więcej przykładów można znaleźć na stronie przykłady parametrów wiersza polecenia.

Przykład składni: vs_enterprise.exe [command] <optional parameters>...

polecenie	Opis
(puste)	Domyślne polecenie instaluje zarówno produkt, jak i jest używane dla wszystkich operacji konserwacji układu.
modify	Modyfikuje zainstalowany produkt.
update	Aktualizuje zainstalowany produkt.
updateall	Aktualizuje wszystkie zainstalowane produkty w kolejności sekwencyjnej. Współpracuje z parametrami --quiet i --passive.
repair	Naprawia zainstalowany produkt.
uninstall	Odinstalowuje zainstalowany produkt.
export	Eksportuje konfigurację instalacji do pliku *.vsconfig.

Ważny

Podczas określania wielu różnych obciążeń, składników lub języków należy dla każdego elementu powtórzyć przełącznik wiersza polecenia --add lub --remove.

parametrów	Opis
--installPath <dir>	Dla domyślnego polecenia instalacji ten parametr jest opcjonalny i opisuje, gdzie instancja jest zainstalowana na maszynie klienckiej. W przypadku innych poleceń, takich jak aktualizacja lub modyfikowanie, ten parametr jest Wymagany i określa katalog instalacyjny dla wystąpienia do działania.
--productId <id>	Opcjonalne: identyfikator wystąpienia produktu, który jest modyfikowany i używany z --channelId. productID to coś takiego jak "Microsoft.VisualStudio.Product.Enterprise".
--channelUri	Opcjonalne: w trakcie polecenia aktualizacji można przekazać nowy --channelUri, aby zmienić lokalizację ustawień aktualizacji. Zaleca się parowanie z parametrem --installPath, aby było jawne, które wystąpienie programu Visual Studio konfigurujesz. Zobacz przykłady składni dla , --channelUri,
--channelId <id>	Identyfikator kanału, na przykład VisualStudio.17.Release. Zobacz przykłady składni --channelId. channelId jest wymagany w przypadku operacji modyfikowania, a także --productID lub --installPath.
--add <one or more workload or component IDs>	Opcjonalne: W trakcie wykonywania polecenia instalacji lub modyfikacji, ten powtarzalny parametr określa jeden lub więcej identyfikatorów obciążenia lub składnika do dodania. Wymagane składniki artefaktu są zainstalowane, ale nie są to zalecane lub opcjonalne składniki. Inne składniki można kontrolować globalnie przy użyciu parametrów --includeRecommended i/lub --includeOptional. Aby uwzględnić wiele obciążeń lub składników, powtórz polecenie --add (na przykład --add Workload1 --add Workload2). W przypadku bardziej szczegółowej kontrolki można dołączyć ;includeRecommended lub ;includeOptional do identyfikatora (na przykład --add Workload1;includeRecommended lub --add Workload2;includeRecommended;includeOptional). Aby uzyskać więcej informacji, zobacz stronę Obciążenia i identyfikatory składników.
--all	opcjonalne: podczas instalacji lub modyfikowania polecenia ten parametr powoduje zainstalowanie wszystkich obciążeń i składników produktu.
--allWorkloads	opcjonalne: podczas instalacji lub modyfikowania polecenia ten parametr instaluje wszystkie obciążenia i składniki, ale nie są to zalecane ani opcjonalne składniki.
--includeRecommended	opcjonalne: podczas instalacji lub modyfikowania polecenia ten parametr zawiera zalecane składniki dla wszystkich zainstalowanych obciążeń. Nie zawiera składników opcjonalnych. Obciążenia są określane za pomocą --allWorkloads lub --add. Należy pamiętać, że używając parametru --includeRecommended, włączysz okno dialogowe Ustawień aktualizacji , aby „dodać zalecane składniki dla zainstalowanych obciążeń podczas aktualizacji”. Aby zmienić to ustawienie, zobacz Dostosowywanie ustawień aktualizacji.
--includeOptional	opcjonalne: podczas instalacji lub modyfikowania polecenia ten parametr zawiera opcjonalne składniki dla wszystkich zainstalowanych obciążeń. Nie zawiera zalecanych składników. Obciążenia są określane za pomocą --allWorkloads lub --add.
--addProductLang <language-locale>	Opcjonalne: podczas polecenia instalacji lub modyfikacji ten powtarzalny parametr określa pakiety językowe interfejsu użytkownika, które należy zainstalować z produktem. Jeśli nie istnieje, instalacja używa pakietu językowego odpowiadającego ustawień regionalnych maszyny. Aby uzyskać więcej informacji, sprawdź [Listę ustawień językowych].
--remove <one or more workload or component IDs>	opcjonalne: Podczas modyfikowania polecenia parametr ten, który można powtórzyć, określa jeden lub więcej identyfikatorów obciążenia albo składnika do usunięcia. Uzupełnia i zachowuje się podobnie do parametru --add.
(#lista języków i ustawień regionalnych) na tej stronie.
--removeProductLang <language-locale>	Opcjonalne: Podczas instalacji lub modyfikacji polecenia ten powtarzalny parametr określa, które pakiety językowe interfejsu użytkownika należy usunąć z produktu. Uzupełnia i zachowuje się podobnie do parametru --addProductLang.
--in <path>	opcjonalne: identyfikator URI lub ścieżka do pliku odpowiedzi , który może zawierać ustawienia konfiguracji.
--quiet	opcjonalne: używany z dowolnym poleceniem, ten parametr uniemożliwia wyświetlanie dowolnego interfejsu użytkownika podczas wykonywania polecenia. Nie można używać programowo przez użytkowników standardowych niezależnie od tego, jak ustawiono zasad AllowStandardUserControl.
--passive, -p	opcjonalne: ten parametr powoduje wyświetlanie interfejsu użytkownika w sposób nieinterakcyjny. Ten parametr jest wzajemnie wykluczający się z (i w rzeczywistości zastępuje) parametrem --quiet. Nie jest również dostępny do programowego używania przez użytkowników standardowych niezależnie od tego, jak ustawiono zasady AllowStandardUserControl.
--norestart	opcjonalne: ten parametr musi być sparowany z parametrami --passive lub --quiet. Podczas instalowania, aktualizowania lub modyfikowania polecenia dodanie parametru --norestart opóźnia wszelkie niezbędne ponowne uruchomienie.
--force	Opcjonalne: ten parametr powoduje zamknięcie programu Visual Studio, nawet jeśli jakikolwiek proces programu Visual Studio jest w użyciu. Wymuszanie zamknięcia programu Visual Studio może spowodować utratę pracy, dlatego należy użyć go ostrożnie.
--installWhileDownloading	opcjonalne: podczas instalacji, aktualizacji lub modyfikowania polecenia ten parametr umożliwia programowi Visual Studio pobieranie i instalowanie produktu równolegle. Jest to środowisko domyślne.
--downloadThenInstall	Opcjonalne: podczas instalacji, aktualizacji lub modyfikowania polecenia ten parametr wymusza na Visual Studio pobranie wszystkich plików przed ich zainstalowaniem. Wzajemnie się wyklucza z parametru --installWhileDownloading.
--nickname <name>	opcjonalne: podczas polecenia instalacji ten parametr definiuje pseudonim do przypisania do zainstalowanego produktu. Pseudonim nie może być dłuższy niż 10 znaków.
--productKey	opcjonalne: podczas polecenia instalacji ten parametr definiuje klucz produktu do użycia dla zainstalowanego produktu. Klucz produktu składa się z 25 znaków alfanumerycznych w formacie xxxxxxxxxxxxxxxxxxxxxxxxx.
--removeOos true	Parametr opcjonalny: Podczas wykonywania polecenia instalacji, aktualizacji lub modyfikacji, ten parametr, a następnie true lub false, określa, czy Instalator programu Visual Studio ma usunąć wszystkie zainstalowane składniki, które przeszły w stan braku wsparcia. To zachowanie ma zastosowanie w przypadku pojedynczego zdarzenia. Jeśli chcesz, aby to zachowanie było trwałe, zastosuj ten parametr do polecenia modyfikujUstawienia, opisanego później, lub skonfiguruj globalną zasadę removeOOS. Przydatne do zapewnienia bezpieczeństwa maszyny.
--config <path to *.vsconfig file>	Opcjonalne: Podczas operacji instalacji lub modyfikacji można przekazać plik konfiguracji za pomocą parametru --config, aby określić obciążenia, komponenty lub rozszerzenia do dodania na podstawie wcześniej zapisanego pliku konfiguracji instalacji. Ta operacja jest tylko addytywne; nie usuwa żadnych elementów, które nie zostały określone w pliku. Ponadto elementy określone w pliku konfiguracji, które nie mają zastosowania do produktu, nie są dodawane. Zdecydowanie zaleca się określenie w pełni kwalifikowanej ścieżki do pliku konfiguracji. Podczas operacji eksportowania ten parametr określa lokalizację zapisywania pliku konfiguracji instalacji.
--allowUnsignedExtensions	Opcjonalne: podczas operacji instalacji lub modyfikowania w kontekście --passive lub --quiet przy użyciu pliku --config, jeśli rozszerzenia są określone w pliku konfiguracyjnym, ten parametr jest niezbędny do ładowania rozszerzeń bez podpisu cyfrowego.
--installerOnly	opcjonalne: podczas operacji instalacji lub aktualizacji ten parametr nakazuje Instalatorowi programu Visual Studio zainstalowanie samego siebie (instalatora), a nie produktu Visual Studio. Jego funkcjonalność odpowiada parametrowi --update, ale bardziej intuicyjnemu. Ma być używany podczas preppingu i wstępnego konfigurowania maszyn klienckich.
--help, --?, -h, -?	Wyświetla wersję tej strony w trybie offline.

Polecenie dotyczące układu i parametry wiersza polecenia

Wszystkie operacje zarządzania układem, takie jak tworzenie lub aktualizowanie układu, są uruchamiane przy użyciu bootstrappera exe i zakładają, że domyślnym poleceniem jest Instalacja (domyślnie puste). Wszystkie operacje zarządzania układem powinny rozpoczynać się od wymaganego --layout parametru początkowego. W poniższej tabeli opisano inne parametry, których można użyć do utworzenia lub zaktualizowania układu za pomocą wiersza polecenia.

parametry układu	Opis
--layout <dir>	Określa katalog, aby utworzyć lub zaktualizować pamięć podręczną instalacji offline. Aby uzyskać więcej informacji, zobacz Tworzenie instalacji Visual Studio bazującej na sieci.
--lang <one or more language-locales>	opcjonalne: używane z --layout do przygotowania pamięci instalacyjnej w trybie offline z pakietami zasobów dla jednego lub więcej określonych języków. Aby uzyskać więcej informacji, zobacz na tej stronie sekcję dotyczącą Listy lokalizacji językowych.
--add <one or more workload or component IDs>	Opcjonalne: Jeden lub więcej identyfikatorów zadań lub składników do dodania. Wymagane składniki artefaktu są zainstalowane, ale nie są to zalecane lub opcjonalne składniki. Więcej składników można kontrolować globalnie przy użyciu --includeRecommended i/lub --includeOptional. W przypadku bardziej szczegółowej kontrolki można dołączyć ;includeRecommended lub ;includeOptional do identyfikatora (na przykład --add Workload1;includeRecommended lub --add Workload2;includeOptional). Aby uzyskać więcej informacji, zobacz stronę Obciążenia i identyfikatory składników. Uwaga: jeśli jest używana --add, pobierane są tylko określone obciążenia i składniki oraz ich zależności. Jeśli --add nie jest określony, wszystkie zadania i składniki są pobierane do układu.
--includeRecommended	OPCJONALNE: Zawiera zalecane składniki dla jakichkolwiek zainstalowanych obciążeń, ale nie składników opcjonalnych. Obciążenia są określane za pomocą --allWorkloads lub --add.
--includeOptional	Opcjonalne: zawiera zalecane i opcjonalne składniki do dowolnych obciążeń uwzględnianych w układzie. Obciążenia są określane za pomocą --add.
--wait	Opcjonalne: Proces czeka na zakończenie instalacji przed zwróceniem kodu wyjścia. wait jest przydatna podczas automatyzowania instalacji, w których należy poczekać na zakończenie instalacji, aby obsłużyć kod powrotny z tej instalacji. Parametr --wait można przekazać tylko do programu inicjującego; instalator (setup.exe) nie obsługuje go. Jest to przydatne podczas aktualizowania układów. Więcej przykładów można znaleźć tutaj.
--useLatestInstaller	Opcjonalne: Funkcjonalność dziedziczona, mająca zastosowanie tylko do programów bootstrappingu Visual Studio starszych niż kwiecień 2023 r. Wszystkie elementy wysyłane po kwietniu 2023 r. domyślnie używają najnowszego instalatora. Jeśli ten parametr jest obecny, najnowsza wersja Instalatora programu Visual Studio jest uwzględniona w układzie, nawet jeśli należy do nowszej wersji głównej produktu. Najnowszy instalator może być przydatny, jeśli chcesz skorzystać z nowych funkcji lub poprawek błędów dostępnych w najnowszej wersji. Aby uzyskać więcej informacji, zobacz Konfigurowanie układu, aby zawsze używać najnowszej dokumentacji instalatora.
--config <path to *.vsconfig file>	opcjonalne: jeśli istnieje, program Visual Studio używa zawartości pliku konfiguracji do skonfigurowania układu. Upewnij się, że określono w pełni kwalifikowaną ścieżkę do pliku konfiguracji.
--noWeb	Opcjonalne: Jeśli istnieje, instalator programu Visual Studio używa plików w katalogu do instalacji do zainstalowania programu Visual Studio i nie pobiera żadnych pakietów z Internetu. Jeśli użytkownik spróbuje zainstalować składniki, które nie są w układzie, instalacja zakończy się niepowodzeniem. Nie używaj tego parametru, jeśli próbujesz wdrożyć układ hostowany w wewnętrznej witrynie internetowej intranetu. Aby uzyskać więcej informacji, zobacz Instalacja na kliencie, który nie ma dostępu do Internetu. Ważne: parametr --noWeb nie zatrzymuje Instalatora programu Visual Studio na komputerze klienckim połączonym z Internetem przed sprawdzeniem aktualizacji, jeśli klient jest skonfigurowany do wyszukiwania serwerów hostowanych przez firmę Microsoft pod kątem aktualizacji. W takim przypadku --noWeb po prostu uniemożliwia klientowi pobieranie pakietów produktów.
--verify	Opcjonalne: Sprawdź zawartość układu. Zostaną wyświetlone wszystkie uszkodzone lub brakujące pliki.
--fix	Opcjonalne: Sprawdź zawartość układu. Jeśli jakiekolwiek pliki są uszkodzone lub brakuje, zostaną one pobrane ponownie. Aby naprawić układ, wymagany jest dostęp do Internetu.
--clean <one or more paths to catalogs>	opcjonalne: usuwa stare wersje składników z układu zaktualizowanego do nowszej wersji.

zaawansowane parametry układu	Opis
--channelId <id>	opcjonalne: identyfikator kanału dla instancji, która ma być zainstalowana, reprezentowany jako VisualStudio.17.Release. identyfikator channelId jest wymagany dla polecenia instalacji i ignorowany dla innych poleceń, jeśli określono --installPath. Zobacz przykłady składni dla --channelId.
--channelUri <uri>	Opcjonalne: identyfikator URI manifestu kanału. Ta wartość określa lokalizację źródłową aktualizacji, a wartość początkowa jest skonfigurowana jako w pliku response.json układu. Zapoznaj się z przykładami składni --channelUri, aby uzyskać możliwe wartości. Jeśli aktualizacje nie są pożądane, --channelUri może wskazać nieistniejący plik (na przykład --channelUri C:\doesntExist.chman). Tego parametru można użyć dla polecenia instalacji; inne polecenia ignorują je.
--installChannelUri <uri>	Opcjonalny: Identyfikator URI manifestu kanału do użycia na potrzeby instalacji. Identyfikator URI określony przez --channelUri (który należy określić po określeniu --installChannelUri) jest używany do wykrywania aktualizacji. Tego parametru można użyć dla polecenia instalacji; inne polecenia ignorują je.
--installCatalogUri <uri>	opcjonalne: identyfikator URI manifestu katalogu do użycia na potrzeby instalacji. Jeśli zostanie określone, menedżer kanału próbuje pobrać manifest katalogu z tego identyfikatora URI, zanim użyje go w manifeście kanału instalacji. Ten parametr służy do obsługi instalacji w trybie offline, w której cache układu jest tworzony z wykazem produktów już pobranym. Tego parametru można użyć dla polecenia instalacji; inne polecenia ignorują je.
--productId <id>	opcjonalne: Identyfikator produktu dla wystąpienia, które jest zainstalowane. Ten parametr jest wstępnie wypełniany w normalnych warunkach instalacji. productID to coś takiego jak "Microsoft.VisualStudio.Product.Enterprise".
--arch all	Opcjonalnie: Domyślnie układy są tworzone tylko z binariami produktów x64. Aby uwzględnić pliki binarne ARM dla odpowiednich obciążeń razem z plikami binarnymi x64 w rozmieszczeniu, użyj parametru --arch all lub --arch *. Aby utworzyć układ tylko z binarnych plików ARM, użyj --arch arm64
--keepLayoutVersion	Opcjonalne: Zastosuj zmiany w układzie bez aktualizowania wersji produktu zawartej w układzie.
--locale <language-locale>	opcjonalne: zmień język wyświetlania interfejsu użytkownika dla samego instalatora. Ustawienie zostanie utrwalone. Aby uzyskać więcej informacji, zobacz na tej stronie sekcję dotyczącą Listy lokalizacji językowych.
--cache	opcjonalne: Jeśli występują, pakiety będą przechowywane po zainstalowaniu do późniejszych napraw. Spowoduje to zastąpienie globalnego ustawienia zasad, które ma być używane do kolejnych instalacji, napraw lub modyfikacji. Domyślne zasady to buforowanie pakietów. Jest to ignorowane dla polecenia odinstaluj. Aby uzyskać więcej informacji, przeczytaj, jak wyłączyć lub przenieść pamięć podręczną pakietu.
--nocache	Opcjonalne: Jeśli są obecne, pakiety zostaną usunięte po zainstalowaniu lub naprawie. Zostaną one ponownie pobrane tylko w razie potrzeby i usunięte ponownie po użyciu. Spowoduje to zastąpienie globalnego ustawienia zasad, które ma być używane do kolejnych instalacji, napraw lub modyfikacji. Domyślne zasady to buforowanie pakietów. Jest to ignorowane dla polecenia odinstaluj. Aby uzyskać więcej informacji, przeczytaj, jak wyłączyć lub przenieść pamięć podręczną pakietu.
--noUpdateInstaller	Opcjonalne: jeśli jest obecny, uniemożliwia instalatorowi aktualizowanie się, kiedy tryb cichy jest określony. Program instalacyjny zakończy się niepowodzeniem i zwróci niezerowy kod zakończenia, jeśli parametr noUpdateInstaller zostanie użyty w trybie cichym, gdy wymagana jest aktualizacja instalatora.
--path <name>=<path>	Opcjonalne: służy do określania niestandardowych ścieżek instalacji. Obsługiwane nazwy ścieżek są współużytkowane, buforowane i instalowane.
--path cache=<path>	Opcjonalne: Używa określonej lokalizacji do pobrania plików instalacyjnych. Tę lokalizację można ustawić tylko przy pierwszym zainstalowaniu programu Visual Studio. Przykład: --path cache="C:\VS\cache"
--path shared=<path>	Opcjonalne: Zawiera wspólne pliki dla instalacji Visual Studio zainstalowanych obok siebie. Niektóre narzędzia i zestawy SDK są instalowane w lokalizacji na tym dysku, podczas gdy inne mogą zmienić to ustawienie i zainstalować się na innym dysku. Przykład: --path shared="C:\VS\shared" Ważne: można to ustawić tylko raz i przy pierwszym zainstalowaniu programu Visual Studio.
--path install=<path>	opcjonalne: odpowiednik –-installPath. W szczególności --installPath "C:\VS" i --path install="C:\VS" są równoważne. Jednocześnie można używać tylko jednego z tych poleceń.

Polecenie ModifySettings i parametry wiersza polecenia

Możesz zmodyfikować ustawienia aktualizacji i programowo skonfigurować lokalizację źródłową aktualizacji dla danego wystąpienia programu Visual Studio przy użyciu instalatora lub programu inicjatora na komputerze klienckim, a następnie przekazać polecenie modifySettings i żądany kanał aktualizacji.

polecenie	Opis
modifySettings	Czasownik używany do modyfikowania ustawień aktualizacji określonego wystąpienia programu Visual Studio.

zmieńUstawienia parametry	Opis
--installPath <dir>	Zalecane do użycia w celu określenia instancji programu Visual Studio, na której ma być wykonane działanie.
--newChannelUri	Wymagany: identyfikator URI manifestu kanału. Ta wartość określa, gdzie będzie znajdować się następna lokalizacja źródłowa aktualizacji. Zapoznaj się z przykładami składni --channelUri, aby uzyskać możliwe wartości. Jeśli aktualizacje nie są pożądane, --channelUri może wskazać nieistniejący plik (na przykład --channelUri C:\doesntExist.chman).
--channelUri	Identyfikator URI starego manifestu kanału. Można użyć, jeśli polecenie --installPath nie jest znane. Należy używać w połączeniu z identyfikatorem productID, aby zidentyfikować odpowiednie wystąpienie do wykonania.
--productId <id>	Należy użyć, jeśli określono --channelUri, aby zidentyfikować właściwe wystąpienie, na którym należy działać. productID to coś takiego jak "Microsoft.VisualStudio.Product.Enterprise".
--includeRecommended	opcjonalne: podczas polecenia modifySettings ten parametr (który musi mieć słowo true lub false natychmiast po nim) informuje instalatora programu Visual Studio o wyłączeniu funkcji "dodaj zalecane składniki dla zainstalowanych obciążeń podczas aktualizacji" w oknie dialogowym Ustawienie aktualizacji.
--quiet	opcjonalne: ten parametr uniemożliwia wyświetlanie dowolnego interfejsu użytkownika podczas wykonywania polecenia. Nie jest dostępny programowo przez użytkowników standardowych .
--removeOos true	opcjonalne: podczas polecenia modifySettings ten parametr (który musi mieć słowo true lub false zaraz po sobie) informuje instalatora programu Visual Studio, aby trwale usuwał (lub nie usuwał) wszystkie zainstalowane składniki, które przeszły w stan braku wsparcia. Przydatne do zapewnienia bezpieczeństwa maszyny.

Przykłady składni:

C:\>"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modifySettings --installPath "C:\Program Files\Microsoft\Visual Studio\2022\Enterprise" --newChannelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --removeOos true

 C:\>"C:\Program Files\Microsoft\Visual Studio\2022\Enterprise\vs_enterprise.exe" modifySettings --channelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --productID Microsoft.VisualStudio.Product.Enterprise --newChannelUri \\layoutserver\share\path\channelmanifest.json --removeOos true --quiet

Polecenie wycofania i parametry wiersza polecenia

Począwszy od programu Visual Studio 2022, można wycofać aktualizację programowo przy użyciu instalatora na komputerze klienckim i przekazać polecenie wycofania obok wystąpienia ścieżki instalacji.

polecenie	Opis
rollback	Polecenie wycofania określonego wystąpienia programu Visual Studio do wcześniej zainstalowanej aktualizacji. To polecenie nie będzie działać, jeśli DisableRollback jest włączona.

parametry wycofywania	Opis
--installPath <dir>	Zalecane do użycia w celu określenia instancji programu Visual Studio, na której ma być wykonane działanie.

Przykłady składni:

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" rollback -–installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise"

Aktualizacja poleceń i parametrów wiersza polecenia przez administratora

Możesz pobrać aktualizacji administratora z katalogu usługi Microsoft Update i użyć go do zaktualizowania instalacji klienta lub układu.

Aktualizowanie układu

Jeśli aktualizujesz układ do określonej wersji programu Visual Studio, po prostu pobierz aktualizację administratora na komputer hostujący układ, otwórz wiersz polecenia na tym komputerze i uruchom polecenie w następujący sposób:

visualstudioupdate-17.0.0to17.1.5.exe layout --layoutPath c:\VSLayout

Aktualizowanie klienta

Na kliencie, jeśli pobierzesz aktualizację administratora do katalogu instalacyjnego na komputerze klienckim, wystarczy kliknąć dwukrotnie plik, aby zastosować aktualizację. Możesz również otworzyć okno polecenia i przekazać niektóre z poniższych parametrów, aby zmienić domyślne zachowanie.

Konfigurowanie aktualizacji administratora w programie SCCM

Jeśli wdrażasz aktualizację administratora za pomocą programu Microsoft Endpoint Manager (SCCM), możesz zmodyfikować pakiet, aby dostosować zachowanie przy użyciu poniższych parametrów. Parametry można również kontrolować za pomocą pliku konfiguracji na komputerze klienckim. Aby uzyskać więcej informacji, zobacz Metody konfigurowania aktualizacji administratora.

Należy pamiętać, że wszystkie parametry aktualizacji administratora są domyślnie uruchamiane w kontekście "update", chyba że określono czasownik układu.

parametry aktualizacji administratora	Opis
--installerUpdateArgs [optional parameters]	Ten parametr działa jako "tablica przekazywania" określonych parametrów, które są istotne dla scenariuszy aktualizacji administratora. Opcjonalne parametry, które są włączone w tym celu, to: --quiet: Jest to domyślne doświadczenie aktualizacji administratora i jest wymienione tutaj dla kompletności. --passive: ten parametr zastępuje parametr --quiet. Powoduje to, że interfejs użytkownika pojawia się w sposób nieinterakcyjny. --norestart: ten parametr musi być używany w połączeniu z --quiet lub --passive i powoduje opóźnienie wszelkich niezbędnych ponownych uruchomień. --noWeb: ten parametr uniemożliwia programowi Visual Studio sprawdzanie w Internecie pod kątem aktualizacji produktu. --force: ten parametr wymusza zamknięcie programu Visual Studio nawet wtedy, gdy program Visual Studio jest w użyciu. Użyj tego parametru z ostrożnością, ponieważ może to spowodować utratę pracy. Ten parametr musi być używany tylko wtedy, gdy aktualizacja administratora jest wykonywana w kontekście użytkownika; Jest on ignorowany, jeśli aktualizacja administratora jest wykonywana w kontekście systemu. --installWhileDownloading: ten parametr umożliwia programowi Visual Studio pobranie i zainstalowanie produktu równolegle. Jest to domyślne środowisko aktualizacji administratora i jest wymienione tutaj w celu uzyskania kompletności. --keepWindowsUpdateOn: ten parametr uniemożliwia instalatorowi wyłączenie agenta usługi Windows Update na kliencie. Ten parametr należy użyć, jeśli importujesz aktualizację administratora z katalogu do programu SCCM. Może być również konieczne ustawienie limitu czasu pakietu SCCM na wartość dłuższą niż domyślna 10 minut. Zmiana typu wdrożenia programu SCCM na Wymagany sprawia, że ten parametr jest niepotrzebny. --downloadThenInstall: ten parametr wymusza pobranie wszystkich plików przez program Visual Studio przed ich zainstalowaniem. Wzajemnie się wyklucza z parametru --installWhileDownloading.
--checkPendingReboot	Aktualizacja zostanie przerwana, jeśli na maszynie wystąpi oczekujący ponowny rozruch, niezależnie od tego, która aplikacja mogła ją spowodować. Wartością domyślną jest brak sprawdzania oczekujących ponownych uruchomień.

Przykład składni przekazywania parametrów do aktualizacji wykonanej przez administratora:

visualstudioupdate-16.9.0to16.9.4.exe --installerUpdateArgs=--force,--noWeb,--keepWindowsUpdateOn --checkPendingReboot

Usuwanie poleceń kanału i parametrów wiersza polecenia

Kanały, które są dostępne do aktualizacji, są buforowane na kliencie i z czasem mogą powodować bałagan. Możesz ręcznie usunąć kanały aktualizacji , uruchamiając Instalator programu Visual Studio, przełączając się na kartę Dostępne i klikając X w prawym górnym rogu karty produktu. Za pomocą polecenia removeChannel można programowo usuwać kanały (na przykład starsze lokalizacje układu). Można uruchomić vswhere programowo na komputerze klienckim, aby określić, które kanały są buforowane na komputerze klienckim.

polecenie	Opis
removeChannel	Polecenie usunięcia kanału z komputera klienckiego.

parametrów removeChannel	Opis
--channelUri	** Wymagane URI starego manifestu kanału.
--quiet	Opcjonalne Ten parametr uniemożliwia wyświetlanie dowolnego interfejsu użytkownika podczas wykonywania polecenia.
--passive	Opcjonalne Ten parametr zastępuje parametr --quiet. Powoduje to, że interfejs użytkownika pojawia się w sposób nieinterakcyjny.

Przykład składni:

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" removeChannel --channelUri "\\\\server\\share\\layoutdirectory\\ChannelManifest.json"

Instalowanie lub modyfikowanie programu Visual Studio za pomocą zestawu winget

Możesz użyć narzędzia Windows Package Manager "winget" do programowego instalowania, modyfikowania lub aktualizowania programu Visual Studio na swoim komputerze, a także innych pakietów zarządzanych przez winget.

Domyślnie winget po prostu instaluje podstawowe obciążenie programu Visual Studio.

winget install --id Microsoft.VisualStudio.2022.Community

Jeśli jednak chcesz dostosować instalację i określić dodatkowe obciążenia i składniki do uzyskania podczas początkowej instalacji, możesz użyć przełącznika --override zestawu winget wraz z poleceniem install zestawu skrzydłowego i przekazać wyeksportowany plik vsconfig, który zawiera obciążenia i składniki do dodania:

winget install --id Microsoft.VisualStudio.2022.Community --override "--passive --config c:\my.vsconfig"

Oczywiście można również dołączać składniki bezpośrednio podczas początkowej instalacji, w następujący sposób:

 winget install --id Microsoft.VisualStudio.2022.Community --override "--quiet --add Microsoft.Visualstudio.Workload.Azure"

Jeśli na maszynie jest już zainstalowany program Visual Studio, można użyć polecenia configureconfigure zestawu, a także dostawcy DSC programu Visual Studio powerShell, pliku yaml i pliku vsconfig, aby dodać składniki do istniejącej instalacji programu Visual Studio. Polecenie Winget configure zasadniczo działa jako operacja "modyfikacji" programu Visual Studio. Zobacz , jak utworzyć plik konfiguracji WinGet, aby nauczyć się tworzyć konfigurację winget.

Nie można użyć przełącznika --override ani dostawcy DSC dla Visual Studio wraz z poleceniem winget upgrade, ponieważ upgrade zasadniczo działa jako operacja "aktualizacji" w Visual Studio i instaluje najnowszą wersję tych składników, które zostały już wybrane. Nie można dodawać składników za pośrednictwem aktualizacji/uaktualnienia. Aby dodać składniki, należy użyć configure narzędzia winget.

Należy pamiętać, że operacje Instalatora programu Visual Studio wymagają obecnie uprawnień administratora, więc winget wyświetli monit o podniesienie uprawnień, jeśli jest to konieczne, aby ukończyć polecenie. Ponadto obecnie nie można użyć zestawu winget do zainstalowania wielu wersji (czyli różnych jednostek SKU) ani wielu wystąpień tej samej jednostki SKU w tym samym czasie na maszynie klienckiej. Na koniec program Visual Studio musi zostać zamknięty, jeśli zamierzasz skonfigurować (zmodyfikować) go w celu dodania składników lub uaktualnić go do najnowszej wersji.

Lista identyfikatorów obciążeń i identyfikatorów składników

Aby uzyskać listę identyfikatorów obciążeń i komponentów posortowanych według produktów Visual Studio, zobacz stronę identyfikatory obciążeń i komponentów w Visual Studio.

Lista ustawień regionalnych języka

ustawienia regionalne języka	Language
Cs-cz	Czeski
De-de	Niemiecki
En-us	Angielski
Es-es	Hiszpański
Fr-fr	Francuski
It-it	Włoski
Ja-jp	Japoński
Ko-kr	Koreański
Pl-pl	Polski
Pt-br	Portugalski — Brazylia
Ru-ru	Rosyjski
Tr-tr	Turecki
Zh-cn	Chiński — uproszczony
Zh-tw	Chiński — tradycyjny

Kody błędów

W zależności od wyniku operacji zmienna środowiskowa %ERRORLEVEL% jest ustawiona na jedną z następujących wartości:

wartość	wynik
0	Operacja została ukończona pomyślnie
740	Wymagane podwyższenie
1001	Proces instalatora programu Visual Studio jest uruchomiony
1003	Program Visual Studio jest w użyciu
1602	Operacja została anulowana
1618	Inna instalacja uruchomiona
1641	Operacja została ukończona pomyślnie, a zainicjowano ponowny rozruch
3010	Operacja została ukończona pomyślnie, ale instalacja wymaga ponownego uruchomienia, zanim będzie można go użyć
5003	Bootstrapper nie mógł pobrać instalatora
5004	Operacja została anulowana
5005	Błąd analizy wiersza polecenia programu inicjatora
5007	Operacja została zablokowana — komputer nie spełnia wymagań
8001	Awaria kontrolna maszyny ARM
8002	Niepowodzenie wstępnej kontroli pobierania w tle
8003	Awaria możliwa do wyboru z braku wsparcia
8004	Błąd katalogu docelowego
8005	Niepowodzenie weryfikacji ładunków źródłowych
8006	Uruchomione procesy programu Visual Studio
8010	System operacyjny nie jest obsługiwany. Zapoznaj się z Wymagania systemowe
-1073720687	Błąd łączności
-1073741510	Instalator programu Microsoft Visual Studio został zakończony (przez użytkownika lub proces zewnętrzny)
Inne (na przykład: -1, 1, 1603)	Wystąpiła usterka — sprawdź dzienniki, aby uzyskać więcej informacji

Każda operacja generuje kilka plików dziennika w katalogu %TEMP%, które wskazują postęp instalacji. Posortuj folder według daty i poszukaj plików zaczynających się na dd_bootstrapper, dd_clienti dd_setup, odpowiednio dla bootstrappera, aplikacji instalacyjnej i silnika konfiguracji.

Pomoc techniczna lub rozwiązywanie problemów

Czasami coś może pójść źle. Jeśli instalacja programu Visual Studio nie powiedzie się, zobacz Rozwiązywanie problemów z instalacją i uaktualnianiem programu Visual Studio, aby uzyskać szczegółowe wskazówki.

Oto kilka dodatkowych opcji pomocy technicznej:

• Użyj opcji czatu wsparcia instalacji dla problemów związanych z instalacją (tylko w języku angielskim).
• Zgłoś problemy z produktem za pomocą narzędzia Zgłoś problem, które jest wyświetlane zarówno w Instalatorze programu Visual Studio, jak i w środowisku IDE programu Visual Studio. Jeśli jesteś administratorem IT i nie masz zainstalowanego programu Visual Studio, możesz przesłać feedback administratora IT.
• Zasugeruj funkcję, śledź problemy z produktami i znajdź odpowiedzi w witrynie Visual Studio Developer Community.

Powiązana zawartość

• Przykłady parametrów wiersza polecenia do instalacji programu Visual Studio
• Tworzenie instalacji programu Visual Studio w trybie offline
• Automatyzowanie instalacji programu Visual Studio przy użyciu pliku odpowiedzi
• identyfikatory obciążeń i składników programu Visual Studio