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

📣 Rádi bychom slyšeli vaši zpětnou vazbu!Věnujte prosím chvilku dokončení tohoto průzkumu a dejte nám vědět, jak můžeme vylepšit váš zážitek s rozložením. Děkujeme vám za vaši podporu!

Podnikový správce někdy chce vytvořit mezipaměť privátní instalace (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 scénářích:

• Uživatel s omezenými systémovými oprávněními
• Klientské počítače s omezeným přístupem 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 rozložení do síťové sdílené složky a zpřístupnit ho v intranetu.
• Udržovatrozložení: informace o tom, jak nejlépe aktualizovat verzi produktu rozložení, nebo upravit obsah produktu, nastavení kanálu, verzi instalačního programu a velikost složky.
• nápovědy a podpory: kde požádat o pomoc

Vytvoření rozložení

Příprava úložiště pro sdílenou síťovou složku

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 k rozložení musí být kratší než 80 znaků; úspěšně používají některé organizace symbolické linky pro vyř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 2026 v aktuálním kanálu bez ohledu na to, kdy je spustíte. Pokud chcete vytvořit nebo aktualizovat rozložení na konkrétní verzi nebo konkrétní kanál sady Visual Studio 2026, stáhněte si příslušný bootstrapper. Evergreen i pevné verze instalačních programů pro každé servisní vydání a kanál jsou k dispozici na stránce Historie verzí sady Visual Studio 2026. Stáhněte si požadovaný soubor a zkopírujte ho do adresáře, který chcete použít jako zdrojové umístění rozložení.

Vydání	Bootstrapper
Visual Studio 2026 Enterprise	vs_enterprise.exe
Visual Studio 2026 Professional	vs_professional.exe
Visual Studio 2026 Community	vs_community.exe
Visual Studio 2026 Nástroje pro sestavení	vs_buildtools.exe

Spropitné

Pokud jste si dříve stáhli soubor bootstrapperu a chcete ověřit verzi, kterou nainstaluje, tady je postup. Ve Windows otevřete Průzkumníka souborů, klikněte pravým tlačítkem na soubor bootstrapperu, zvolte Vlastnosti a pak zvolte kartu Podrobnosti. Pole verze produktu popisuje kanál a verzi, které nainstaluje bootstrapper. Čí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. Proto bootstrapper s produktovou verzí Stable 18.0 nainstaluje nejnovější servisní verzi 18.0.x, která je dostupná na kanálu Stable 18.0. Bootstrapper s verzí produktu označenou jako Visual Studio 2026 nainstaluje nejnovější servisní verzi Visual Studio 2026 na stabilní kanál.

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 použijte parametry příkazového řádku, jak jsou definovány na stránce použití parametrů příkazového řádku k instalaci Visual Studio, abyste vytvořili a spravovali vaše rozložení sítě. Následující příklady ukazují běžné způsoby vytváření počátečních rozložení. Další příklady najdete na stránce instalace sady Visual Studio v příkladech parametrů příkazového řádku .

Ú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. Další jazykové verze vyžadují přibližně půl GB každá.

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 následující příkaz z adresáře, který plánujete použít pro hostování síťového rozložení.

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. Důvodem je to, že kanál je jedním z kritérií, která jsou používána správci aktualizací při nasazování v celé organizaci, aby bylo možné určit, které instance klienta by měly být aktualizovány. 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 ze serverů hostovaných Microsoftem, budou všechny aktualizace zabezpečení vydané v kanálu LTSC 17.0 LTSC dostupné klientům, kteří toto rozložení nainstalovali nebo aktualizovali.

Dříve uvedené bootstrappery 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 z historie verzí sady Visual Studio 2022 stránku, 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 pouze konkrétní sadu jazykových prostředí , úkolů , 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ří:

• --add ke specifikaci ID úloh nebo komponent .
  Pokud --add použijete, stáhnou se jenom úlohy a komponenty zadané pomocí --add. Pokud --add nepoužíváte, stáhnou se všechny úlohy a komponenty.
• --includeRecommended zahrnout všechny doporučené součásti pro specifikované identifikátory úloh.
• --includeOptional zahrnout všechny volitelné komponenty pro zadané ID úloh.
• --config použít soubor *.vsconfig k určení úloh, komponent nebo rozšíření, které by mělo být součástí rozložení nebo na na který odkazuje rozložení. Ujistěte se, že jste zadali úplnou cestu konfiguračního souboru.
• --lang pro určení jazykových místních nastavení .

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

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

Jakékoli přípony uvedené v souboru *.vsconfig se nekopírují přímo do rozložení. Místo toho soubor response.json rozložení obsahuje odkaz na nově vytvořený soubor layout.vsconfig, který definuje umístění instalace pro přípony klienta. Pokud instalujete rozšíření, která nejsou digitálně podepsaná, nezapomeňte upravit response.json a přidat "allowUnsignedExtensions": true. Viz response.json 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ří soubor s názvem response.json. Tento přizpůsobitelný soubor poskytuje počáteční výchozí nastavení pro konfiguraci na klientovi, když se klient poprvé 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 je nepodepsaným rozšířením umožněno tiše načítat programově &

Další informace najdete na stránce Automatizace instalace sady Visual Studio pomocí 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ém webu, což vám umožní využít možnosti ukládání souborů do mezipaměti na webovém serveru a výkonové kapacity georeplikace. Pokud chcete tuto novou funkci použít, musíte použít nejnovější bootstrappery sady Visual Studio a nejnovější instalační program sady 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 dostávali aktualizace z umístění rozložení intranetu.

2. Dále musí administrátor připravit interní webovou stránku a propojit zdroj webu na síťové umístění souboru rozvrž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, spuštěním skriptu PowerShellu na klientovi provést počáteční instalaci. Po úspěšné instalaci sady Visual Studio do klienta z rozložení hostovaného na webu lze aktualizace klienta pro rozložení hostovaná na webu 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 dodává ve výchozím nastavení s každou aktualizací všech podporovaných verzí sady Visual Studio 2017 a novější. Pokud tedy používáte některou z těchto verzí produktu, 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 ve svém rozložení vždy používat nejnovější instalační program sady Visual Studio a distribuovat ho 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 visual Studio 2019 bootstrappers sestavené 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 jako zdroj aktualizace 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, stáhněte aktualizované rozložení do privátní místní sdílené složky (například c:\VSLayoutUpdate). Po stažení 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, mohou uživatelé během aktualizace rozložení spustit instalaci a získat nesprávný obsah z rozložení, protože rozložení ještě nebylo aktualizováno.

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 pouze přijímat aktualizace produktů z rozhraní. Visual Studio obvykle vydává aktualizace zabezpečení druhé úterý v měsíci, označovaném jako „Patch Tuesday“, takže dobrá strategie by měla být aktualizovat všechna rozložení odpoledne na Patch Tuesday.

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 rozložení layout.json. 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 již toto částečné rozvržení vytvořili pomocí jednoho z evergreen bootstrapperů uvedených v předchozí tabulce.

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 příkaz --layout 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 došlo. 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 aktualizovat rozložení 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 rozložení a použít ho k aktualizaci rozložení na tuto přesnou verzi uvedenou ve bootstrapperu. Použili byste stejnou syntaxi jako výše.

Pro aktualizaci vašeho rozložení na konkrétní verzi produktu můžete použít aktualizaci správce . Chcete-li získat aktualizace pro administrátory, přejděte na katalog služby Microsoft Updatea vyhledejte aktualizaci, kterou chcete použít pro aktualizaci rozložení. Stáhněte si update.exe 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-18.0.0to18.4.4.exe layout --layoutPath c:\VSLayout

Aktualizace správce neicializuje vytvoření nového rozložení; aktualizuje pouze existující rozložení. K vytvoření počátečního rozložení musíte použít nástroj bootstrapper.

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

Při přechodu kanálů z podpory někdy musíte 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, po ukončení podpory kanálu 17.0 LTSC v červenci 2023 nebudeme vydávat žádné další aktualizace zabezpečení a vaše rozložení a klienti se stanou nezabezpečeným. Termíny podpory pro různé kanály sady Visual Studio 2022 najdete zde.

Pokud chcete změnit kanál, ze kterého je rozložení založené, získejte bootstrapper požadovaného kanálu z historie verzí sady Visual Studio 2022 stránku, 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 také v bezpečí.

Úprava obsahu rozložení

Částečné rozložení je možné upravit a přidat další úlohy, komponenty nebo jazyky. Není možné spolehlivě odebrat součásti 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 jsou v tomto rozložení zahrnuté úlohy Managed Desktopu i Azure a v tomto rozložení jsou zahrnuté jak anglické, tak německé prostředky. Kromě přidávání komponent --layout příkaz také způsobí aktualizaci rozložení na verzi určenou bootstrapperem. Takže pokud používáte evergreen bootstrapper, výsledné rozložení má novou komponentu, nový jazyk a veškerý obsah rozložení se aktualizují na nejnovější verzi z 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ý obsah *.vsconfig přepíše stávající obsah layout.vsconfig. Další informace naleznete 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 přímo upravit konfigurační soubor 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í. Potom je potřeba aktualizovat rozložení podle --layout předchozího popisu, abyste stáhli 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" souboru response.json 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 předchozích metod, možná budete chtít ručně zkontrolovat a případně upravit oddíl "přidat" v response.json souboru tak, aby ho vhodnější odpovídal obsahu v oddílu "přidat" nově upraveného layout.json souboru.

Konfigurujte rozvržení pro odebrání nepodporovaných komponent 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 přidat řádek "removeOos": true do souboru response.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ěřit rozložení

Pomocí --verify proveďte 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é vyžadují možnost --verify, 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.

Nezapomeňte, ž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é zaváděcí nástroje pro propojení, pak (téměř) vždy získáte deterministický soubor.

Oprava rozložení

Pomocí --fix proveďte stejné ověření jako --verify a zkuste také opravit zjištěné problémy. Proces --fix potřebuje připojení k internetu, proto se před vyvoláním --fixujistěte, že je počítač připojený k internetu.

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

Odebrat starší verze 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í možnosti --clean můžete ze složky rozložení sítě odebrat zastaralé balíčky.

K tomu budete potřebovat cestu/cesty k souborům manifestu/manifestů 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. Souborcatalog.jsonje zastaralý manifest katalogu, který je potřeba předat k možnosti --clean. 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 udělat totéž, když procházíte ostatní složky „GUID“. Po rozhodnutí o katalogech, které chcete vyčistit, spusťte příkaz --clean 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 nejnovější instalační program dodává ve výchozím nastavení s každou aktualizací všech podporovaných verzí sady Visual Studio 2017 a novější. Pokud tedy používáte některou z těchto verzí produktu, 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 ale používáte rozložení vytvořené před červnem 2023, můžete také explicitně nakonfigurovat rozložení tak, aby vždy zahrnout a poskytnout 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řena v červnu 2023 nebo později.

• Parametr --useLatestInstaller můžete předat bootstrapperu při vytváření nebo aktualizaci rozložení. To způsobí, že nastavení se nastaví v souboru layout.json, 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
  

• Toto nastavení můžete upravit přímo v souboru layout.json.

  {
     "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
  
  }
  

V souboru layout.json neexistuje způsob, jak toto nastavení programově odebrat, takže pokud chcete, aby vaše rozložení zastavit pomocí nejnovějšího instalačního programu, který Microsoft zpřístupňuje, a místo toho použijte verzi instalačního programu, která odpovídá bootstrapperu (což je většinou starší než nejnovější instalační program), upravte layout.json soubor a odeberte nastavení "UseLatestInstaller": true.

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

Kódy chyb

Pokud jste použili parametr --wait, pak 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í 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
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	Volitelné selhání mimo podporu
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. 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.

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 použít nástroj 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 zde odeslat zpětnou vazbu pro správce IT . Pokud použijete tento nástroj, bylo by velmi užitečné, pokud byste mohli odesílat protokoly nástrojem Visual Studio Collect, což nám může pomoct diagnostikovat a opravit problém.

Nabízíme také možnost podpory při instalaci prostřednictvím instalačního chatu (jen v angličtině) pro otázky 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

• průvodce správcem 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 produktu Visual Studio
• Instalace sady Visual Studio pomocí parametrů příkazového řádku
• ID úloh a komponent sady Visual Studio
• Instalace certifikátů požadovaných pro offline instalaci sady Visual Studio