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ý zahájí 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.
• Pomocí balíčku pro aktualizaci správce, který je k dispozici ke stažení z katalogu služby Microsoft Update, automatizovaně aktualizujte rozložení sítě. Další informace najdete v článku Aktualizace nebo úpravy 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 instalují nejnovější verzi kanálu Current, stáhněte si jeden ze souborů v následující tabulce. Pokud chcete nainstalovat konkrétní verzi nebo konkrétní kanál sady Visual Studio 2022, podívejte se na stránku Historie verzí sady Visual Studio 2022. Tato stránka obsahuje odkazy na zaváděcí nástroje pro opravené verze každé údržbové verze.

Edice	bootstrapperu
Visual Studio 2022 Enterprise	vs_enterprise.exe
Visual Studio 2022 Professional	vs_professional.exe
Visual Studio 2022 Community	vs_community.exe
Sestavovací nástroje pro Visual Studio 2022	vs_buildtools.exe

Spropitné

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íka souborů, klikněte pravým tlačítkem na soubor bootstrapper, zvolte Vlastnosti a pak zvolte kartu Podrobnosti. Pole verze produktu popisuje kanál a verzi, které bude zaváděcí program 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á je označena jednoduše jako Visual Studio 2022, nainstaluje nejnovější verzi Visual Studio 2022 na kanálu Current.

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 údržbu rozložení:

• Prvním parametrem je příkaz (sloveso), 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 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 parametry --quiet a --passive.
repair	Opraví nainstalovaný produkt.
uninstall	Odinstaluje nainstalovaný produkt.
export	Exportuje konfiguraci instalace do souboru *.vsconfig.

Důležitý

Při zadávání více různých úloh nebo komponent nebo jazyků musíte pro každou položku opakovat přepínač příkazového řádku --add nebo --remove.

