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

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 a --add 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:

• --channelUri musí odkazovat na soubor "channelmanifest.json" ve vlastním rozložení.
• Správci můžou nakonfigurovat způsob zobrazení vlastního rozložení Private Channel v uživatelském rozhraní nastavení aktualizace konfigurací nastavení registru klienta.

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 --override wingetu install 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:

• V případě problémů souvisejících s instalací použijte podpůrnou možnost instalačního chatu, která je jenom v angličtině.
• Nahlašte nám problémy s produktem pomocí nástroje Nahlásit problém, který se zobrazí v instalačním programu sady Visual Studio i v integrovaném vývojovém prostředí sady Visual Studio. Pokud jste správce IT a nemáte nainstalovanou sadu Visual Studio, můžete odeslat zpětnou vazbu správce IT.
• Navrhněte funkci, sledujte problémy s produktem a najděte odpovědi v komunitě vývojářů sady Visual Studio.

Související obsah

• Příručka správce sady Visual Studio
• Instalace sady Visual Studio s použitím parametrů příkazového řádku
• Vytvoření síťové instalace sady Visual Studio
• ID úloh a komponent sady Visual Studio