Vytvoření a údržba síťové instalace sady Visual Studio

Podnikový správce někdy chce vytvořit soukromou instalační mezipaměť (označovanou také jako rozložení), která obsahuje soubory sady Visual Studio, které je možné nasadit na klientské počítače v rámci organizace.

Vytvoření rozložení je užitečné v následujících situacích:

• Uživatel má omezená oprávnění
• Klientské počítače mají omezený přístup k internetu.
• Organizace chce standardizovat konkrétní verzi sady vývojářských nástrojů.

Sadu Visual Studio jsme navrhli tak, aby správce mohl vytvořit a udržovat rozložení a uložit ho do interní síťové sdílené složky a volitelně ho zpřístupnit na intranetu organizace. Rozložení slouží jako zdrojové umístění pro všechny soubory sady Visual Studio potřebné pro počáteční instalaci klienta i následné aktualizace.

Informace na této stránce jsou seskupené do tří hlavních částí:

• Vytvoření rozložení: Popisuje, jak vytvořit rozložení se správným obsahem produktu, nakonfigurovat výchozí nastavení, uložit ho do sdílené síťové složky a zpřístupnit ho v intranetu.
• Udržovat rozložení: informace o tom, jak nejlépe aktualizovat verzi produktu rozložení, nebo upravit obsah produktu rozložení, nastavení kanálu, verzi instalačního programu a velikost složky.
• Nápověda a podpora: kde požádat o pomoc

Vytvoření rozložení

Příprava umístění úložiště sdílené síťové složky

Nejprve je potřeba určit, kam budete ukládat stažené balíčky sady Visual Studio. Pokud máte v rámci podniku více edicí sady Visual Studio (například Visual Studio 2022 Professional a Visual Studio 2022 Enterprise), musíte pro každou edici vytvořit samostatné rozložení. Vytvoření samostatného rozložení pro každou edici může spotřebovávat velké množství místa na disku, zejména pokud zvažujete, že aktualizace rozložení spotřebovávají místo na disku.

Cesta rozložení musí být menší než 80 znaků; některé organizace úspěšně používají symbolické odkazy k řešení omezení 80 znaků.

Stažení bootstrapperu sady Visual Studio pro vytvoření rozložení

Stáhněte si správný bootstrapper pro požadovanou edici sady Visual Studio a zkopírujte ho do adresáře, který chcete použít jako úložiště rozložení. Jakmile se rozložení vytvoří, můžete ho použít k instalaci sady Visual Studio na libovolný klientský počítač. Bootstrapper je spustitelný soubor, který používáte k vytvoření, aktualizaci a provádění dalších operací rozložení. K dokončení tohoto kroku musíte mít oprávnění pro připojení k internetu a správce.

Následující bootstrappery vždy nainstalují nejnovější nejbezpečnější verzi sady Visual Studio 2022 v aktuálním kanálu bez ohledu na to, kdy je spustíte. Případně pokud chcete vytvořit nebo aktualizovat rozložení na konkrétní verzi nebo konkrétní kanál sady Visual Studio 2022, stáhněte si evergreen a pevný bootstrapper verze pro servisní vydání kanálu, který chcete získat z historie verzí sady Visual Studio 2022. Zkopírujte ho do adresáře, který chcete použít jako zdrojové umístění rozložení.

Vydání	Zaváděcího nástroje
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". Kanál se předpokládá jako Aktuální, pokud není explicitně zadán. Bootstrapper s produktovou verzí LTSC 17.0 proto nainstaluje nejnovější servisní verzi 17.0.x dostupnou v kanálu LTSC 17.0. Bootstrapper s verzí produktu, která říká, že Visual Studio 2022 nainstaluje nejnovější servisní verzi sady Visual Studio 2022 do aktuálního kanálu.

Stažení balíčků sady Visual Studio

K dokončení tohoto kroku musíte mít připojení k internetu.

