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

  • Artykuł

Aby zilustrować sposób używania 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.exevs_professional.exei vs_community.exe reprezentuje odpowiednią edycję programu Visual Studio inicjujące, czyli mały plik (~ 1 MB), który inicjuje proces pobierania. Jeśli używasz innej wersji, zastąp odpowiednią nazwę programu inicjją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 w jednym wierszu. W programie PowerShell odpowiednikiem jest znak backtick (`).

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.

Instalowanie przy użyciu polecenia --installPath obok programu inicjjącego

  • Zainstaluj minimalne wystąpienie programu Visual Studio bez interakcyjnych monitów, ale wyświetlany postęp:

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

  • Zainstaluj wystąpienie pulpitu programu Visual Studio w trybie dyskretnym, korzystając z francuskiego pakietu językowego, zwracając tylko wtedy, gdy produkt jest zainstalowany.

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

Zaktualizuj

  • 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 symuluje aktualizowanie klienta przy użyciu evergreen bootstrapper 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ć wystąpienie programu Visual Studio w jednym kroku przy użyciu instalatora na kliencie. 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 polecenia wsadowego lub skryptów, aby poczekać na ukończenie początkowego polecenia przed wykonaniem następnego polecenia. W przypadku plików wsadowych zmienna %ERRORLEVEL% środowiskowa zawiera wartość zwracaną polecenia, zgodnie z opisem na stronie Instalowanie programu Visual Studio za pomocą parametrów wiersza polecenia. Niektóre narzędzia poleceń wymagają innych parametrów, aby czekać na ukończenie i uzyskać wartość zwracaną 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 jest przykładem użycia za pomocą --wait polecenia Start-Processskryptu programu PowerShell :

$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 program inicjujący programu Visual Studio, a drugi -Wait jest używany przez polecenie "Start-Process", aby poczekać na zakończenie. Parametr -PassThru jest używany przez Start-Process program do używania kodu zakończenia instalatora dla jego wartości zwracanej.

Używanie --layout do tworzenia układu sieciowego 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żywanie --all do 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 drugie wystąpienie programu Visual Studio Professional przy użyciu pseudonimu na komputerze z już zainstalowanym programem Visual Studio Community Edition z obsługą programowania 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 szuka aktualizacji. Element --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 dowolny układ był oparty na)

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 wykonywać polecenie modyfikując 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 pomocy technicznej z domyślnego zainstalowanego wystąpienia programu Visual Studio. W tym przykładzie instalator jest już zainstalowany na komputerze klienckim, aby skonfigurować ustawienie removeOos. Użytkownicy standardowi, jeśli otrzymali odpowiednie uprawnienia, mogą programowo wykonać polecenie modyfikując 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 założono, że instalujesz nowy produkt przy użyciu programu inicjującego.

  • 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żyj tylko ścieżek instalacji i 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 polecenia --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 wykonywać polecenie modyfikując 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 zestawu winget

Użyj narzędzia Menedżer pakietów systemu Windows "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 zestawu winget wraz z poleceniem winget install 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 pliku i przekazać go, aby zmodyfikować istniejącą instalację .yaml programu Visual Studio. W tym podejściu użyto dostawcy DSC programu Visual Studio PowerShell, który został opisany 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:

  • Oferujemy opcję obsługi czatu instalacyjnego (tylko w języku angielskim) w przypadku problemów związanych z instalacją.
  • Zgłoś problemy z produktami za pośrednictwem narzędzia Zgłoś problem, które jest wyświetlane zarówno w Instalator programu Visual Studio, jak i w środowisku IDE programu Visual Studio. Jeśli jesteś Administracja istratorem IT i nie masz zainstalowanego programu Visual Studio, możesz przesłać tutaj opinię Administracja IT.
  • Zasugeruj funkcję, śledź problemy z produktami i znajdź odpowiedzi w społeczności deweloperów programu Visual Studio.

Powiązana zawartość