parametrů	popis
--installPath <dir>	U výchozího příkazu install je tento parametr Nepovinný a popisuje, kde je instance nainstalovaná na klientském počítači. U jiných příkazů, 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 spolu s --channelId. productID je něco jako Microsoft.VisualStudio.Product.Enterprise.
--channelUri	Volitelné: Během příkazu aktualizace můžete zadat nový --channelUri, aby se změnilo umístění nastavení aktualizace. Doporučujeme spárovat s parametrem --installPath, aby bylo explicitní, kterou instanci sady Visual Studio konfigurujete. Příklady syntaxe pro --channelUri
--channelId <id>	ID kanálu, například VisualStudio.17.Release. Podívejte se na příklady syntaxe --channelId. channelId se vyžaduje pro operace úprav, a to společně s --productID nebo --installPath.
--add <one or more workload or component IDs>	Nepovinný: 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. Ostatní komponenty můžete řídit globálně pomocí parametrů --includeRecommended nebo --includeOptional. Pokud chcete zahrnout více úloh nebo součástí, opakujte příkaz --add (například --add Workload1 --add Workload2). Pro jemně odstupňovaný ovládací prvek můžete k ID připojit ;includeRecommended nebo ;includeOptional (například --add Workload1;includeRecommended nebo --add Workload2;includeRecommended;includeOptional). Další informace najdete na stránce ID úloh a komponent.
--all	Nepovinný: Při instalaci nebo úpravě tohoto parametru dojde k instalaci všech úloh a součástí produktu.
--allWorkloads	Nepovinný: Během příkazu instalace nebo úpravy tento parametr nainstaluje všechny úlohy a komponenty, ale žádné doporučené nebo volitelné součásti.
--includeRecommended	Nepovinný: Během příkazu instalace nebo úpravy zahrnuje tento parametr doporučené součásti pro všechny nainstalované úlohy. Nezahrnuje volitelné komponenty. Úlohy se zadají buď pomocí --allWorkloads, nebo --add. Upozorňujeme, že použitím parametru --includeRecommended povolíte dialogovému oknu Update Settings přidat doporučené složky pro nainstalované úlohy při aktualizaci. Pokud chcete toto nastavení změnit, přečtěte si Přizpůsobení nastavení aktualizace.
--includeOptional	Nepovinný: Během příkazu instalace nebo úpravy zahrnuje tento parametr volitelné součásti pro všechny nainstalované úlohy. Nezahrnuje doporučené komponenty. Úlohy se zadají buď pomocí --allWorkloads, nebo --add.
--addProductLang <language-locale>	Nepovinný: Během příkazu instalace nebo úpravy určuje tento opakovatelný parametr jazykové sady uživatelského rozhraní, které se mají nainstalovat 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 [Seznamu jazykových nastavení].
--remove <one or more workload or component IDs>	Nepovinný: 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) sekce na této stránce.
--removeProductLang <language-locale>	Nepovinný: 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>	Nepovinný: Identifikátor URI nebo cesta k souboru odpovědi, který může obsahovat nastavení konfigurace.
--quiet	Nepovinný: Tento parametr se používá s libovolným příkazem, zabrání zobrazení uživatelského rozhraní při spuštění příkazu. Není dostupné programově používat standardními uživateli bez ohledu na to, jak je nastavena zásada AllowStandardUserControl.
--passive, -p	Nepovinný: Tento parametr způsobí, že se uživatelské rozhraní zobrazí neinteraktivním způsobem. Tento parametr se vzájemně vylučuje s parametrem --quiet (a ve skutečnosti ho také 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. Během instalace, aktualizace nebo úpravy příkazu přidání parametru --norestart zpožďuje případné potřebné restartování.
--force	Nepovinný: Tento parametr vynutí, aby se Visual Studio zavřel, i když se používá nějaký 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é: Při instalaci, aktualizaci nebo úpravě tento parametr umožňuje, aby Visual Studio stahovalo a instalovalo produkt současně. Je to výchozí prostředí.
--downloadThenInstall	Nepovinný: 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>	Nepovinný: Během instalačního příkazu definuje tento parametr přezdívku pro přiřazení k nainstalovanému produktu. Přezdívka nesmí být delší než 10 znaků.
--productKey	Volitelné: Během příkazu install definuje tento parametr 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	Nepovinný: Při instalaci, aktualizaci nebo úpravě příkazu tento parametr, následovaný true nebo false, informuje Instalační program sady Visual Studio, zda mají být odebrány všechny nainstalované součásti převedené 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é se mají 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 zadané přípony, je při operaci instalace nebo úpravy nutné v kontextu --passive nebo --quiet s použitím souboru --config tento parametr k načtení rozšíření bez digitálního podpisu.
--installerOnly	Nepovinný: Během operace instalace nebo aktualizace tento parametr instalátoru sady Visual Studio informuje instalační program sady Visual Studio, aby nainstaloval sám sebe (instalační program) a ne produkt sady Visual Studio. Jeho funkce je ekvivalentní --update parametru, 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 najdete v tématu Vytvoření síťové instalace sady Visual Studio.
--lang <one or more language-locales>	Volitelné: Používá se s --layout k přípravě offline instalační mezipaměti s balíčky prostředků v jednom nebo více zadaných jazycích. 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. Více komponent můžete řídit globálně pomocí --includeRecommended a/nebo --includeOptional. Pro jemně odstupňovaný ovládací prvek můžete k ID připojit ;includeRecommended nebo ;includeOptional (například --add Workload1;includeRecommended nebo --add Workload2;includeOptional). Další informace najdete na stránce ID úloh a komponent. Poznámka: Pokud se používá --add, stáhnou se jenom zadané úlohy a komponenty a jejich závislosti. Pokud není zadaný --add, stáhnou se do rozložení všechny úlohy a komponenty.
--includeRecommended	Nepovinný: Zahrnuje doporučené součásti pro všechny nainstalované úlohy, ale ne volitelné součásti. Úlohy se zadají buď pomocí --allWorkloads, nebo --add.
--includeOptional	Volitelné: Zahrnuje doporučené a volitelné komponenty pro všechny úlohy, které jsou součástí rozložení. Úlohy jsou zadány pomocí --add.
--wait	Nepovinný: Proces čeká, dokud se instalace nedokončí, než se 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 zde.
--useLatestInstaller	Volitelné: Starší funkce, které platí jenom pro zaváděcí nástroje 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í vašeho rozložení nejnovější verze instalačního programu sady 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 dokumentaci o konfiguraci rozložení pro použití nejnovějšího instalačního balíčku.
--config <path to *.vsconfig file>	Nepovinný: Pokud je k dispozici, Visual Studio pro 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	Nepovinný: 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 žádné balíčky z webu. 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 klientovi, který nemá přístup k internetu. Důležité: Parametr --noWeb nezastaví instalační program sady 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	Nepovinný: Ověřte obsah rozložení. Zobrazí se všechny poškozené nebo chybějící soubory.
--fix	Nepovinný: 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>	Nepovinné: Odebere staré verze součástí z rozložení, které bylo aktualizováno na novější verzi.

Pokročilé parametry rozložení	popis
--channelId <id>	Nepovinný: ID kanálu, který se má nainstalovat, reprezentovaný jako VisualStudio.17.Release. channelId je vyžadován pro příkaz install a pokud je uvedeno --installPath, ignoruje se pro ostatní příkazy. Viz příklady syntaxe --channelId.
--channelUri <uri>	Nepovinný: Identifikátor URI manifestu kanálu. Tato hodnota řídí zdrojové umístění aktualizací a počáteční hodnota je nakonfigurována v souboru rozložení response.json. Projděte si příklady syntaxe pro možnost hodnot --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>	Nepovinný: Identifikátor URI manifestu kanálu, který se má použít pro instalaci. K detekci aktualizací se použije identifikátor URI uvedený --channelUri (který musí být uveden, když je uveden --installChannelUri). Tento parametr lze použít pro příkaz install; ostatní příkazy ho ignorují.
--installCatalogUri <uri>	Volitelné: URI manifestu katalogu k použití pro instalaci. Pokud je zadáno, správce kanálu se pokusí stáhnout manifest katalogu z této URI předtím, než použije 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>	Nepovinný: ID produktu pro nainstalovanou instanci. Tento parametr je předem vyplněný v normálních podmínkách instalace. productID je 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 parametr --arch all nebo --arch *. 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>	Nepovinný: 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	Nepovinný: Pokud je 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 pro odinstalaci ignoruje. Přečtěte si, jak zakázat nebo přesunout mezipaměť balíčků pro více informací.
--nocache	Nepovinný: Pokud je k dispozici, 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. Je ignorován při odinstalaci. Přečtěte si, jak zakázat nebo přesunout mezipaměť balíčků pro více informací.
--noUpdateInstaller	Nepovinný: 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>	Nepovinný: Slouží k určení vlastních cest instalace pro instalaci. Podporované názvy cest jsou sdílené, cache a installace.
--path cache=<path>	Nepovinný: 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>	Nepovinný: Ekvivalentní –-installPath. Konkrétně --installPath "C:\VS" a --path install="C:\VS" jsou ekvivalentní. Současně lze použít pouze jeden z těchto příkazů.

ModifySettings – příkaz a parametry 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říkazu	popis
modifySettings	Příkaz použitý ke změně nastavení aktualizace konkrétní instance sady Visual Studio.

parametry modifySettings	popis
--installPath <dir>	Doporučuje se použít k určení, na kterou instanci sady Visual Studio se má cílit.
--newChannelUri	Požadované: URI manifestu kanálu. Tato hodnota určuje, kde bude další zdroj aktualizací. Podívejte se na příklady syntaxe u --channelUri pro možné hodnoty. Pokud aktualizace nejsou požadované, --channelUri může odkazovat na neexistující soubor (například --channelUri C:\doesntExist.chman).
--channelUri	URI starého manifestu 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. productID je něco jako Microsoft.VisualStudio.Product.Enterprise.
--includeRecommended	Nepovinný: 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	Nepovinný: 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	Nepovinný: 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

Příkaz pro vrácení změn a parametry příkazového řádku

Počínaje sadou Visual Studio 2022 můžete vrátit zpět aktualizaci programově pomocí instalačního programu na klientském počítači a předáním příkazu vrácení zpět vedle instance instalační cesty.

příkazu	popis
rollback	Příkaz pro vrácení konkrétní instance sady Visual Studio do dříve nainstalované aktualizace. Tento příkaz nebude fungovat, pokud je povolená DisableRollback.

parametry vrácení zpět	popis
--installPath <dir>	Doporučené použít k určení instance sady Visual Studio, na kterou 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

aktualizace správce můžete stáhnout z katalogu služby Microsoft Update a použít ho 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 naleznete v oddíle Metody konfigurace aktualizace pro správce.

Upozorňujeme, že všechny parametry aktualizace správce se ve výchozím nastavení spouští v kontextu "update", pokud není specifikováno sloveso rozložení.

Aktualizace parametrů správcem	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 parametr --quiet. Způsobí, že se uživatelské rozhraní zobrazí neinteraktivně. --norestart: Tento parametr musí být použit ve spojení s --quiet nebo --passive a způsobí zpoždění všech nezbytných restartování. --noWeb: Tento parametr zabraňuje ve Visual Studiu 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 Visual Studiu jak stáhnout, tak i 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žby Windows Update v 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 zrušena, pokud je na počítači čekající restart, bez ohledu na to, která aplikace jej mohla způsobit. Výchozí hodnota je nekontrolovat čekající 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

Odeberte příkaz kanálu a parametry příkazového řádku

Kanály, ze kterých se dá aktualizovat, se ukládají do mezipaměti klienta a v průběhu času se mohou zahlcovat. Kanály aktualizace můžete ručně odebrat tak, že spustíte instalační program sady Visual Studio, přepnete na záložku Dostupná 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í příkazu removeChannel. Na klientském počítači můžete spustit vswhere programově, abyste určili, které kanály jsou uložené v mezipaměti.

příkaz	popis
removeChannel	Příkaz pro odebrání kanálu z klientského počítače

odebrání parametrůChannel	popis
--channelUri	Povinné identifikátor URI původního manifestu 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 parametr --quiet. 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

Pomocí nástroje Správce balíčků systému Windows "winget" můžete programově nainstalovat, upravit nebo aktualizovat 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 --override winget přepnout společně s příkazem install winget 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 svém počítači nainstalovanou sadu Visual Studio, je možné použít příkaz configurewinget společně s poskytovatelem Visual Studio PowerShell DSC, souborem yaml a souborem .vsconfig přidat komponenty do existující instalace sady Visual Studio. Příkaz Winget configure v podstatě funguje jako operace "modify" sady Visual Studio. Přečtěte si , jak vytvořit konfigurační soubor WinGet, kde se dozvíte, jak vytvořit konfiguraci wingetu.

Kromě příkazu upgrade winget není možné použít buď přepínač --override, nebo zprostředkovatel 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. Je potřeba použít configure nástroje winget k přidání komponent.

Mějte na paměti, že operace instalačního programu sady Visual Studio 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 součástí a úloh sady Visual Studio.

Seznam národních prostředí jazyka

jazyk-lokál	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 je proměnná prostředí %ERRORLEVEL% 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í
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
1641	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 ARM architektury
8002	Selhání předběžné kontroly stahování na pozadí
8003	Selhání mimo podporu, které lze vybrat
8004	Selhání cílového adresáře
8005	Ověřování selhání zdrojových payloadů
8006	Spuštěné procesy sady Visual Studio
8010	Operační systém není podporován. Podívejte se na požadavky na systém
-1073720687	Selhání připojení
-1073741510	Instalační program sady Microsoft Visual Studio byl ukončen (uživatelem nebo externím procesem)
Jiný (například: -1, 1, 1603)	Došlo k chybě – další informace najdete v protokolech.

Každá operace vygeneruje v adresáři %TEMP% několik souborů protokolu, které indikují průběh instalace. Seřaďte složku podle data a vyhledejte soubory, které začínají dd_bootstrapper, 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 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:

• Problémy související s instalací vyřešte prostřednictvím možnosti podpory instalace chatu , která je k dispozici 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

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