Otevřete příkazový řádek se zvýšenými oprávněními, přejděte do adresáře, do kterého jste stáhli bootstrapper, a pomocí parametrů bootstrapperu definovaných v parametrech příkazového řádku nainstalujte stránku sady Visual Studio k vytvoření a údržbě rozložení sítě. Následující příklady ilustrují běžné způsoby vytváření počátečních rozložení. Další příklady najdete na příkladech parametrů příkazového řádku pro instalační stránku sady Visual Studio.

Úplné počáteční rozložení pro národní prostředí s jedním jazykem vyžaduje přibližně 40 GB místa na disku pro Visual Studio Community a přibližně 50 GB pro Visual Studio Enterprise. Národní prostředí navíc vyžadují přibližně půl GB.

Doporučeným přístupem je vytvořit počáteční rozložení sady Visual Studio se všemi úlohami a příslušnými jazyky a uložit balíčky do adresáře rozložení na síťovém serveru. Díky tomu má každá instalace klienta přístup k celé nabídce produktu Visual Studio a možnosti instalace jakékoli podmnožiny. Pokud chcete vytvořit úplné rozložení sady Visual Studio, spusťte z adresáře, na který plánujete hostovat rozložení sítě:

vs_enterprise.exe --layout c:\VSLayout

Ujistěte se, že vaše rozložení vychází ze správného kanálu.

Je důležité zajistit, aby rozložení sítě bylo založeno na správném kanálu, protože se jedná o jedno z kritérií, která správce aktualizuje( pokud je nasazená v celé organizaci), použijte k identifikaci instancí klienta, které se mají aktualizovat. Pokud je vaše rozložení například založené na kanálu VisualStudio.17.Release.LTSC.17.0 a pokud jsou klienti nakonfigurovaní tak, aby dostávali aktualizace z hostovaných serverů Microsoftu, jsou všechny aktualizace zabezpečení zpřístupněné v kanálu 17.0 LTSC dostupné klientům, kteří toto rozložení nainstalovali nebo aktualizovali.

Bootstrappery uvedené dříve jsou založené na aktuálním kanálu. Pokud chcete vytvořit rozložení založené na jednom z kanálů LTSC, získejte správný bootstrapper kanálu ze stránky Historie verzí sady Visual Studio 2022, zkopírujte ho do složky rozložení a použijte ho k vytvoření nebo aktualizaci rozložení.

Konfigurace obsahu rozložení

K přizpůsobení obsahu rozložení sítě můžete použít několik možností. Můžete vytvořit částečné rozložení, které obsahuje jenom konkrétní sadu jazykových národních prostředí, úloh, komponent a jejich doporučených nebo volitelných závislostí. Částečné rozložení je užitečné, pokud víte, že do klientských pracovních stanic nasadíte jenom podmnožinu úloh. Mezi typické parametry příkazového řádku pro přizpůsobení rozložení patří:

• --addurčit ID úloh nebo komponent.
  Pokud --add se použije, stáhnou se jenom úlohy a komponenty zadané pomocí --add . Pokud --add se nepoužívá, stáhnou se všechny úlohy a komponenty.
• --includeRecommended zahrnout všechny doporučené komponenty pro zadané ID úloh.
• --includeOptional zahrnout všechny volitelné komponenty pro zadané ID úloh.
• --config*.vsconfig použít soubor k určení úloh, komponent nebo rozšíření, které by měly být zahrnuty v rozložení nebo na na které odkazuje rozložení. Ujistěte se, že jste zadali úplnou cestu konfiguračního souboru.
• --langurčit národní prostředí jazyka.

Tady je několik příkladů, jak vytvořit vlastní rozložení sítě.

• Pokud chcete vytvořit rozložení s požadovanými komponentami pro všechny úlohy pouze v jednom jazyce, spusťte příkaz:

  vs_enterprise.exe --layout C:\VSLayout --lang en-US
  

• Pokud chcete vytvořit rozložení s požadovanými komponentami pro všechny úlohy ve více jazycích, spusťte následující příkaz:

  vs_enterprise.exe --layout C:\VSLayout --lang en-US de-DE ja-JP
  

