Sdílet prostřednictvím

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

  • Článek

Pro ilustraci, jak použít parametry příkazového řádku k instalaci sady Visual Studio, tady je několik příkladů, které 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ředstavují odpovídající edici zaváděcího nástroje sady Visual Studio, což je malý soubor (~ 1 MB), který iniciuje proces stahování. Pokud používáte jinou edici, nahraďte příslušný název spouštěče.

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.

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

Pokud chcete příkazy spouštět neinteraktivně, můžete použít--passive nebo --quiet. Další informace o těchto parametrech najdete na stránce příkazy a parametry příkazového řádku.

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

Aktualizace

  • Aktualizujte instanci sady Visual Studio prostřednictvím příkazového řádku se zobrazením průběhu a bez interaktivních výzev. 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ích uživatelů, pokud jim byla udělena příslušná oprávnění, mohou programově spustit příkaz aktualizace pomocí instalačního programu, ale nemůžou používat --passive nebo --quiet přepínač. 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

  • Pomocí --wait v dávkových souborech nebo skriptech počkejte na dokončení počátečního příkazu před spuštěním dalšího příkazu. Pro dávkové soubory obsahuje proměnná prostředí %ERRORLEVEL% návratovou hodnotu příkazu, což je uvedeno na stránce Použití parametrů příkazového řádku k instalaci Visual Studio. Některé příkazové utility vyžadují další parametry, aby počkaly na dokončení a získaly návratovou hodnotu z 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 pomocí příkazu skriptu PowerShellu Start-Process:

$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 používá bootstraper sady Visual Studio a druhý -Wait používá příkaz 'Start-Process' ke čekání na dokončení. Parametr -PassThru používá Start-Process k tomu, aby použil kód ukončení instalačního programu jako svou návratovou hodnotu.

Pomocí --layout vytvořte rozložení sítě nebo místní mezipaměť.

  • 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 vytváření rozložení najdete na stránce Vytvoření síťové instalace 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 programuje možné nakonfigurovat, kde Visual Studio hledá aktualizace. --channelUri se jinak 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 odpovídajícími oprávněními, můžou pomocí instalačního programu programově spustit příkaz pro úpravy, ale nemůžou používat přepínač --passive ani --quiet. 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

Nemůžete 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 programumůžete z výchozí nainstalované instance sady Visual Studio upravit instalaci a odebrat všechny součásti , které přešly do stavu mimo podporu,. Tento příklad používá instalační program, který je již na klientském počítači nainstalovaný, ke konfiguraci nastavení removeOos. standardním uživatelům, 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 používat --passive nebo --quiet přepínač. 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 cesty pro instalaci, mezipaměť a sdílení:

    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 odpovídajícími oprávněními, můžou pomocí instalačního programu programově spustit příkaz pro úpravy, ale nemůžou používat přepínač --passive ani --quiet. 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" programově nainstalujte nebo aktualizujte sadu Visual Studio na vašich počítačích spolu s dalšími balíčky spravovanými wingetem. Pokud chcete přizpůsobit instalaci a zadat další úlohy a komponenty, můžete použít --override winget přepínače spolu s příkazem install winget 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 soubor .yaml k úpravě existující instalace sady Visual Studio. Tento přístup používá poskytovatele Visual Studio PowerShell DSC, který je zde zdokumentovaný.

Podpora nebo řešení potíží

Někdy se věci můžou pokazit. Pokud instalace sady Visual Studio selže, přečtěte si Řešení potíží s instalací a upgradem sady Visual Studio podrobné pokyny.

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

  • Pro problémy související s instalací použijte možnost podpory prostřednictvím instalačního chatu (pouze 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 vývojářské komunitě sady Visual Studio.

Související obsah