Použití parametrů příkazového řádku k instalaci, aktualizaci a správě sady Visual Studio
Při instalaci sady Visual Studio prostřednictvím kódu programu nebo z příkazového řádku můžete k řízení nebo přizpůsobení instalace použít různé parametry příkazového řádku, abyste mohli provádět následující akce:
- Spusťte instalaci na klientovi s předem vybranými možnostmi a chováními.
- Automatizujte proces instalace nebo aktualizace.
- Vytvořte nebo udržujte síťové rozložení souborů produktů pro instalaci nebo aktualizaci klientských počítačů.
Následující příkazy a parametry příkazového řádku lze použít s následujícími spustitelnými soubory nebo programy:
- Instalační bootstrapper, což je malý (~1 MB) soubor (například vs_enterprise.exe), který inicializuje proces stahování a počáteční instalaci.
- Instalační program sady Visual Studio, který již může být nainstalován na počítači a je umístěn ve složce
C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe. Instalační program musíte inicializovat z jiného adresáře, ve kterém se instalační program nachází. Instalační program se obvykle používá k aktualizaci nebo úpravě příkazů. - Pomocí příkazu winget pomocí přepínače --override winget.
- S balíčkem Aktualizace správce, který je k dispozici ke stažení z katalogu služby Microsoft Update, můžete aktualizovat rozložení sítě prostřednictvím kódu programu. Další informace najdete v článku o aktualizaci nebo úpravě rozložení .
Ne všechny příkazy nebo parametry fungují v každé z těchto situací a jsou zdokumentované jakékoli zvláštní upozornění nebo výjimky. V některých scénářích navíc možná nemáte přístup ke všem těmto spustitelným souborům popsaným výše. Klientské počítače můžou mít například k dispozici instalační program pouze v případě, že byla sada Visual Studio nainstalována prostřednictvím rozložení.
Z následující tabulky můžete získat bootstrappery sady Visual Studio 2019. Případně pokud chcete konkrétní verzi sady Visual Studio 2019, podívejte se na stránku Vydání sady Visual Studio 2019. Tato stránka obsahuje odkazy na zaváděcí nástroje s pevnou verzí pro zvolenou verzi a edici sady Visual Studio.
| Edice | Bootstrapper |
|---|---|
| Visual Studio 2019 Enterprise verze 16.11 | vs_enterprise.exe |
| Visual Studio 2019 Professional verze 16.11 | vs_professional.exe |
| Visual Studio 2019 Build Tools verze 16.11 | vs_buildtools.exe |
Pokud chcete získat nejnovější bootstrappery pro Visual Studio 2022, které vždy nainstalují nejnovější verzi aktuálního kanálu, stáhněte si jeden ze souborů v následující tabulce. Další možností je instalace konkrétní verze nebo konkrétního kanálu sady Visual Studio 2022 na stránce Historie verzí sady Visual Studio 2022. Tato stránka obsahuje odkazy na zaváděcí nástroje s pevnou verzí pro každou servisní verzi.
| Edice | Bootstrapper |
|---|---|
| Visual Studio 2022 Enterprise | vs_enterprise.exe |
| Visual Studio 2022 Professional | vs_professional.exe |
| Visual Studio 2022 Community | vs_community.exe |
| Visual Studio 2022 Build Tools | vs_buildtools.exe |
Tip
Pokud jste si dříve stáhli soubor bootstrapperu a chcete ověřit jeho verzi, tady je postup. Ve Windows otevřete Průzkumník souborů, klikněte pravým tlačítkem myši na soubor bootstrapperu, zvolte Vlastnosti, zvolte kartu Podrobnosti a pak zobrazte číslo verze produktu. Pokud chcete toto číslo spárovat s vydáním sady Visual Studio, podívejte se na tabulku v dolní části stránky vydané verze sady Visual Studio 2019.
Tip
Pokud jste si dříve stáhli soubor bootstrapperu a chcete ověřit, jakou verzi se nainstaluje, tady je postup. Ve Windows otevřete Průzkumník souborů, klikněte pravým tlačítkem myši na soubor bootstrapperu, zvolte Vlastnosti a pak zvolte kartu Podrobnosti. Pole Verze produktu popisuje kanál a verzi, kterou bude bootstrapper instalovat. Číslo verze by se vždy mělo číst jako "nejnovější servisní verze zadaného" a kanál je Aktuální, pokud není explicitně zadán. Takže bootstrapper s produktovou verzí LTSC 17.0 nainstaluje nejnovější servisní verzi 17.0.x, která je k dispozici v kanálu LTSC 17.0. Bootstrapper s verzí produktu, která jednoduše říká, že Visual Studio 2022 nainstaluje nejnovější verzi sady Visual Studio 2022 do aktuálního kanálu.
Instalace, aktualizace, úprava, oprava, odinstalace a export příkazů a parametrů příkazového řádku
Při vyvolání bootstrapperu sady Visual Studio nebo instalačního programu pro instalaci produktu nebo zachování rozložení:
- Prvním parametrem je příkaz (příkaz), který popisuje operaci, která se má provést.
- Další volitelné parametry příkazového řádku, všechny předpony dvěma pomlčkami (--), dále definují, jak se má tato operace stát.
Všechny parametry příkazového řádku sady Visual Studio nerozlišují malá a velká písmena a další příklady najdete na stránce s příklady parametrů příkazového řádku.
Příklad syntaxe: vs_enterprise.exe [command] <optional parameters>...
| Příkaz | Popis |
|---|---|
| (prázdné) | Výchozí příkaz nainstaluje produkt a používá se pro všechny operace údržby rozložení. |
modify |
Upraví nainstalovaný produkt. |
update |
Aktualizuje nainstalovaný produkt. |
updateall |
Aktualizuje všechny nainstalované produkty v sekvenčním pořadí. Funguje s --quiet parametry.--passive |
repair |
Opraví nainstalovaný produkt. |
uninstall |
Odinstaluje nainstalovaný produkt. |
export |
Exportuje konfiguraci instalace do *.vsconfig souboru. |
Důležité
Při zadávání více různých úloh nebo komponent nebo jazyků je nutné pro každou položku opakovat --add přepínač příkazového --remove řádku.
| Parametry | Popis |
|---|---|
--installPath <dir> |
Pro výchozí příkaz install je tento parametr Nepovinný a popisuje, kde je instance nainstalovaná na klientském počítači. Pro další příkazy, jako je aktualizace nebo úprava, je tento parametr povinný a označuje instalační adresář, na který má instance reagovat. |
--productId <id> |
Volitelné: ID instance produktu, která je upravena a použita s --channelId. Je productID to něco jako Microsoft.VisualStudio.Product.Enterprise. |
--channelUri |
Volitelné: Během příkazu update můžete předat nové --channelUri , abyste změnili umístění nastavení aktualizace. Doporučujeme spárovat s parametrem --installPath , aby bylo explicitní, kterou instanci sady Visual Studio konfigurujete. Podívejte se na příklady syntaxe --channelUri |
--channelId <id> |
ID kanálu, například VisualStudio.17.Release. Podívejte se na příklady syntaxe .--channelId channelId je vyžadována pro úpravy operací vedle --productID operace nebo --installPath. |
--add <one or more workload or component IDs> |
Volitelné: Během příkazu instalace nebo úpravy určuje tento opakovatelný parametr jedno nebo více ID úloh nebo komponent, které se mají přidat. Požadované součásti artefaktu se nainstalují, ale ne doporučené nebo volitelné součásti. Pomocí a/nebo --includeOptional parametrů můžete řídit další komponenty globálně--includeRecommended. Pokud chcete zahrnout více úloh nebo součástí, opakujte --add příkaz (například --add Workload1 --add Workload2). Pro jemně odstupňovaný ovládací prvek můžete připojit ;includeRecommended nebo ;includeOptional k ID (například --add Workload1;includeRecommended nebo --add Workload2;includeRecommended;includeOptional). Další informace najdete na stránce ID úloh a komponent. |
--all |
Volitelné: Při instalaci nebo úpravě příkazu tento parametr způsobí instalaci všech úloh a součástí produktu. |
--allWorkloads |
Volitelné: Během příkazu instalace nebo úpravy tento parametr nainstaluje všechny úlohy a komponenty, ale žádné doporučené nebo volitelné součásti. |
--includeRecommended |
Volitelné: Během příkazu instalace nebo úpravy zahrnuje tento parametr doporučené součásti pro všechny nainstalované úlohy. Nezahrnuje volitelné komponenty. Úlohy jsou zadány buď s --allWorkloads , nebo --add. Upozorňujeme, že pomocí parametru --includeRecommended povolíte dialogové okno Nastavení aktualizace a přidáte doporučené komponenty pro nainstalované úlohy při aktualizaci. Chcete-li toto nastavení změnit, přečtěte si téma Přizpůsobení nastavení aktualizace. |
--includeOptional |
Volitelné: Během příkazu instalace nebo úpravy zahrnuje tento parametr volitelné součásti pro všechny nainstalované úlohy. Nezahrnuje doporučené komponenty. Úlohy jsou zadány buď s --allWorkloads , nebo --add. |
--addProductLang <language-locale> |
Volitelné: Během příkazu install nebo modify určuje tento opakovatelný parametr jazykové sady uživatelského rozhraní, které mají být nainstalovány s produktem. Pokud není k dispozici, instalace používá jazykovou sadu, která odpovídá národnímu prostředí počítače. Další informace najdete v tématu [Seznam národních prostředí jazyka] |
--remove <one or more workload or component IDs> |
Volitelné: Během příkazu modify určuje tento opakovatelný parametr jedno nebo více ID úloh nebo komponent, které se mají odebrat. Doplňuje a chová se podobně jako parametr --add . |
| (#list-of-language-locales) oddíl na této stránce. | |
--removeProductLang <language-locale> |
Volitelné: Během příkazu instalace nebo úpravy určuje tento opakovatelný parametr jazykové sady uživatelského rozhraní, které by se měly z produktu odebrat. Doplňuje a chová se podobně jako parametr --addProductLang . |
--in <path> |
Volitelné: Identifikátor URI nebo cesta k souboru odpovědi, který může obsahovat nastavení konfigurace. |
--quiet |
Volitelné: Tento parametr se používá s libovolným příkazem, který brání zobrazení uživatelského rozhraní při spuštění příkazu. Není k dispozici programově standardními uživateli bez ohledu na to, jak je nastavena zásada AllowStandardUserControl. |
--passive, -p |
Volitelné: Tento parametr způsobí, že se uživatelské rozhraní zobrazí neinteraktivním způsobem. Tento parametr se vzájemně vylučují z parametru --quiet (a ve skutečnosti přepíše). Není také k dispozici pro programové použití standardními uživateli bez ohledu na to, jak je nastavena zásada AllowStandardUserControl. |
--norestart |
Volitelné: Tento parametr musí být spárován s parametry --passive nebo --quiet parametry. Během instalace, aktualizace nebo úpravy příkazu přidání parametru --norestart zpožďuje případné potřebné restartování. |
--force |
Volitelné: Tento parametr vynutí zavření sady Visual Studio i v případě, že se používá jakýkoli proces sady Visual Studio. Vynucení ukončení sady Visual Studio může způsobit ztrátu práce, proto ji používejte s opatrností. |
--installWhileDownloading |
Volitelné: Během příkazu instalace, aktualizace nebo úpravy tento parametr umožňuje sadě Visual Studio stáhnout a nainstalovat produkt paralelně. Je to výchozí prostředí. |
--downloadThenInstall |
Volitelné: Během příkazu instalace, aktualizace nebo úpravy tento parametr vynutí, aby sada Visual Studio před instalací stáhla všechny soubory. Vzájemně se vylučují z parametru --installWhileDownloading . |
--nickname <name> |
Volitelné: Během instalačního příkazu tento parametr definuje přezdívku, která se přiřadí nainstalovanému produktu. Přezdívka nesmí být delší než 10 znaků. |
--productKey |
Volitelné: Během instalačního příkazu tento parametr definuje kód Product Key, který se má použít pro nainstalovaný produkt. Kód Product Key se skládá z 25 alfanumerických znaků ve formátu xxxxxxxxxxxxxxxxxxxxxxxxx. |
--removeOos true |
Volitelné: Během příkazu instalace, aktualizace nebo úpravy tento parametr, následovaný true nebo false, informuje Instalační program pro Visual Studio, zda se mají odebrat všechny nainstalované komponenty, které byly převedeny do stavu mimo podporu. Toto chování platí pro jednu událost. Pokud chcete toto chování nastavit jako trvalé, použijte tento parametr na příkaz modifySettings, popsaný později nebo nakonfigurujte globální zásady removeOOS. Užitečné pro zajištění zabezpečení počítače. |
--config <path to *.vsconfig file> |
Volitelné: Během operace instalace nebo úpravy můžete předat konfigurační soubor pomocí parametru --config k určení úloh, komponent nebo rozšíření, které chcete přidat na základě dříve uloženého konfiguračního souboru instalace. Tato operace je pouze přídatná; neodebere nic, co není zadané v souboru. Položky zadané v konfiguračním souboru, které se nevztahují na produkt, se také nepřidají. Důrazně doporučujeme zadat plně kvalifikovanou cestu ke konfiguračnímu souboru. Během operace exportu určuje tento parametr umístění pro uložení konfiguračního souboru instalace. |
--allowUnsignedExtensions |
Volitelné: Pokud jsou v konfiguračním souboru zadány přípony, je tento parametr nutný k načtení rozšíření bez digitálního podpisu během --passive operace instalace nebo --quiet úpravy pomocí --config souboru. |
--installerOnly |
Volitelné: Během operace instalace nebo aktualizace tento parametr informuje Instalační program pro Visual Studio, že se má nainstalovat sám (instalační program) a ne produkt sady Visual Studio. Jeho funkce je ekvivalentní parametru --update , ale intuitivnější. Slouží k použití při předpřipravení a předběžné konfiguraci klientských počítačů. |
--help, --?, -h, -? |
Zobrazí offline verzi této stránky. |
Příkaz rozložení a parametry příkazového řádku
Všechny operace správy rozložení, jako je například vytvoření nebo aktualizace rozložení, se spouštějí pomocí souboru bootstrapper exe a předpokládají, že příkaz je výchozí instalace (prázdná). Všechny operace správy rozložení by měly začínat požadovaným --layout počátečním parametrem. Následující tabulka popisuje další parametry, které můžete použít k vytvoření nebo aktualizaci rozložení pomocí příkazového řádku.
| Parametry rozložení | Popis |
|---|---|
--layout <dir> |
Určuje adresář pro vytvoření nebo aktualizaci mezipaměti offline instalace. Další informace naleznete v tématu Vytvoření síťové instalace sady Visual Studio. |
--lang <one or more language-locales> |
Volitelné: Slouží --layout k přípravě offline instalační mezipaměti s balíčky prostředků se zadanými jedním nebo více zadanými jazyky. Další informace najdete v části Seznam národních prostředí jazyka na této stránce. |
--add <one or more workload or component IDs> |
Volitelné: Jedno nebo více ID úloh nebo komponent, které chcete přidat. Požadované součásti artefaktu se nainstalují, ale ne doporučené nebo volitelné součásti. Můžete řídit více komponent globálně pomocí --includeRecommended a/nebo --includeOptional. Pro jemně odstupňovaný ovládací prvek můžete připojit ;includeRecommended nebo ;includeOptional k ID (například --add Workload1;includeRecommended nebo --add Workload2;includeOptional). Další informace najdete na stránce ID úloh a komponent. Poznámka: Pokud --add se používá, stáhnou se jenom zadané úlohy a komponenty a jejich závislosti. Pokud --add není zadáno, stáhnou se do rozložení všechny úlohy a komponenty. |
--includeRecommended |
Volitelné: Zahrnuje doporučené součásti pro všechny nainstalované úlohy, ale ne volitelné součásti. Úlohy jsou zadány buď s --allWorkloads , nebo --add. |
--includeOptional |
Volitelné: Zahrnuje doporučené a volitelné součásti pro všechny úlohy zahrnuté v rozložení. Úlohy jsou zadány pomocí parametru --add. |
--wait |
Volitelné: Proces čeká, dokud se instalace nedokončí, a teprve potom vrátí ukončovací kód. wait je užitečné při automatizaci instalací, kdy je potřeba počkat na dokončení instalace pro zpracování návratového kódu z této instalace. Parametr --wait lze předat pouze do bootstrapperu. Instalační program (setup.exe) ho nepodporuje. Je užitečné při aktualizaci rozložení. Další příklady najdete tady. |
--useLatestInstaller |
Volitelné: Starší verze funkcí, které platí jenom pro bootstrappery sady Visual Studio starší než duben 2023. Cokoliv expedovaného po dubnu 2023 používá ve výchozím nastavení nejnovější instalační program. Pokud je tento parametr k dispozici, je součástí rozložení nejnovější verze Instalační program pro Visual Studio, i když patří do novější hlavní verze produktu. Nejnovější instalační program může být užitečný, pokud chcete využívat nové funkce nebo opravy chyb, které jsou k dispozici v nejnovější verzi. Další informace najdete v tématu Konfigurace rozložení tak, aby vždy používal nejnovější dokumentaci k instalačnímu programu . |
--config <path to *.vsconfig file> |
Volitelné: Pokud je k dispozici, Visual Studio ke konfiguraci rozložení použije obsah konfiguračního souboru . Ujistěte se, že jste zadali plně kvalifikovanou cestu ke konfiguračnímu souboru. |
--noWeb |
Volitelné: Pokud je k dispozici, instalační program sady Visual Studio použije soubory v adresáři rozložení k instalaci sady Visual Studio a nestahuje z webu žádné balíčky. Pokud se uživatel pokusí nainstalovat součásti, které nejsou v rozložení, instalace se nezdaří. Tento parametr nepoužívejte, pokud se pokoušíte nasadit rozložení hostované na interním intranetovém webu. Další informace najdete v tématu Instalace na klienta, který nemá přístup k internetu. Důležité: Parametr --noWeb nezastaví Instalační program pro Visual Studio na klientském počítači připojeném k internetu, aby kontroloval aktualizace, pokud je klient nakonfigurovaný tak, aby se podíval na servery hostované Microsoftem pro aktualizace. V takovém případě --noWeb jednoduše zabrání klientovi stáhnout balíčky produktů. |
--verify |
Volitelné: Ověřte obsah rozložení. Zobrazí se všechny poškozené nebo chybějící soubory. |
--fix |
Volitelné: Ověřte obsah rozložení. Pokud jsou nějaké soubory poškozené nebo chybí, znovu se načtou. K opravě rozložení se vyžaduje přístup k internetu. |
--clean <one or more paths to catalogs> |
Volitelné: Odebere staré verze součástí z rozložení aktualizovaného na novější verzi. |
| Pokročilé parametry rozložení | Popis |
|---|---|
--channelId <id> |
Volitelné: ID kanálu, který se má nainstalovat, reprezentovaný jako VisualStudio.17.Release. Pro příkaz install se vyžaduje channelId a pokud je zadaný, ignoruje se pro ostatní příkazy --installPath . Podívejte se na příklady syntaxe --channelId. |
--channelUri <uri> |
Volitelné: Identifikátor URI manifestu kanálu. Tato hodnota řídí zdrojové umístění aktualizací a počáteční hodnota je nakonfigurována v souboru response.json rozložení. Informace o možných hodnotách najdete v příkladech syntaxe --channelUri . Pokud aktualizace nejsou požadované, --channelUri může odkazovat na neexistující soubor (například --channelUri C:\doesntExist.chman). Tento parametr lze použít pro příkaz install; ostatní příkazy ho ignorují. |
--installChannelUri <uri> |
Volitelné: Identifikátor URI manifestu kanálu, který se má použít pro instalaci. K detekci aktualizací se použije identifikátor URI určený --channelUri (který musí být zadán při --installChannelUri zadání). Tento parametr lze použít pro příkaz install; ostatní příkazy ho ignorují. |
--installCatalogUri <uri> |
Volitelné: Identifikátor URI manifestu katalogu, který se má použít pro instalaci. Pokud je zadáno, správce kanálu se pokusí stáhnout manifest katalogu z tohoto identifikátoru URI před použitím identifikátoru URI v manifestu instalačního kanálu. Tento parametr slouží k podpoře offline instalace, kde se mezipaměť rozložení vytvoří s již staženým katalogem produktů. Tento parametr lze použít pro příkaz install; ostatní příkazy ho ignorují. |
--productId <id> |
Volitelné: ID produktu pro nainstalovanou instanci. Tento parametr je předem vyplněný v normálních podmínkách instalace. Je productID to něco jako Microsoft.VisualStudio.Product.Enterprise. |
--arch all |
Volitelné: Ve výchozím nastavení se rozložení vytvářejí pouze s binárními soubory produktu x64. Pokud chcete zahrnout binární soubory ARM pro příslušné úlohy spolu s binárními soubory x64 v rozložení, použijte --arch all parametr nebo --arch * parametr. Pokud chcete vytvořit rozložení jenom binárních souborů ARM, použijte --arch arm64 |
--keepLayoutVersion |
Volitelné: Použijte změny v rozložení bez aktualizace verze produktu, která je součástí rozložení. |
--locale <language-locale> |
Volitelné: Umožňuje změnit jazyk zobrazení uživatelského rozhraní samotného instalačního programu. Nastavení bude zachováno. Další informace najdete v části Seznam národních prostředí jazyka na této stránce. |
--cache |
Volitelné: Pokud jsou k dispozici, balíčky se budou uchovávat po instalaci pro následné opravy. Tím se přepíše nastavení globálních zásad, které se použije pro následné instalace, opravy nebo úpravy. Výchozí zásadou je ukládání balíčků do mezipaměti. Tento příkaz se ignoruje pro příkaz uninstall. Přečtěte si, jak zakázat nebo přesunout mezipaměť balíčků, kde najdete další informace. |
--nocache |
Volitelné: Pokud existují, balíčky se po instalaci nebo opravě odstraní. Po použití se stáhnou znovu, jenom pokud je to potřeba, a po použití se znovu odstraní. Tím se přepíše nastavení globálních zásad, které se použije pro následné instalace, opravy nebo úpravy. Výchozí zásadou je ukládání balíčků do mezipaměti. Tento příkaz se ignoruje pro příkaz uninstall. Přečtěte si, jak zakázat nebo přesunout mezipaměť balíčků, kde najdete další informace. |
--noUpdateInstaller |
Volitelné: Pokud je k dispozici, zabrání instalačnímu programu, aby se po zadání tichého stavu aktualizoval sám. Instalační program selže příkazem a vrátí nenulový ukončovací kód, pokud je v případě potřeby aktualizace instalačního programu zadán noUpdateInstaller s tichým režimem. |
--path <name>=<path> |
Volitelné: Slouží k určení vlastních cest instalace pro instalaci. Podporované názvy cest jsou sdílené, mezipaměti a instalace. |
--path cache=<path> |
Volitelné: Použije zadané umístění ke stažení instalačních souborů. Toto umístění lze nastavit pouze při prvním instalaci sady Visual Studio. Příklad: --path cache="C:\VS\cache" |
--path shared=<path> |
Volitelné: Obsahuje sdílené soubory pro souběžné instalace sady Visual Studio. Některé nástroje a sady SDK se instalují do umístění na této jednotce, zatímco některé jiné můžou toto nastavení přepsat a nainstalovat na jinou jednotku. Příklad: --path shared="C:\VS\shared" Důležité: Toto nastavení lze nastavit pouze jednou a při prvním instalaci sady Visual Studio. |
--path install=<path> |
Volitelné: Ekvivalent .–-installPath --installPath "C:\VS" Konkrétně a --path install="C:\VS" jsou ekvivalentní. Současně lze použít pouze jeden z těchto příkazů. |
ModifySettings – parametry příkazového řádku a příkazového řádku
Nastavení aktualizace a programově můžete nakonfigurovat zdrojové umístění aktualizací pro danou instanci sady Visual Studio pomocí instalačního programu nebo bootstrapperu na klientském počítači a předáním příkazu modifySettings a požadovaného aktualizačního kanálu.
| Příkaz | Popis |
|---|---|
modifySettings |
Příkaz použitý ke změně nastavení aktualizace konkrétní instance sady Visual Studio. |
| ModifySettings – parametry | Popis |
|---|---|
--installPath <dir> |
Doporučuje se určit, na kterou instanci sady Visual Studio se má jednat. |
--newChannelUri |
Povinné: Identifikátor URI manifestu kanálu. Tato hodnota určuje, kde bude další zdrojové umístění aktualizací . Informace o možných hodnotách najdete v příkladech syntaxe --channelUri . Pokud aktualizace nejsou požadované, --channelUri může odkazovat na neexistující soubor (například --channelUri C:\doesntExist.chman). |
--channelUri |
Identifikátor URI manifestu starého kanálu. Lze použít, pokud --installPath není znám. Musí být použit ve spojení s ID produktu k identifikaci správné instance, na které se má jednat. |
--productId <id> |
Je nutné použít, pokud je zadán parametr --channelUri a slouží k identifikaci správné instance, na které se má jednat. Je productID to něco jako Microsoft.VisualStudio.Product.Enterprise. |
--includeRecommended |
Volitelné: Během příkazu modifySettings tento parametr (který musí mít slovo true nebo false hned po něm) informuje instalační program sady Visual Studio, aby v dialogovém okně Nastavení aktualizace zakázal funkci Přidat doporučené součásti pro nainstalované úlohy při aktualizaci. |
--quiet |
Volitelné: Tento parametr zabraňuje zobrazení uživatelského rozhraní při spuštění příkazu. Není k dispozici pro programové použití standardními uživateli. |
--removeOos true |
Volitelné: Během příkazu modifySettings tento parametr (který musí mít slovo true nebo false hned po něm) informuje instalační program sady Visual Studio, aby trvale odebral (nebo neodebral) všechny nainstalované součásti, které přešly do stavu mimo podporu. Užitečné pro zajištění zabezpečení počítače. |
Příklady syntaxe:
C:\>"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modifySettings --installPath "C:\Program Files\Microsoft\Visual Studio\2022\Enterprise" --newChannelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --removeOos true
C:\>"C:\Program Files\Microsoft\Visual Studio\2022\Enterprise\vs_enterprise.exe" modifySettings --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
Vrácení příkazů zpět a parametrů příkazového řádku
Počínaje sadou Visual Studio 2022 můžete programově vrátit aktualizaci pomocí instalačního programu na klientském počítači a předáním příkazu vrácení zpět spolu s instancí instalační cesty.
| Příkaz | Popis |
|---|---|
rollback |
Příkaz pro vrácení konkrétní instance sady Visual Studio do dříve nainstalované aktualizace. Tento příkaz nebude fungovat, pokud DisableRollback je povolený. |
| Parametry vrácení zpět | Popis |
|---|---|
--installPath <dir> |
Doporučuje se určit, na kterou instanci sady Visual Studio se má jednat. |
Příklady syntaxe:
"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" rollback -–installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise"
Aktualizace příkazů a parametrů příkazového řádku správcem
Aktualizaci správce si můžete stáhnout z katalogu služby Microsoft Update a použít ji k aktualizaci instalace klienta nebo rozložení.
Aktualizace rozložení
Pokud aktualizujete rozložení na konkrétní verzi sady Visual Studio, stačí stáhnout aktualizaci správce do počítače, který toto rozložení hostuje, otevřít na tomto počítači příkazový řádek a spustit příkaz podobný tomuto:
visualstudioupdate-17.0.0to17.1.5.exe layout --layoutPath c:\VSLayout
Aktualizace klienta
Pokud na klientském počítači stáhnete aktualizaci správce do instalačního adresáře, stačí poklikáním na soubor nainstalovat aktualizaci. Můžete také otevřít příkazové okno a předat některé parametry níže a změnit výchozí chování.
Konfigurace aktualizace správce v SCCM
Pokud nasazujete aktualizaci správce prostřednictvím Microsoft Endpoint Manageru (SCCM), můžete balíček upravit a upravit chování pomocí následujících parametrů. Parametry můžete také řídit prostřednictvím konfiguračního souboru na klientském počítači. Další informace najdete v tématu Metody konfigurace aktualizace správce.
Všimněte si, že všechny parametry aktualizace správce jsou ve výchozím nastavení spouštěné v kontextu "update", pokud není zadán příkaz rozložení.
| Parametry aktualizace správce | Popis |
|---|---|
--installerUpdateArgs [optional parameters] |
Tento parametr funguje jako předávací pole konkrétních parametrů, které jsou relevantní pro scénáře aktualizace správce. Volitelné parametry povolené pro tento účel: --quiet: Toto je výchozí prostředí pro aktualizace správce a tady je uvedeno pro úplnost. --passive: Tento parametr přepíše --quiet parametr. Způsobí, že se uživatelské rozhraní zobrazí neinteraktivně. --norestart: Tento parametr musí být použit ve spojení s parametrem buď --quiet nebo --passive a způsobuje zpoždění všech nezbytných restartování. --noWeb: Tento parametr zabraňuje sadě Visual Studio v kontrole aktualizací produktu na internetu. --force: Tento parametr vynutí ukončení sady Visual Studio i v případě, že se sada Visual Studio používá. Tento parametr používejte s opatrností, protože může způsobit ztrátu práce. Tento parametr musí být použit pouze při spuštění aktualizace správce v kontextu uživatele; je ignorována, pokud je aktualizace správce spuštěna v kontextu systému. --installWhileDownloading: Tento parametr umožňuje sadě Visual Studio stáhnout a nainstalovat produkt paralelně. Jedná se o výchozí prostředí pro aktualizace správce a tady je uvedeno pro úplnost. --keepWindowsUpdateOn: Tento parametr brání instalačnímu programu v vypnutí agenta služba Windows Update na klientovi. Tento parametr byste měli použít, pokud importujete aktualizaci správce z katalogu do SCCM. Možná budete také muset nastavit časový limit balíčku SCCM na delší než výchozí 10 minut. Změna typu nasazení SCCM na povinné způsobí, že tento parametr není nutný.--downloadThenInstall: Tento parametr vynutí, aby sada Visual Studio před instalací stáhla všechny soubory. Vzájemně se vylučují z parametru --installWhileDownloading . |
--checkPendingReboot |
Aktualizace bude přerušena, pokud na počítači dojde k restartování čekající na restartování bez ohledu na to, která aplikace ji mohla způsobit. Výchozí hodnota je nekontrolovat nevyřízené restartování. |
Příklad syntaxe pro předávání parametrů do aktualizace správce:
visualstudioupdate-16.9.0to16.9.4.exe --installerUpdateArgs=--force,--noWeb,--keepWindowsUpdateOn --checkPendingReboot
Odebrání parametrů příkazového řádku a příkazového řádku kanálu
Kanály, ze které se dají aktualizovat, se ukládají do mezipaměti klienta a v průběhu času můžou nepotřebné věci zahltit. Aktualizační kanály můžete ručně odebrat tak, že zobrazíte Instalační program pro Visual Studio, přepnete na kartu K dispozici a kliknete na X v pravém horním rohu karty produktu. Kanály (například starší umístění rozložení) můžete programově odebrat pomocí removeChannel příkazu. V klientském počítači můžete programově spustit a určit, které kanály se ukládají do mezipaměti na klientském počítači.
| Příkaz | Popis |
|---|---|
removeChannel |
Příkaz pro odebrání kanálu z klientského počítače |
| removeChannel – parametry | Popis |
|---|---|
--channelUri |
Byl vyžadován identifikátor URI manifestu starého kanálu. |
--quiet |
Nepovinný Tento parametr zabraňuje zobrazení uživatelského rozhraní při spuštění příkazu. |
--passive |
Nepovinný Tento parametr přepíše --quiet parametr. Způsobí, že se uživatelské rozhraní zobrazí neinteraktivně. |
Příklad syntaxe:
"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" removeChannel --channelUri "\\\\server\\share\\layoutdirectory\\ChannelManifest.json"
Použití wingetu k instalaci nebo úpravě sady Visual Studio
Nástroj Správce balíčků systému Windows "winget" můžete použít k programové instalaci, úpravě nebo aktualizaci sady Visual Studio na vašem počítači spolu s dalšími balíčky spravovanými wingetem.
Ve výchozím nastavení sada winget pouze nainstaluje základní úlohu sady Visual Studio.
winget install --id Microsoft.VisualStudio.2022.Community
Pokud ale chcete instalaci přizpůsobit a zadat další úlohy a komponenty, které se mají získat během počáteční instalace, můžete použít přepínač wingetu společně s příkazem wingetu --override install a předat exportovaný soubor vsconfig, který obsahuje úlohy a komponenty, které chcete přidat:
winget install --id Microsoft.VisualStudio.2022.Community --override "--passive --config c:\my.vsconfig"
Samozřejmě můžete také zahrnout komponenty přímo během počáteční instalace, například takto:
winget install --id Microsoft.VisualStudio.2022.Community --override "--quiet --add Microsoft.Visualstudio.Workload.Azure"
Pokud už máte na počítači nainstalovanou sadu Visual Studio, je možné použít příkaz winget configure společně s poskytovatelem Visual Studio PowerShell DSC, souborem yaml a souborem .vsconfig a přidat komponenty do existující instalace sady Visual Studio. Příkaz Winget configure v podstatě funguje jako operace "modify" sady Visual Studio. Zjistěte , jak vytvořit konfigurační soubor WinGet, abyste zjistili, jak vytvořit konfiguraci wingetu.
Kromě příkazu winget upgrade není možné použít --override buď přepínač, nebo poskytovatele Visual Studio DSC, protože upgrade v podstatě funguje jako operace aktualizace sady Visual Studio a nainstaluje nejnovější verzi komponent, které jste už vybrali. Komponenty není možné přidávat prostřednictvím aktualizace nebo upgradu. K přidání komponent je potřeba použít winget configure .
Mějte na paměti, že Instalační program pro Visual Studio operace v současné době vyžadují oprávnění správce, takže winget vás vyzve ke zvýšení oprávnění v případě potřeby k dokončení příkazu. V současné době také není možné použít winget k instalaci více edicí (tj. různých skladových položek) nebo více instancí stejné skladové položky současně na klientském počítači. Visual Studio musí být nakonec zavřené, pokud ho nakonfigurujete (upravíte) pro přidání komponent nebo upgradujete na nejnovější verzi.
Seznam ID úloh a ID komponent
Seznam ID úloh a komponent seřazených podle produktu Visual Studio najdete na stránce ID úloh a komponent sady Visual Studio.
Seznam národních prostředí jazyka
| Národní prostředí jazyka | Jazyk |
|---|---|
| Cs-cz | Čeština |
| De-de | Němčina |
| En-us | Angličtina |
| Es-es | Španělština |
| Fr-fr | Francouzština |
| It-it | Italština |
| Ja-jp | Japonština |
| Ko-kr | Korejština |
| Pl-pl | Polština |
| Pt-br | Portugalština – Brazílie |
| Ru-ru | Ruština |
| Tr-tr | Turečtina |
| Zh-cn | Čínština – zjednodušená |
| Zh-tw | Čínština – tradiční |
Kódy chyb
V závislosti na výsledku operace %ERRORLEVEL% je proměnná prostředí nastavená na jednu z následujících hodnot:
| Hodnota | Výsledek |
|---|---|
| 0 | Operace byla úspěšně dokončena. |
| 740 | Požadováno zvýšení oprávnění |
| 1001 | Instalační proces sady Visual Studio je spuštěný. |
| 1003 | Visual Studio se používá |
| 1602 | Operace byla zrušena. |
| 1618 | Další spuštěná instalace |
| 1 641 | Operace byla úspěšně dokončena a bylo zahájeno restartování. |
| 3010 | Operace se úspěšně dokončila, ale instalace vyžaduje restartování, než se dá použít. |
| 5003 | Bootstrapper se nepodařilo stáhnout instalační program |
| 5004 | Operace byla zrušena. |
| 5005 | Chyba analýzy příkazového řádku bootstrapperu |
| 5007 | Operace byla zablokována – počítač nesplňuje požadavky |
| 8001 | Selhání kontroly armových počítačů |
| 8002 | Selhání předběžné kontroly stahování na pozadí |
| 8003 | Selhání s možností výběru z podpory |
| 8004 | Selhání cílového adresáře |
| 8005 | Ověření selhání zdrojových datových částí |
| 8006 | Spuštěné procesy sady Visual Studio |
| 8010 | Operační systém není podporován. Projděte si požadavky na systém. |
| -1073720687 | Selhání připojení |
| -1073741510 | Microsoft Instalační program pro Visual Studio byl ukončen (uživatelem nebo externím procesem) |
| Jiný důvod (například: -1, 1, 1603) |
Došlo k chybě – další informace najdete v protokolech. |
Každá operace vygeneruje v %TEMP% adresáři několik souborů protokolu, které indikují průběh instalace. Seřaďte složku podle data a vyhledejte soubory, které začínají dd_bootstrapperna , dd_clienta dd_setup pro bootstrapper, instalační aplikaci a instalační modul.
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 správce IT a nemáte nainstalovanou sadu Visual Studio, můžete sem 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.