• Pokud chcete vytvořit rozložení s jednou úlohou a všemi požadovanými a doporučenými komponentami pro danou úlohu ve všech jazycích, spusťte:

  vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --includeRecommended
  

• Pokud chcete vytvořit rozložení se dvěma úlohami a jednou volitelnou komponentou ve třech jazycích, spusťte:

  vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Component.Git --lang en-US de-DE ja-JP
  

Inicializace obsahu rozložení pomocí konfiguračního souboru

Parametr můžete použít --config k předání *.vsconfig souboru. Ujistěte se, že jste zadali úplnou cestu konfiguračního souboru. *.vsconfig Použití souboru při vytváření rozložení přizpůsobí a omezí obsah rozložení sítě na to, co je zadané v konfiguračním souboru. Konfigurační soubor se zkopíruje do adresáře rozložení a přejmenuje na layout.vsconfig.

Všechna rozšíření zadaná v *.vsconfig souboru se nekopírují přímo do rozložení. Místo toho soubor rozložení response.json obsahuje odkaz na nově vytvořený layout.vsconfig soubor, který definuje umístění instalace pro přípony klienta. Pokud instalujete rozšíření, která nejsou digitálně podepsaná, nezapomeňte upravit response.json doplněk "allowUnsignedExtensions": true. Podívejte se response.json na příklady obsahu.

vs_enterprise.exe --layout "C:\VSLayout" --config "C:\myconfig.vsconfig" 

Zkopírování rozložení do sdílené síťové složky

Musíte hostovat rozložení ve sdílené síťové složce, aby k němu bylo možné přistupovat z klientských počítačů. Pokud jste rozložení vytvořili na místním počítači, musíte ho zkopírovat do umístění síťového souboru. Následující příklad používá xcopy. Můžete také použít robocopy, pokud chcete. Příklad:

xcopy /e c:\VSLayout \\server\share\layoutdirectory

Konfigurace výchozích hodnot počáteční instalace klienta pro toto rozložení

V kořenové složce rozložení se vytvoří volaný response.json soubor. Tento přizpůsobitelný soubor poskytuje počáteční výchozí nastavení pro konfiguraci klienta, když se klient původně nainstaluje z rozložení. Mezi běžné možnosti konfigurace patří možnost konfigurace:

• Které úlohy, komponenty nebo jazyky by se ve výchozím nastavení měly v klientovi nainstalovat
• Pokud by se měly nainstalovat i doporučené součásti
• Pokud má klient respektovat instalační *.vsconfig soubor
• Kde by měl klient přijímat aktualizace
• Pokud by se během aktualizace měly odebrat komponenty mimo podporu
• Pokud mají nepodepsaná rozšíření povoleno načítat tiše a programově

Další informace najdete na stránce pro automatizaci instalace sady Visual Studio se stránkou souboru odpovědi.

Zpřístupnění rozložení prostřednictvím intranetového webu

Od června 2023 můžete rozložení zpřístupnit na interním intranetového webu, což vám umožní využít možnosti ukládání souborů webového serveru do mezipaměti a výkonu geografického obnovení. Pokud chcete tuto novou funkci použít, musíte použít nejnovější bootstrappery sady Visual Studio a nejnovější Instalační program pro Visual Studio. Správci IT musí provést následující akce, aby mohli využívat výhod tohoto intranetového hostování webů:

1. Nejprve vytvořte a udržujte rozložení sítě a ujistěte se, že jsou bity přítomny a pravidelně aktualizovány ve sdílené síťové složce. Nezapomeňte také nakonfigurovat hodnotu channelUri v response.json rozložení, pokud chcete, aby klienti získali aktualizace z umístění rozložení intranetu.

