Udostępnij za pośrednictwem

Przykłady parametrów wiersza polecenia dla instalacji programu Visual Studio

  • Artykuł

Aby zilustrować, jak użyć parametrów wiersza polecenia do zainstalowania programu Visual Studio, poniżej przedstawiono kilka przykładów, które można dostosować do własnych potrzeb.

W każdym przykładzie vs_enterprise.exe, vs_professional.exei vs_community.exe reprezentują odpowiednią edycję programu uruchamiającego Visual Studio, który jest małym plikiem (~ 1 MB) inicjującym proces pobierania. Jeśli używasz innej wersji, zastąp odpowiednią nazwą programu inicjującego.

Wszystkie polecenia wymagają podniesienia uprawnień administracyjnych, a monit kontroli konta użytkownika zostanie wyświetlony, jeśli proces nie zostanie uruchomiony z poziomu wiersza polecenia z podwyższonym poziomem uprawnień.

Możesz użyć znaku ^ na końcu wiersza polecenia, aby połączyć wiele wierszy w jedno polecenie. Alternatywnie można umieścić te wiersze na jednym poziomie. W programie PowerShell odpowiednikiem jest znak backtick (`).

Aby wykonywać polecenia w sposób nieinterakcyjny, można użyć--passive lub --quiet. Aby uzyskać więcej informacji na temat tych parametrów, odwiedź stronę poleceń i parametrów wiersza polecenia.

Aby uzyskać listę obciążeń i składników, które można zainstalować przy użyciu wiersza polecenia, zobacz stronę identyfikatory obciążeń i składników programu Visual Studio.

Zainstaluj używając --installPath oraz --add razem z bootstrapperem

  • Zainstaluj minimalną wersję Visual Studio bez monitów interaktywnych, z wyświetlanym postępem.

    vs_enterprise.exe --installPath C:\minVS ^
--add Microsoft.VisualStudio.Workload.CoreEditor ^
--passive --norestart

  • Zainstaluj wersję stacjonarną programu Visual Studio w trybie cichym, korzystając z francuskiego pakietu językowego, zwracając wynik tylko wtedy, gdy produkt jest zainstalowany.

    vs_enterprise.exe --installPath C:\desktopVS ^
--addProductLang fr-FR ^
--add Microsoft.VisualStudio.Workload.ManagedDesktop ^
--includeRecommended --quiet --wait

Aktualizacja

  • Zaktualizuj wystąpienie programu Visual Studio za pomocą wiersza polecenia z wyświetlonym postępem i bez interakcyjnych monitów. Możesz uruchomić te serie poleceń w dwóch krokach, używając programu inicjjącego znajdującego się na kliencie lub w układzie. Pierwsze polecenie aktualizuje instalatora na kliencie, a drugie polecenie aktualizuje produkt Visual Studio. Należy uruchomić te polecenia w wierszu polecenia z podwyższonym poziomem uprawnień, ponieważ aktualizacja instalatora wymaga uprawnień administratora. W poniższym przykładzie symulowane jest aktualizowanie klienta przy użyciu bootstrappera evergreen w układzie.

    \\layoutserver\share\path\vs_enterprise.exe --update --quiet --wait
\\layoutserver\share\path\vs_enterprise.exe update --wait --passive --norestart --installPath "C:\installPathVS"

Alternatywnie możesz również zaktualizować swoją instancję Visual Studio w jednym kroku, używając klienckiego instalatora. użytkownicy standardowi, jeśli otrzymali odpowiednie uprawnienia, mogą programowo wykonać polecenie aktualizacji przy użyciu instalatora, ale nie mogą używać przełącznika --passive lub --quiet. Należy pamiętać, że nie można programowo zainicjować instalatora z tego samego katalogu, w którym znajduje się instalator.

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" update --passive --norestart --installPath "C:\installPathVS"

Korzystanie z --wait

  • Użyj --wait w plikach wsadowych lub skryptach, aby poczekać na ukończenie początkowego polecenia przed wykonaniem następnego polecenia. W przypadku plików wsadowych zmienna środowiskowa %ERRORLEVEL% zawiera wartość zwracaną polecenia, jak opisano w Użyj parametrów wiersza polecenia do zainstalowania strony programu Visual Studio. Niektóre narzędzia poleceń wymagają zastosowania dodatkowych parametrów, aby umożliwić oczekiwanie na ukończenie i uzyskanie wartości zwracanej przez instalatora.

Parametr --wait jest obsługiwany tylko przez program inicjujący.

start /wait vs_professional.exe --installPath "C:\VS" --passive --wait > nul
echo %errorlevel%

Następujące polecenie to przykład użycia --wait za pomocą polecenia skryptu programu PowerShell Start-Process:

$process = Start-Process -FilePath vs_enterprise.exe -ArgumentList "--installPath", "C:\VS", "--passive", "--wait" -Wait -PassThru
Write-Output $process.ExitCode

lub

 $startInfo = New-Object System.Diagnostics.ProcessStartInfo
 $startInfo.FileName = "vs_enterprise.exe"
 $startInfo.Arguments = "--all --quiet --wait"
 $process = New-Object System.Diagnostics.Process
 $process.StartInfo = $startInfo
 $process.Start()
 $process.WaitForExit()
  • Pierwszy --wait jest używany przez instalator Visual Studio, a drugi -Wait jest używany przez polecenie 'Start-Process', które czeka na zakończenie działania. Parametr -PassThru jest używany przez Start-Process, aby wykorzystać kod zakończenia instalatora jako wartość zwracaną.

Używanie opcji --layout do stworzenia struktury sieciowej lub lokalnej pamięci podręcznej

  • Utwórz układ zawierający tylko edytor podstawowy programu Visual Studio (najbardziej minimalną konfigurację programu Visual Studio) i pakiet językowy w języku angielskim. Więcej przykładów tworzenia układu można znaleźć na stronie Tworzenie instalacji sieciowej programu Visual Studio.

    vs_professional.exe --layout "C:\VS" ^
--lang en-US ^
--add Microsoft.VisualStudio.Workload.CoreEditor ^

Użycie --all w celu uzyskania całego produktu

  • Rozpocznij interaktywną instalację wszystkich obciążeń i składników dostępnych w wersji Visual Studio Enterprise:

    vs_enterprise.exe --all

Korzystanie z --includeRecommended

  • Zainstaluj drugą instancję programu Visual Studio Professional, korzystając z pseudonimu, na komputerze z już zainstalowaną wersją Visual Studio Community, z obsługą rozwoju Node.js:

    vs_professional.exe --installPath C:\VSforNode ^
--add Microsoft.VisualStudio.Workload.Node --includeRecommended --nickname VSforNode

Korzystanie z --channelURI

Korzystając z najnowszego instalatora, można skonfigurować miejsce, w którym program Visual Studio sprawdza dostępność aktualizacji. --channelUri jest inaczej znany jako kanał aktualizacji lub lokalizacja źródłowa aktualizacji. W poniższej tabeli przedstawiono przykładowe wartości identyfikatorów channelId i channelUri oraz ich znaczenie.

nazwa kanału --channelUri --channelId
Bieżący kanał programu Visual Studio 2022 https://aka.ms/vs/17/release/channel VisualStudio.17.Release
Kanał LTSC programu Visual Studio 2022 17.0 https://aka.ms/vs/17/release.LTSC.17.0/channel VisualStudio.17.Release.LTSC.17.0
Kanał programu Visual Studio 2022 (wersja zapoznawcza) https://aka.ms/vs/17/pre/channel VisualStudio.17.Preview
Kanał wydania programu Visual Studio 2019 https://aka.ms/vs/16/release/channel VisualStudio.16.Release
Kanał wydania programu Visual Studio 2017 https://aka.ms/vs/15/release/channel VisualStudio.15.Release
Układ niestandardowy — kanał prywatny \\layoutserver\share\path\channelmanifest.json VisualStudio.17.Release (lub cokolwiek to było na podstawie układu)

Jeśli zdecydujesz się użyć niestandardowego układu jako kanału aktualizacji, pamiętaj o następujących wytycznych:

Korzystanie z --remove

  • Usuń składnik Narzędzia profilowania z domyślnego zainstalowanego wystąpienia programu Visual Studio. W tym przykładzie użyto instalatora zainstalowanego już na komputerze klienckim. Użytkownicy standardowi z odpowiednimi uprawnieniami mogą programowo wykonać polecenie modyfikacji przy użyciu instalatora, ale nie mogą używać przełącznika --passive lub --quiet. Należy pamiętać, że nie można programowo zainicjować instalatora z tego samego katalogu, w którym znajduje się instalator.

    "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify ^
--installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
--remove Microsoft.VisualStudio.Component.DiagnosticTools ^
--passive

Nie można użyć --remove w tym samym poleceniu co --layout. Innymi słowy, nie można usunąć składników z układu.

Korzystanie z --removeOos

Korzystając z najnowszego instalatora, można zmodyfikować instalację i usunąć wszystkie składniki, które przeszły do stanu braku obsługi z domyślnego zainstalowanego wystąpienia programu Visual Studio. W tym przykładzie instalator już zainstalowany na komputerze klienckim służy do skonfigurowania ustawienia removeOos. użytkownicy standardowi, jeśli otrzymali odpowiednie uprawnienia, mogą programowo wykonać polecenie modyfikacji przy użyciu instalatora, ale nie mogą używać przełącznika --passive lub --quiet. Nie można zainicjować instalatora programowo z tego samego katalogu, w którym znajduje się instalator.

 "C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^
 --installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
 --removeOos true ^
 --passive

  • Dostosuj ustawienia aktualizacji, aby trwale usunąć wszystkie składniki przenoszone do stanu poza wsparciem za każdym razem, gdy produkt zostanie zaktualizowany:

    "C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^
--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

Korzystanie z --path

We wszystkich tych przykładach przyjęto, że instalujesz nowy produkt używając programu bootstrapper.

  • Użyj ścieżek instalacji, pamięci podręcznej i udostępnionych:

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache" --path shared="C:\VS\shared"

  • Użyj tylko ścieżek instalacji i pamięci podręcznej:

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache"

  • Używaj tylko ścieżek do instalacji i ścieżek udostępnionych.

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path shared="C:\VS\shared"

  • Użyj tylko ścieżki instalacji:

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS"

Korzystanie z eksportu

  • Użyj eksportu, aby zapisać wybór z instalacji. W tym przykładzie użyto instalatora zainstalowanego już na komputerze klienckim.

    "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" export --installPath "C:\VS" --config "C:\my.vsconfig"

  • Użyj eksportu, aby zapisać wybór niestandardowy od podstaw. W tym przykładzie użyto instalatora zainstalowanego już na komputerze klienckim.

    "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" export --channelId VisualStudio.17.Release --productId Microsoft.VisualStudio.Product.Enterprise --add Microsoft.VisualStudio.Workload.ManagedDesktop --includeRecommended --config "C:\my.vsconfig"

Korzystanie z opcji --config

  • Użyj --config, aby zainstalować obciążenia i składniki z wcześniej zapisanego pliku konfiguracji instalacji:

    vs_enterprise.exe --config "C:\my.vsconfig" --installPath "C:\VS"

  • Użyj --config, aby dodać obciążenia i składniki do istniejącej instalacji. W tym przykładzie użyto instalatora zainstalowanego już na komputerze klienckim. Użytkownicy standardowi z odpowiednimi uprawnieniami mogą programowo wykonać polecenie modyfikacji przy użyciu instalatora, ale nie mogą używać przełącznika --passive lub --quiet. Nie można zainicjować instalatora programowo z tego samego katalogu, w którym znajduje się instalator.

    "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\VS" --config "C:\my.vsconfig"

  • Użyj --config, aby skonfigurować zawartość układu:

    vs_enterprise.exe --layout C:\layout --config "C:\my.vsconfig"

Korzystanie z winget

Użyj narzędzia Windows Package Manager "winget", aby programowo zainstalować lub zaktualizować program Visual Studio na maszynach wraz z innymi pakietami zarządzanymi przez winget. Aby dostosować instalację i określić inne obciążenia i składniki, możesz użyć przełącznika --override programu winget wraz z poleceniem install programu winget i przekazać wyeksportowany plik vsconfig w następujący sposób:

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

Możesz również użyć winget configure i przekazać plik .yaml, aby zmodyfikować istniejącą instalację programu Visual Studio. W tym podejściu użyto dostawcy DSC programu Visual Studio PowerShell, który jest udokumentowany tutaj.

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 obsługi czatu instalacji (tylko w języku angielskim) w przypadku problemów związanych z instalacją.
  • 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ć opinię administratora IT.
  • Zasugeruj funkcję, śledź problemy z produktami i znajdź odpowiedzi w witrynie Visual Studio Developer Community.

Powiązana zawartość