Příklady parametrů příkazového řádku pro instalaci sady Visual Studio

  • Článek

Pro ilustraci použití parametrů příkazového řádku k instalaci sady Visual Studio tady je několik příkladů, které si můžete přizpůsobit podle svých potřeb.

V každém příkladu vs_enterprise.exe, vs_professional.exea vs_community.exe představuje odpovídající edici bootstrapper sady Visual Studio, což je malý (~ 1MB) soubor, který zahájí proces stahování. Pokud používáte jinou edici, nahraďte příslušný název bootstrapperu.

Všechny příkazy vyžadují zvýšení oprávnění správce a výzva k řízení uživatelských účtů se zobrazí, pokud proces není spuštěný z výzvy se zvýšenými oprávněními.

Znak na konci příkazového řádku můžete použít ^ ke zřetězení více řádků do jednoho příkazu. Alternativně můžete tyto čáry umístit na jeden řádek. V PowerShellu je ekvivalentem znak backtick (`).

Seznam úloh a součástí, které můžete nainstalovat pomocí příkazového řádku, najdete na stránce ID úloh a komponent sady Visual Studio.

Instalace pomocí --installPath spolu s bootstrapperem

  • Nainstalujte minimální instanci sady Visual Studio bez interaktivních výzev, ale zobrazuje se průběh:

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

  • Nainstalujte si bezobslužnou instalaci desktopové instance sady Visual Studio s jazykovou sadou pro francouzštinu, která se vrací jenom v případě, že je produkt nainstalovaný.

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

Aktualizovat

  • Aktualizujte instanci sady Visual Studio prostřednictvím příkazového řádku se zobrazeným průběhem a žádné interaktivní výzvy. Tyto řady příkazů můžete spustit ve dvou krocích pomocí bootstrapperu nalezeného v klientovi nebo v rozložení. První příkaz aktualizuje instalační program v klientovi a druhý příkaz aktualizuje produkt sady Visual Studio. Tyto příkazy musíte spustit na příkazovém řádku se zvýšenými oprávněními, protože aktualizace instalačního programu vyžaduje oprávnění správce. Následující příklad simuluje aktualizaci klienta pomocí evergreen bootstrapperu v rozložení.

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

Případně můžete instanci sady Visual Studio aktualizovat v jednom kroku pomocí instalačního programu v klientovi. Standardní uživatelé, pokud jim byla udělena příslušná oprávnění, můžou programově spustit příkaz update pomocí instalačního programu, ale nemůžou ho --passive používat ani --quiet přepnout. Všimněte si, že instalační program nelze inicializovat programově ze stejného adresáře, ve kterém se nachází instalační program.

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

Použití --wait

  • Použijte --wait dávkové soubory nebo skripty a počkejte na dokončení počátečního příkazu před spuštěním dalšího příkazu. U dávkových souborů %ERRORLEVEL% obsahuje proměnná prostředí návratovou hodnotu příkazu, jak je uvedeno v části Použití parametrů příkazového řádku k instalaci stránky sady Visual Studio . Některé nástroje příkazů vyžadují další parametry, které musí počkat na dokončení a získat návratovou hodnotu instalačního programu.

Parametr --wait je podporován pouze bootstrapperem.

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

Následující příkaz je příkladem použití --wait s příkazem Start-Processpowershellového skriptu:

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

nebo

 $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()
  • První --wait se používá pomocí bootstrapperu sady Visual Studio a druhý -Wait se používá příkazem Start-Process k čekání na dokončení. Parametr -PassThru se používá Start-Process k použití ukončovacího kódu instalačního programu pro jeho návratovou hodnotu.

Vytvoření rozložení sítě nebo místní mezipaměti pomocí rozložení --layout

  • Vytvořte rozložení, které zahrnuje pouze základní editor sady Visual Studio (nejmínější konfiguraci sady Visual Studio) a jazykovou sadu pro angličtinu. Další příklady vytvoření rozložení najdete na stránce Vytvořit síťovou instalaci sady Visual Studio .

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

Použití --all k získání celého produktu

  • Spusťte interaktivní instalaci všech úloh a komponent, které jsou k dispozici v edici Visual Studio Enterprise:

    vs_enterprise.exe --all

Použití funkce --includeRecommended

  • Nainstalujte druhou instanci sady Visual Studio Professional pomocí přezdívky na počítači s již nainstalovanou edicí Visual Studio Community s podporou vývoje Node.js:

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

Použití identifikátoru --channelURI

Pomocí nejnovějšího instalačního programu je možné nakonfigurovat, kde Visual Studio hledá aktualizace. Jinak --channelUri se označuje jako aktualizační kanál nebo zdrojové umístění aktualizací. Následující tabulka uvádí ukázkové hodnoty channelId a channelUri a jejich význam.

Název kanálu --channelUri --channelId
Aktuální kanál sady Visual Studio 2022 https://aka.ms/vs/17/release/channel VisualStudio.17.Release
Kanál LTSC sady Visual Studio 2022 17.0 https://aka.ms/vs/17/release.LTSC.17.0/channel VisualStudio.17.Release.LTSC.17.0
Kanál Visual Studio 2022 Preview https://aka.ms/vs/17/pre/channel VisualStudio.17.Preview
Kanál vydání sady Visual Studio 2019 https://aka.ms/vs/16/release/channel VisualStudio.16.Release
Kanál vydání sady Visual Studio 2017 https://aka.ms/vs/15/release/channel VisualStudio.15.Release
Vlastní rozložení – Private Channel \\layoutserver\share\path\channelmanifest.json VisualStudio.17.Release (nebo podle toho, na čem bylo rozložení založeno)

Pokud se rozhodnete použít vlastní rozložení jako aktualizační kanál, mějte na paměti následující pokyny:

Použití --remove

  • Odeberte komponentu Nástroje profilace z výchozí nainstalované instance sady Visual Studio. Tento příklad používá instalační program, který už je nainstalovaný na klientském počítači. Standardní uživatelé s příslušnými oprávněními můžou pomocí instalačního programu programově spustit příkaz pro úpravy, ale nemůžou ho --passive používat ani --quiet přepnout. Všimněte si, že instalační program nelze inicializovat programově ze stejného adresáře, ve kterém se nachází instalační program.

    "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

Nelze použít --remove ve stejném příkazu jako --layout. Jinými slovy není možné z rozložení odebrat komponenty.

Použití příkazu --removeOos

Pomocí nejnovějšího instalačního programu můžete upravit instalaci a odebrat všechny komponenty, které přešly do stavu mimo podporu, z výchozí nainstalované instance sady Visual Studio. Tento příklad používá instalační program, který je již na klientském počítači nainstalovaný, ke konfiguraci nastavení removeOos. Standardní uživatelé, pokud jim byla udělena příslušná oprávnění, můžou pomocí instalačního programu programově spustit příkaz pro úpravy, ale nemůžou ho --passive používat ani --quiet přepnout. Instalační program nelze spustit programově ze stejného adresáře, ve kterém se nachází instalační program.

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

  • Upravte nastavení aktualizace tak, aby se trvale odebraly všechny komponenty, které byly převedeny do stavu mimo podporu při každém aktualizaci produktu:

    "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

Použití --path

Všechny tyto příklady předpokládají, že instalujete nový produkt pomocí bootstrapperu.

  • Použijte instalační, mezipaměť a sdílené cesty:

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

  • Používejte pouze cesty k instalaci a mezipaměti:

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

  • Použijte pouze instalační a sdílené cesty:

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

  • Použijte pouze instalační cestu:

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

Použití exportu

  • Pomocí exportu uložte výběr z instalace. Tento příklad používá instalační program, který už je nainstalovaný na klientském počítači.

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

  • Pomocí exportu můžete vlastní výběr uložit úplně od začátku. Tento příklad používá instalační program, který už je nainstalovaný na klientském počítači.

    "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"

Použití --config

  • Pomocí parametru --config nainstalujte úlohy a komponenty z dříve uloženého konfiguračního souboru instalace:

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

  • Pomocí --config můžete do existující instalace přidat úlohy a komponenty. Tento příklad používá instalační program, který už je nainstalovaný na klientském počítači. Standardní uživatelé s příslušnými oprávněními můžou pomocí instalačního programu programově spustit příkaz pro úpravy, ale nemůžou ho --passive používat ani --quiet přepnout. Instalační program nelze spustit programově ze stejného adresáře, ve kterém se nachází instalační program.

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

  • Ke konfiguraci obsahu rozložení použijte parametr --config:

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

Použití wingetu

Pomocí nástroje Správce balíčků systému Windows winget můžete programově nainstalovat nebo aktualizovat sadu Visual Studio na počítačích spolu s dalšími balíčky spravovanými sadou winget. Pokud chcete přizpůsobit instalaci a zadat další úlohy a komponenty, můžete použít přepínač winget spolu s příkazem install wingetu --override a předat exportovaný soubor vsconfig takto:

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

Můžete také použít winget configure a předat .yaml soubor k úpravě existující instalace sady Visual Studio. Tento přístup používá zprostředkovatele DSC visual Studio PowerShellu, který je zde zdokumentovaný.

Podpora nebo řešení potíží

Někdy se věci můžou pokazit. Pokud se instalace sady Visual Studio nezdaří, pokyny najdete v tématu Řešení potíží s instalací a upgradem sady Visual Studio.

Tady je několik dalších možností podpory:

  • Pro problémy související s instalací nabízíme možnost podpory instalačního chatu (pouze v angličtině).
  • Nahlašte problémy s produktem prostřednictvím nástroje Nahlásit problém, který se zobrazuje jak v Instalační program pro Visual Studio, tak v integrovaném vývojovém prostředí sady Visual Studio. Pokud jste IT Správa istrator a nemáte nainstalovanou sadu Visual Studio, můžete sem odeslat svůj názor na IT Správa.
  • Navrhněte funkci, sledujte problémy s produktem a najděte odpovědi v komunitě vývojářů sady Visual Studio.

Související obsah