2. Dále bude muset správce připravit interní web a vytvořit vazbu zdroje webu na umístění síťového souboru rozložení. Musí také zajistit, aby webový server respektoval následující typy MIME:

   Přípona souboru	Typ MIME
   .Cab	application/vnd.ms-cab-compressed
   .Exe	application/octet-stream
   .Json	application/json
   .Msi	application/octet-stream
   .Msu	application/octet-stream
   .nupkg	application/octet-stream
   .Opc	application/octet-stream
   .ps1	application/postscript
   .Vsix	application/octet-stream
   .Xml	text/xml
   .Zip	application/x-zip-compressed

3. Pokud chcete toto rozložení nasadit na klienta, spusťte na klientovi skript PowerShellu, který provede počáteční instalaci. Po úspěšné instalaci sady Visual Studio do klienta z rozložení hostovaného na webu je možné aktualizace klienta pro rozložení hostované webem aktualizovat standardními metodami.

Ujistěte se, že vaše rozložení používá nejnovější instalační program.

Poznámka:

Od června 2023 se nejnovější instalační program standardně dodává s každou aktualizací všech podporovaných verzí sady Visual Studio 2017, Visual Studio 2019 a Visual Studio 2022. Pokud tedy používáte některou z těchto verzí produktů, nemusíte nic explicitně dělat, abyste získali nejnovější verzi instalačního programu s nejnovějšími funkcemi a opravami chyb.

Pokud používáte verzi sady Visual Studio dodávaná před červnem 2023, doporučujeme vždy používat nejnovější Instalační program pro Visual Studio v rozložení a distribuovat ji klientům. Pokud například distribuujete instalační program sady Visual Studio 2022 v rozložení sady Visual Studio 2019, budou mít klienti sady Visual Studio 2019 založené na tomto rozložení možnost změnit zdrojové umístění aktualizací nebo snadno odebrat součásti, které jsou mimo podporu. Další podrobnosti jsou popsány v následující části.

Možnost zajistit programově, že používáte nejnovější instalační program, je dostupná jenom pro bootstrappery sady Visual Studio 2019 vytvořené po původním odeslání sady Visual Studio 2022. Proto vs_enterprise.exe v následujícím příkladu musí být verze, která byla odeslána po 10. listopadu 2021.

Pokud chcete vytvořit rozložení celého produktu, který používá nejnovější a nejlepší dostupný instalační program, spusťte

vs_enterprise.exe --layout C:\VSLayout --useLatestInstaller

Údržba rozložení

Osvědčeným postupem je pravidelně aktualizovat rozložení sady Visual Studio na nejnovější zabezpečenou verzi produktu. Tím zajistíte, že rozložení bude možné použít jako instalační bod i zdroj aktualizací pro instalace klientů. Následující část popisuje nejběžnější nebo užitečné operace údržby rozložení.

Pokud hostujete rozložení ve sdílené síťové složce, možná budete chtít stáhnout aktualizované rozložení do privátní místní sdílené složky (například c:\VSLayoutUpdate) a po stažení veškerého aktualizovaného obsahu ho zkopírujte do sdílené síťové složky rozložení (například \server\products\VS). Pokud to neuděláte, můžou uživatelé, kteří při aktualizaci rozložení spustí instalaci, získat neshodu obsahu z rozložení, protože ještě nebyl úplně aktualizovaný.

Aktualizujte rozložení na nejaktuálnější verzi produktu.

Společnost Microsoft často vydává aktualizované verze produktu, které opravují funkce nebo problémy se zabezpečením. Důrazně doporučujeme udržovat rozložení aktualizované pomocí nejnovější verze produktu, aby vaši klienti měli vždy přístup k nejnovější nejbezpečnější verzi produktu. To je zvlášť důležité, pokud vaši klienti nemají přístup k internetu a můžou z rozložení přijímat jenom aktualizace produktů. Visual Studio obvykle vydává aktualizace zabezpečení druhé úterý v měsíci, označované jako "patch Tuesday", takže dobrou strategií by bylo aktualizovat všechna rozložení v úterý odpoledne oprav.

