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í.

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, 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 --includeRecommended parametrů můžete řídit další komponenty globálně--includeOptional. 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 --overrideinstall 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 --override není možné použít upgrade 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:

• Pokud máte problémy s instalací, použijte možnost podpory instalace 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 komunitě vývojářů sady Visual Studio.

Související obsah

• Příklady parametrů příkazového řádku pro instalaci sady Visual Studio
• Vytvoření offline instalace sady Visual Studio
• Automatizace instalace sady Visual Studio souborem odpovědí
• ID úloh a komponent sady Visual Studio