Při vytváření počátečního rozložení se zadané možnosti, jako jsou úlohy a jazyky, které mají být zahrnuty do rozložení, uloží do konfiguračního souboru layout.jsonrozložení . Když později toto rozložení aktualizujete na novější verzi produktu, nebudete muset znovu určit, které součásti produktu chcete v rozložení použít. Aktualizace rozložení jednoduše aktualizuje stávající komponenty v rozložení na nejnovější verzi.

Předpokládejme, že jste už toto částečné rozložení vytvořili pomocí jednoho z evergreen bootstrapperů v tabulce výše.

vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.ManagedDesktop --lang en-US

Aktualizace tohoto rozložení na nejnovější verzi produktu nabízeného Microsoftem a hostované na serverech Microsoftu je snadné. Stačí použít existující evergreen bootstrapper v rozložení a spustit --layout příkaz v příkazovém řádku se zvýšenými oprávněními ke stažení nejnovějších balíčků do vašeho rozložení následujícím způsobem:

vs_enterprise.exe --layout c:\VSLayout

Rozložení můžete také aktualizovat na aktualizovanou verzi bezobslužným způsobem. Operace rozložení spustí proces nastavení v novém okně konzoly. Okno je otevřené, aby správci viděli konečný výsledek aktualizace rozložení a souhrn všech chyb, ke kterým mohlo dojít. Pokud chcete provést operaci aktualizace rozložení bezobslužně (například máte skript, který se pravidelně spouští za účelem aktualizace rozložení na nejnovější verzi), použijte --passive parametr a proces okno automaticky zavře.

vs_enterprise.exe --layout c:\VSLayout --passive

Aktualizace rozložení na konkrétní verzi produktu

Někdy můžete chtít rozložení aktualizovat na konkrétní verzi produktu. Můžete například chtít, aby vaše rozložení odpovídalo nejnovější zabezpečené verzi servisního směrného plánu, na které jste ve své organizaci standardizovali. Tady je postup:

Můžete přejít na stránku Historie verzí sady Visual Studio 2022 a stáhnout konkrétní zaváděcí nástroj s pevnou verzí, zkopírovat ho do svého rozložení a použít ho k aktualizaci rozložení na přesnou verzi uvedenou ve bootstrapperu. Použili byste stejnou syntaxi jako výše.

Pomocí aktualizace správce můžete aktualizovat rozložení na konkrétní verzi produktu. Pokud chcete získat aktualizaci správce, přejděte do katalogu služby Microsoft Update a vyhledejte aktualizaci, na kterou chcete aktualizovat rozložení. update.exe Stáhněte si soubor do počítače, který je hostitelem rozložení, otevřete na tomto počítači příkazový řádek se zvýšenými oprávněními a spusťte příkaz podobný tomuto:

visualstudioupdate-17.0.0to17.4.4.exe layout --layoutPath c:\VSLayout

Upozorňujeme, že aktualizace správce nezahájí vytvoření nového rozložení; aktualizuje pouze existující rozložení. K vytvoření počátečního rozložení budete muset použít bootstrapper.

Zajištění, že rozložení sítě vychází z podporované verze

V případě, že kanály přecházejí z podpory, budete muset zajistit, aby rozložení sítě bylo dál založené na podporovaném kanálu, aby vaši klienti mohli dál dostávat oznámení o aktualizacích zabezpečení. Pokud je vaše rozložení založené na kanálu VisualStudio.17.Release.LTSC.17.0, jakmile kanál LTSC 17.0 přestane být v červenci 2023 podporován, nebudeme vydávat žádné další aktualizace zabezpečení a vaše rozložení a klienti se stanou nezabezpečeným. Data podpory pro různé kanály sady Visual Studio 2022 najdete tady.

Pokud chcete změnit kanál, ze kterého je rozložení založeno, získejte bootstrapper požadovaného kanálu ze stránky Historie verzí sady Visual Studio 2022, zkopírujte ho do složky rozložení a proveďte normální aktualizaci. Vaši klienti by pak měli být odpovídajícím způsobem upozorněni na aktualizaci, aby mohli zůstat i v bezpečí.

Úprava obsahu rozložení

Částečné rozložení je možné upravit a přidat další úlohy, komponenty nebo jazyky. Součásti nelze spolehlivě odebrat z rozložení.

V následujícím příkladu přidáme úlohu Azure a lokalizovaný jazyk do rozložení, které bylo vytvořeno pouze s úlohou Managed Desktop a anglickým jazykem. Po provedení změn budou do tohoto rozložení zahrnuty úlohy Managed Desktopu i Azure a v tomto rozložení budou zahrnuty jak anglické, tak německé prostředky. Kromě přidávání komponent --layout bude příkaz také způsobit aktualizaci rozložení na verzi určenou bootstrapperem. Pokud tedy používáte evergreen bootstrapper, výsledné rozložení bude mít novou komponentu, nový jazyk a veškerý obsah rozložení se aktualizuje na nejnovější verzi kanálu bootstrapperu.

vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --lang de-DE

Pokud chcete upravit existující částečné rozložení tak, aby se z něj stala úplná rozložení, použijte možnost --all, jak je znázorněno v následujícím příkladu. Tento příkaz opět způsobí aktualizaci obsahu rozložení na verzi určenou bootstrapperem.

vs_enterprise.exe --layout c:\VSLayout --all

Do rozložení můžete přidat komponenty předáním *.vsconfig souboru, který obsahuje další požadované součásti v rozložení. Pokud to uděláte, nový *.vsconfig obsah přepíše stávající layout.vsconfig obsah. Další informace najdete v předchozí části Použití konfiguračního souboru k inicializaci obsahu rozložení.

vs_enterprise.exe --layout C:\VSLayout --config "C:\myupdatedconfig.vsconfig"

Nakonec můžete konfigurační soubor přímo upravit layout.json ve složce rozložení a aktualizovat oddíl "přidat" tohoto souboru tak, aby zahrnoval další součásti, které chcete zahrnout do rozložení. Pak budete muset rozložení aktualizovat podle --layout předchozího popisu a stáhnout nejnovější komponenty.

Poznámka:

Nejjednodušší způsob, jak nainstalovat nově přidané komponenty rozložení do klientského počítače, je spustit bootstrapper v rozložení z klientského počítače. Oddíl "přidat" response.json souboru v rozložení určí, které komponenty jsou ve výchozím nastavení vybrány v uživatelském rozhraní instalačního programu klienta. Pokud jste rozložení upravili pomocí některé z výše uvedených metod, možná budete chtít ručně zkontrolovat a případně upravit oddíl "přidat" v response.json souboru tak, aby odpovídal obsahu v oddílu "přidat" nově upraveného layout.json souboru.

Nakonfigurujte rozložení pro odebrání komponent mimo podporu na klientském počítači.

Některé podniky budou chtít využít výhod funkce zavedené v sadě Visual Studio 2022 verze 17.4, která odebere součásti, které přešly do stavu mimo podporu. To je relativně snadné, pokud spravujete rozložení a pokud klienti dostávají aktualizace správce. Nejprve budete muset nakonfigurovat rozložení tak, aby měl nejnovější verzi instalačního programu, jak je popsáno níže. Za druhé budete muset do souboru přidat řádek "removeOos": trueresponse.json . Pokud má vaše rozložení správně nastavené tyto dva podrobnosti, následující aktualizace správce toto nastavení respektují a z klientských počítačů odeberou komponenty mimo podporu.

Ověření rozložení

Slouží --verify k ověření v rozložení sítě, které kontroluje, jestli soubory balíčků chybí nebo jsou neplatné. Na konci ověření vytiskne seznam chybějících a neplatných souborů.

Ověření funguje pouze pro nejnovější verzi konkrétní podverze sady Visual Studio. Jakmile bude vydána nová verze, ověření nebude fungovat u rozložení, která obsahují předchozí verze.

vs_enterprise.exe --layout <layoutDir> --verify

Poznámka:

Některé důležité soubory metadat, které tato --verify možnost potřebuje, musí být ve složce rozložení. Pokud tyto soubory metadat chybí, příkaz --verify nejde spustit a instalační program zobrazí chybu. Pokud dojde k této chybě, zkuste rozložení znovu aktualizovat nebo znovu vytvořte nové rozložení sítě v jiné složce.

Mějte na paměti, že Microsoft pravidelně dodává aktualizace sady Visual Studio, takže pokud používáte stálegreen bootstrapper, pak novější rozložení nemusí obsahovat stejnou verzi jako počáteční rozložení. Pokud ale použijete pevné bootstrappery propojení, získáte (téměř) vždy deterministické nastavení souborů.

Oprava rozložení

Slouží --fix k provedení stejného ověření jako --verify při pokusu o opravu zjištěných problémů. Proces --fix potřebuje připojení k internetu, proto se před vyvolám ujistěte --fix, že je počítač připojený k internetu.

vs_enterprise.exe --layout <layoutDir> --fix

Odebrání starších verzí z rozložení

Po provedení aktualizací rozložení mezipaměti sítě může mít složka rozložení některé zastaralé balíčky, které už nejnovější instalace sady Visual Studio nepotřebuje. Pomocí této možnosti můžete --clean odebrat zastaralé balíčky ze složky rozložení sítě.

K tomu budete potřebovat cesty k souborům pro manifesty katalogu, které obsahují tyto zastaralé balíčky. Manifesty katalogu najdete ve složce Archiv v mezipaměti rozložení sítě. Uloží se tam, když aktualizujete rozložení. Ve složce Archiv existuje jedna nebo více pojmenovaných složek GUID, z nichž každá obsahuje zastaralý manifest katalogu. Počet složek GUID by měl být stejný jako počet aktualizací provedených v rozloženích.

Několik souborů se uloží do každé složky GUID. Dva soubory, které jsou nejvíce zajímavé, jsou soubor "catalog.json" a "version.txt" soubor. Soubor "catalog.json" je zastaralý manifest katalogu, který budete muset předat této --clean možnosti. Druhý soubor version.txt obsahuje verzi tohoto zastaralého manifestu katalogu. Na základě čísla verze se můžete rozhodnout, jestli chcete z tohoto manifestu katalogu odebrat zastaralé balíčky. Můžete to udělat stejně jako v ostatních složkách GUID. Po rozhodnutí o katalogech, které chcete vyčistit, spusťte --clean příkaz zadáním cest k souborům do těchto katalogů.

Tady je příklad použití parametru --clean:

c:\VSLayout\vs_enterprise.exe --layout c:\VSLayout --clean c:\VSLayout\Archive\1cd70189-fc55-4583-8ad8-a2711e928325\Catalog.json --clean c:\VSLayout\Archive\d420889f-6aad-4ba4-99e4-ed7833795a10\Catalog.json

Při spuštění tohoto příkazu instalační program analyzuje složku rozložení sítě a vyhledá seznam souborů, které odebere. Pak budete mít možnost zkontrolovat soubory, které se odstraní, a potvrdit odstranění.

Nakonfigurujte rozložení tak, aby vždy zahrnovalo a poskytovalo nejnovější instalační program.

Poznámka:

Od června 2023 se ve výchozím nastavení odesílá nejnovější instalační program s každou aktualizací podporovaných verzí sady Visual Studio 2017, Visual Studio 2019 a Visual Studio 2022. Takže nebudete muset nic explicitně udělat, abyste získali nejnovější verzi instalačního programu s nejnovějšími funkcemi a opravami chyb do vašeho rozložení a do vašich klientů.

Pokud ale používáte rozložení vytvořené před červnem 2023, můžete také explicitně nakonfigurovat rozložení tak, aby vždy zahrnovalo a poskytovalo klientům nejnovější instalační program, i když se instalační program považuje za součást novější verze sady Visual Studio. Pokud se tedy klient aktualizuje z tohoto rozložení, klient získá nejnovější instalační program, který je součástí tohoto rozložení a který toto rozložení poskytuje. Výhodou je, že jakmile je na vašem klientovi nejnovější instalační program, instalace klientů budou moct využívat opravy chyb a nové funkce, které budeme do instalačního programu dál přidávat.

Existuje několik způsobů, jak povolit, aby rozložení zahrnovalo a poskytlo nejnovější instalační program:

• Můžete použít verzi sady Visual Studio, která byla vytvořená nebo po červnu 2023.

• Parametr můžete předat --useLatestInstaller bootstrapperu při vytváření nebo aktualizaci rozložení. To způsobí, že nastavení se nastaví v layout.json souboru, které najdete v kořenovém adresáři rozložení. Tady je příklad, jak aktualizovat rozložení a nakonfigurovat ho tak, aby používal nejnovější a nejlepší dostupný instalační program.

  vs_enterprise.exe --layout C:\VSLayout --useLatestInstaller
  

• Soubor můžete upravit layout.json přímo a přidat toto nastavení.

  {
     "installChannelUri": ".\\ChannelManifest.json",
     "channelUri": "\\\\server\\share\\layoutdirectory\\ChannelManifest.json",
     "installCatalogUri": ".\\Catalog.json",
     "channelId": "VisualStudio.16.Release",
     "productId": "Microsoft.VisualStudio.Product.Enterprise",
  
     "useLatestInstaller": true,
     "removeOos": true
  
  }
  

Neexistuje způsob, jak toto nastavení v layout.json souboru programově odebrat, takže pokud chcete, aby rozložení přestalo používat nejnovější instalační program, který microsoft zpřístupní, a místo toho použijte verzi instalačního programu, která odpovídá zaváděcímu nástroji (což je většinou starší než nejnovější instalační program), upravte layout.json soubor a odeberte "UseLatestInstaller": true nastavení.

Všimněte si, že toto "UseLatestInstaller": true nastavení můžete najít i v souboru rozložení response.json , ale pro účely zajištění toho, aby rozložení vždy mělo nejnovější instalační program, je tam ignorováno. Soubor response.json slouží k nastavení výchozích možností konfigurace v klientovi při instalaci nebo aktualizaci klienta z rozložení. Toto konkrétní "useLatestInstaller": true nastavení v layout.json souboru slouží k zajištění toho, aby obsah rozložení obsahoval nejnovější instalační program, aby klientské počítače mohly získat nejnovější instalační program z rozložení.

Kódy chyb

Pokud jste použili --wait parametr, pak 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í ivity
-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.

Získání podpory pro rozložení sítě

Pokud máte potíže s rozložením sítě, chceme o tom vědět. Nejlepší způsob, jak nám to říct, je pomocí 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 IT Správa istrator a nemáte nainstalovanou sadu Visual Studio, můžete sem odeslat svůj názor na IT Správa. Pokud použijete tento nástroj, bylo by velmi užitečné, kdybyste mohli odeslat protokoly nástrojem Visual Studio Collect, který nám může pomoct diagnostikovat a opravit problém.

Nabízíme také možnost podpory instalačního chatu (pouze v angličtině) pro problémy související s instalací.

K dispozici jsou i další možnosti podpory. Podívejte se na naši komunitu vývojářů sady Visual Studio.

Související obsah

• Příručka pro správce sady Visual Studio
• Nasazení sady Visual Studio z rozložení na klientský počítač
• Aktualizace síťové instalace sady Visual Studio
• Řešení chyb souvisejících se sítí při instalaci nebo používání sady Visual Studio
• Konfigurace zásad pro podniková nasazení sady Visual Studio
• Životní cyklus a údržba produktů sady Visual Studio
• Instalace sady Visual Studio s použitím parametrů příkazového řádku
• ID úloh a komponent sady Visual Studio
• Instalace certifikátů požadovaných pro offline instalaci sady Visual Studio