Skapa och underhålla en nätverksinstallation av Visual Studio

📣 Vi vill gärna höra din feedback!Ta en stund att slutföra den här undersökningen och berätta hur vi kan förbättra layoutupplevelsen. Tack för ditt stöd!

Ibland vill en företagsadministratör skapa en privat installationscachen (kallas även "layout") som innehåller Visual Studio-filer som kan distribueras till klientdatorer i en organisation.

Det är användbart att skapa en layout i följande situationer:

• En användare har begränsade behörigheter
• Klientdatorerna har begränsad åtkomst till Internet
• En organisation vill standardisera på en viss version av utvecklarverktygsuppsättningen

Vi har utformat Visual Studio så att en administratör både kan skapa och underhålla en layout och lagra den på en intern nätverksresurs och eventuellt göra den tillgänglig i en organisations intranät. Layouten fungerar som källplats för alla Visual Studio-filer som behövs för både den första klientinstallationen och efterföljande uppdateringar.

Informationen på den här sidan är grupperad i tre huvudavsnitt:

• Skapa layouten: beskriver hur du skapar layouten med rätt produktinnehåll, konfigurerar standardinställningarna, lagrar den på en nätverksfilresurs och gör den tillgänglig i intranätet.
• Underhåll layouten: information om hur du uppdaterar layoutens produktversion på bästa sätt eller ändrar layoutens produktinnehåll, kanalinställningar, installationsversion och mappstorlek.
• hjälp och support: var du kan be om hjälp

Skapa layouten

Förbered nätverksdelningens lagringsplats

Först måste du bestämma var du ska lagra de nedladdade Visual Studio-paketen. Om du har flera utgåvor av Visual Studio som används i företaget (till exempel Visual Studio 2022 Professional och Visual Studio 2022 Enterprise) måste du skapa en separat layout för varje utgåva. Att skapa en separat layout för varje utgåva kan förbruka mycket diskutrymme, särskilt när du tänker på att layoutuppdateringar också förbrukar diskutrymme.

Layoutsökvägen måste vara mindre än 80 tecken; vissa organisationer använder framgångsrikt symboliska länkar för att kringgå begränsningen på 80 tecken.

Ladda ned Visual Studio bootstrapper för att skapa layouten

Ladda ned rätt bootstrapper för den version av Visual Studio som du vill använda och kopiera den till den katalog som du vill ska fungera som layoutens lagringsplats. När layouten har skapats kan du sedan använda den för att installera Visual Studio på valfri klientdator. Bootstrapper är den körbara fil som du använder för att skapa, uppdatera och utföra andra layoutåtgärder. Du måste ha en Internetanslutning och administratörsbehörighet för att slutföra det här steget.

Följande bootstrappers installerar alltid den senaste säkraste versionen av Visual Studio 2022 på den aktuella kanalen, oavsett när du kör dem. Om du vill skapa eller uppdatera en layout till en viss version eller en specifik kanal i Visual Studio 2022 kan du också ladda ned den alltid aktuella och fasta versionen av startprogrammet för underhållsversionen för den kanal som du vill ha från Visual Studio 2022 Versionshistorik. Kopiera den till den katalog som du vill fungera som källplats för layouten.

Utgåva	Bootstrapper
Visual Studio 2022 Enterprise	vs_enterprise.exe
Visual Studio 2022 Professional	vs_professional.exe
Visual Studio 2022 Community	vs_community.exe
Byggverktyg för Visual Studio 2022	vs_buildtools.exe

Tips

Om du tidigare har laddat ned en bootstrapper-fil och vill verifiera vilken version den kommer att installera, gör du så här. Öppna Utforskaren i Windows, högerklicka på filen bootstrapper, välj Egenskaper och välj sedan fliken Information. I fältet Produktversion beskrivs den kanal och version som bootstrappern ska installera. Versionsnumret ska alltid läsas som "senaste serviceversion av det som har angetts", och kanalen antas vara Aktuell om inte uttryckligen anges. Så installerar en bootstrapper med en produktversion av LTSC 17.0 den senaste servicereleasen av version 17.0.x som är tillgänglig på 17.0 LTSC-kanalen. En bootstrapper med en produktversion som anger Visual Studio 2022 installerar den senaste underhållsversionen av Visual Studio 2022 på den aktuella kanalen.

Ladda ned Visual Studio-paketen

Du måste ha en Internetanslutning för att slutföra det här steget.

Öppna en upphöjd kommandotolk, navigera till katalogen där du laddade ned bootstrappern och använd bootstrapperns parametrar enligt definitionen i använda kommandoradsparametrar för att installera Visual Studio-sidan för att skapa och underhålla nätverkslayouten. I följande exempel visas vanliga sätt att skapa inledande layouter. Fler exempel finns på sidan med kommandoradsparameterexempel för en Visual Studio-installation.

En fullständig inledande layout för ett språkspråk kräver cirka 40 GB diskutrymme för Visual Studio Community och cirka 50 GB för Visual Studio Enterprise. Extra språkvarianter kräver ungefär en halv GB vardera.

Den rekommenderade metoden är att skapa en inledande layout för Visual Studio med alla arbetsbelastningar och lämpliga språk och lagra paketen i layoutkatalogen på nätverksservern. På så sätt har alla klientinstallationer åtkomst till hela Visual Studio-produkterbjudandet och möjligheten att installera alla delmängder. Om du vill skapa en fullständig layout för Visual Studio kör du följande kommando från katalogen som du planerar att vara värd för nätverkslayouten på:

vs_enterprise.exe --layout c:\VSLayout

Kontrollera att layouten är baserad på rätt kanal

Det är viktigt att se till att nätverkslayouten baseras på rätt kanaleftersom det är ett av de kriterier som administratörsuppdateringar, om de distribueras i hela organisationen, använder för att identifiera vilka klientinstanser som ska uppdateras. Om layouten till exempel baseras på kanalen VisualStudio.17.Release.LTSC.17.0 och om dina klienter är konfigurerade för att ta emot uppdateringar från Microsofts värdbaserade servrar, är alla säkerhetsuppdateringar som görs tillgängliga på LTSC-kanalen 17.0 tillgängliga för klienterna som har installerats eller uppdaterats från layouten.

De bootstrappers som listades tidigare är baserade på den nuvarande kanalen. Om du vill skapa en layout som baseras på någon av LTSC-kanalerna hämtar du rätt kanals bootstrapper från Visual Studio 2022 Versionshistorik sidan, kopierar den till layoutmappen och använder den för att skapa eller uppdatera layouten.

Konfigurera innehållet i en layout

Det finns flera alternativ som du kan använda för att anpassa innehållet i nätverkslayouten. Du kan skapa en partiell layout som bara innehåller en specifik uppsättning språkvarianter, arbetsbelastningar, komponenter och deras rekommenderade eller valfria beroenden. En partiell layout är användbar om du vet att du bara ska distribuera en delmängd av arbetsbelastningar till klientarbetsstationer. Vanliga kommandoradsparametrar för att anpassa layouten är:

• --add för att ange arbetsbelastnings- eller komponent-ID:t.
  Om --add används laddas endast de arbetsbelastningar och komponenter som anges med --add ned. Om --add inte används laddas alla arbetsbelastningar och komponenter ned.
• --includeRecommended inkluderar alla rekommenderade komponenter för de angivna arbetsbelastnings-ID:erna.
• --includeOptional för att inkludera alla valbara komponenter för de specificerade arbetsbelastnings-ID:erna.
• --config att använda en *.vsconfig-fil för att ange arbetsuppgifter, komponenter eller tillägg som ska ingå i layouten eller refereras till av den. Kontrollera att du anger den fullständiga sökvägen för konfigurationsfilen.
• --lang om du vill ange språkvarianter.

Här följer några exempel på hur du skapar en anpassad nätverkslayout.

• Om du vill skapa en layout med nödvändiga komponenter för alla arbetsbelastningar på bara ett språk kör du:

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

• Om du vill skapa en layout med nödvändiga komponenter för alla arbetsbelastningar på flera språk kör du:

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

• Om du vill skapa en layout med en arbetsbelastning och alla nödvändiga och rekommenderade komponenter för den arbetsbelastningen på alla språk kör du:

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

• Om du vill skapa en layout med två arbetsbelastningar och en valfri komponent på tre språk kör du:

  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
  

Använda en konfigurationsfil för att initiera innehållet i en layout

Du kan använda parametern --config för att skicka en *.vsconfig fil. Kontrollera att du anger den fullständiga sökvägen för konfigurationsfilen. Om du använder en *.vsconfig fil när layouten skapas anpassas och begränsas innehållet i en nätverkslayout till det som anges i konfigurationsfilen. Konfigurationsfilen kopieras till layoutkatalogen och byter namn till layout.vsconfig.

Alla tillägg som anges i *.vsconfig-filen kopieras inte direkt till layouten. I stället innehåller layoutens response.json-fil en referens till den nyligen skapade layout.vsconfig-filen, som definierar installationsplatsen för klientens tillägg. Om du installerar tillägg som inte är digitalt signerade måste du redigera response.json för att lägga till "allowUnsignedExtensions": true. Se response.json innehållsexempel.

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

Kopiera layouten till en nätverksandel

Du behöver lägga upp layouten på en nätverksplats så att den kan nås från klientdatorerna. Om du har skapat layouten på en lokal dator måste du kopiera den till en nätverksfilplats. I följande exempel används xcopy. Du kan också använda robocopy, om du vill. Exempel:

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

Konfigurera standardinställningar för inledande klientinstallation för den här layouten

En fil med namnet response.json skapas i layoutens rotmapp. Den här anpassningsbara filen tillhandahåller de första standardinställningarna för att konfigurera på klienten, när klienten först installeras från layouten. Vanliga konfigurationsalternativ är möjligheten att konfigurera:

• Vilka arbetsbelastningar, komponenter eller språk som ska installeras som standard på klienten
• Om rekommenderade komponenter också ska installeras
• Om klienten ska respektera en installationsfil *.vsconfig
• Var ska klienten ta emot uppdateringar från
• Om komponenter som inte längre stöds ska tas bort under en uppdatering
• Om osignerade tillägg tillåts läsas in tyst & programmatiskt

Mer information finns på sidan automatisera installationen av Visual Studio med en svarsfil.

Göra layouten tillgänglig via en intranätplats

Från och med juni 2023 kan du göra layouterna tillgängliga på en intern intranätplats, vilket gör att du kan dra nytta av prestandafunktionerna för cachelagring av webbserverfiler och georeplication. Om du vill använda den här nya funktionen måste du använda de senaste Visual Studio-bootstrappersna och den senaste Visual Studio Installer. IT-administratörer måste göra följande för att dra nytta av den här webbhostingtjänsten för intranätet:

1. Först, skapa och underhåll en nätverkslayout och se till att databitarna finns och uppdateras regelbundet på nätverksdelningen. Kom också ihåg att konfigurera värdet channelUri i layoutens response.json om du vill att dina klienter ska få sina uppdateringar från intranätets layoutplats.

2. Därefter måste en administratör förbereda en intern webbplats och binda webbplatsens källa till layoutens nätverksfilplats. De måste också se till att webbservern respekterar följande MIME-typer:

   filnamnstillägg	MIME-typ
   .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. Slutligen, för att distribuera den här layouten på klienten kör ett PowerShell-skript på klienten för att utföra den första installationen. När Visual Studio har installerats på klienten från en webbhanterad layout kan klientuppdateringar för webbvärdslayouter uppdateras via standardmetoder.

Kontrollera att layouten använder det senaste installationsprogrammet

Not

Från och med juni 2023 levereras det senaste installationsprogrammet som standard med varje uppdatering till alla versioner av Visual Studio 2017, Visual Studio 2019 och Visual Studio 2022 som stöds. Så om du använder någon av dessa produktversioner behöver du inte göra något explicit för att få den senaste versionen av installationsprogrammet med de senaste funktionerna och felkorrigeringarna.

Om du använder en version av Visual Studio som levererades före juni 2023 rekommenderar vi att du alltid använder den senaste Visual Studio Installer i layouten och distribuerar den till dina klienter. Om du till exempel distribuerar Installationsprogrammet för Visual Studio 2022 i visual studio 2019-layouten kan dina Visual Studio 2019-klienter baserat på den layouten ändra källplatsen för uppdateringar eller enkelt ta bort komponenter som inte stöds. Mer information finns beskrivs i följande avsnitt.

Funktionen för att säkerställa programmässigt att du använder det senaste installationsprogrammet är endast tillgänglig för Visual Studio 2019-bootstrappers som skapades efter att Visual Studio 2022 ursprungligen levererades. Därför måste vs_enterprise.exe i följande exempel vara en version som levererades efter 10 november 2021.

Om du vill skapa en layout för hela produkten som använder det senaste och bästa installationsprogrammet som är tillgängligt kör du

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

Att underhålla layouten

Det är en bra idé att regelbundet uppdatera Visual Studio-layouten till den senaste säkra versionen av produkten. Detta säkerställer att layouten kan användas både som en installationspunkt och en uppdateringskälla för klientinstallationer. I följande avsnitt beskrivs de vanligaste eller mest användbara layoutunderhållsåtgärderna.

Om du är värd för en layout på en nätverksfilresurs kanske du vill ladda ned en uppdaterad layout till en privat lokal resurs (till exempel c:\VSLayoutUpdate) och sedan, när allt uppdaterat innehåll har laddats ned, kopiera den till din nätverksfilresurs för layout (till exempel \server\products\VS). Om du inte gör det kan användare som råkar köra installationsprogrammet när du uppdaterar layouten få ett matchningsfel för innehåll från layouten eftersom det ännu inte har uppdaterats helt.

Uppdatera layouten till den senaste versionen av produkten

Microsoft släpper ofta uppdaterade versioner av produkten för att åtgärda funktioner eller säkerhetsproblem. Vi rekommenderar starkt att du håller layouten uppdaterad med den senaste versionen av produkten så att dina klienter alltid har åtkomst till den senaste säkraste versionen av produkten. Detta är särskilt viktigt om dina klienter inte har internetåtkomst och bara kan ta emot produktuppdateringar från layouten. Visual Studio släpper vanligtvis säkerhetsuppdateringar den andra tisdagen i månaden, som kallas "Patch Tuesday", så en bra strategi skulle vara att uppdatera alla layouter på eftermiddagen på Patch Tuesday.

När du skapar den inledande layouten sparas de angivna alternativen, till exempel vilka arbetsbelastningar och språk som ska ingå i layouten, i layoutens konfigurationsfil layout.json. När du senare uppdaterar layouten till en nyare version av produkten behöver du inte ange vilka komponenter i produkten du vill använda i layouten igen. En layoutuppdatering uppdaterar helt enkelt de befintliga komponenterna i layouten till den senaste versionen.

Anta att du redan har skapat den här partiella layouten med , en av de ständigt aktuella bootstrappers i tabellen ovan.

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

Det är enkelt att uppdatera den här layouten till den senaste versionen av den produkt som microsoft erbjuder och som finns på Microsoft-servrar. Du behöver bara använda den befintliga evergreen bootstrappern i layouten och köra kommandot --layout i en upphöjd prompt för att ladda ned de senaste paketen till layouten på följande sätt:

vs_enterprise.exe --layout c:\VSLayout

Du kan också uppdatera layouten till en uppdaterad version på ett obevakat sätt. Layoutåtgärden kör installationsprocessen i ett nytt konsolfönster. Fönstret lämnas öppet så att administratörer kan se det slutliga layoutuppdateringsresultatet och en sammanfattning av eventuella fel som kan ha inträffat. Om du vill utföra en layoutuppdateringsåtgärd på ett obevakat sätt (du har till exempel ett skript som körs regelbundet för att uppdatera layouten till den senaste versionen) använder du parametern --passive så stängs fönstret automatiskt.

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

Uppdatera layouten till en viss version av produkten

Ibland kanske du vill uppdatera layouten till en viss version av produkten. Du kanske till exempel vill att layouten ska matcha den senaste säkra versionen av servicebaslinjen som du har standardiserat din organisation på. Så här gör du så här:

Du kan gå till sidan Visual Studio 2022 Versionshistorik och ladda ned en specifik bootstrapper för en fast version, kopiera den till din layout och använda den för att uppdatera layouten till den specifika versionen som anges av bootstrappern. Du använder exakt samma syntax som ovan.

Du kan använda en administratörsuppdatering för att uppdatera layouten till en viss version av produkten. Om du vill hämta administratörsuppdateringengår du till Microsoft Update Catalogoch söker efter den uppdatering som du vill uppdatera layouten till. Ladda ned update.exe till datorn som är värd för layouten, öppna en upphöjd kommandotolk på datorn och kör ett kommando som liknar detta:

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

Observera att en administratörsuppdatering inte initierar skapandet av en ny layout. den uppdaterar endast en befintlig layout. Du måste använda en bootstrapper för att skapa den initiala layouten.

Se till att nätverkslayouten baseras på en version som stöds

Ibland, när kanaler övergår från support, måste du se till att nätverkslayouten fortsätter att baseras på en kanal som stöds så att dina klienter kan fortsätta att ta emot meddelanden om säkerhetsuppdateringar. Om layouten är baserad på kanalen VisualStudio.17.Release.LTSC.17.0 kommer vi inte att släppa fler säkerhetsuppdateringar till den när 17.0 LTSC-kanalen upphör att stödjas i juli 2023, och din layout och klienter blir osäkra. Supportdatum för olika Visual Studio 2022-kanaler finns här.

Om du vill ändra den kanal som layouten baseras på hämtar du den önskade kanalens bootstrapper från sidan Visual Studio 2022 Versionshistorik, kopierar den till layoutmappen och utför en normal uppdatering. Dina klienter bör sedan meddelas på lämpligt sätt om en uppdatering så att de också kan hålla sig säkra.

Ändra innehållet i en layout

Det går att ändra en partiell layout och lägga till ytterligare arbetsbelastningar, komponenter eller språk. Det är inte möjligt att på ett tillförlitligt sätt ta bort komponenter från en layout.

I exemplet nedan lägger vi till Azure-arbetsbelastningen och ett lokaliserat språk i layouten som tidigare skapades med bara arbetsbelastningen Hanterat skrivbord och engelska. När vi har gjort ändringen kommer både Managed Desktop- och Azure-arbetsbelastningarna och både de engelska och tyska resurserna att ingå i den här layouten. Förutom att lägga till komponenter gör kommandot --layout också att layouten uppdateras till den version som anges av bootstrappern. Om du använder evergreen bootstrapperkommer den resulterande layouten att ha den nya komponenten, det nya språket, och allt layoutinnehåll kommer att uppdateras till den senaste versionen på bootstrapper-kanalen.

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

Om du vill ändra en befintlig partiell layout så att den blir en fullständig layout använder du alternativet --all, som du ser i följande exempel. Återigen gör det här kommandot att layoutinnehållet uppdateras till den version som anges av bootstrappern.

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

Du kan lägga till komponenter i en layout genom att skicka in en *.vsconfig fil som innehåller de ytterligare komponenter som du vill använda i layouten. Om du gör det skriver det nya *.vsconfig innehållet över det befintliga layout.vsconfig innehållet. Mer information finns i föregående avsnitt Använda en konfigurationsfil för att initiera innehållet i en layout.

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

Slutligen kan du redigera layout.json konfigurationsfilen direkt i layoutmappen och uppdatera avsnittet "lägg till" i filen så att den innehåller de ytterligare komponenter som du vill inkludera i layouten. Sedan måste du uppdatera layouten med hjälp av --layout enligt beskrivningen tidigare för att ladda ned de senaste komponenterna.

Not

Det enklaste sättet att installera de nyligen tillagda layoutkomponenterna på en klientdator är att köra bootstrappern i layouten från klientdatorn. Avsnittet "lägg till" i response.json-filen i layouten avgör vilka komponenter som väljs som standard i klientens installationsgränssnitt. Om du har ändrat layouten med någon av metoderna ovan kanske du vill dubbelkolla manuellt och eventuellt justera avsnittet "lägg till" i filen response.json så att den bättre matchar innehållet i avsnittet "lägg till" i den nyligen ändrade layout.json filen.

Konfigurera layouten för att ta bort komponenter som inte stöds på klientdatorn.

Vissa företag vill dra nytta av funktionen som introducerades i Visual Studio 2022 version 17.4 som tar bort komponenter som har övergått till ett tillstånd som inte stöds. Det här är relativt enkelt att konfigurera om du hanterar en layout och om dina klienter får administratörsuppdateringar. Först måste du konfigurera layouten så att den har den senaste versionen av installationsprogrammet enligt beskrivningen nedan. För det andra måste du lägga till raden "removeOos": true i filen response.json. Om layouten har dessa två detaljer korrekt inställda kommer efterföljande administratörsuppdateringar att respektera den här inställningen och ta bort komponenter som inte stöds från klientdatorerna.

Verifiera en layout

Använd --verify för att utföra verifiering på nätverkslayouten som kontrollerar om paketfilerna antingen saknas eller är ogiltiga. I slutet av verifieringen skrivs listan över saknade och ogiltiga filer ut.

Verifiering fungerar endast för den senaste versionen av en specifik delversion av Visual Studio. Så snart en ny version har släppts fungerar verifieringen inte för layouter som innehåller tidigare versioner.

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

Not

Vissa viktiga metadatafiler som krävs av alternativet --verify måste finnas i layoutmappen. Om dessa metadatafiler saknas kan "--verify" inte köras och du får ett felmeddelande. Om det här felet uppstår kan du försöka uppdatera layouten igen eller återskapa en ny nätverkslayout i en annan mapp.

Kom ihåg att Microsoft skickar uppdateringar till Visual Studio regelbundet, så om du använder en ständigt uppdaterad bootstrapperkan en nyare layout kanske inte innehålla samma version som den ursprungliga layouten. Men om du använder en bootstrappers med fast länk , får du nästan alltid en deterministisk filuppsättning.

Åtgärda en layout

Använd --fix för att utföra samma verifiering som --verify och försök även åtgärda de identifierade problemen. Den --fix processen behöver en Internetanslutning, så se till att datorn är ansluten till Internet innan du anropar --fix.

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

Ta bort äldre versioner från en layout

När du har gjort layoutuppdateringar i ett nätverkscachen kan layoutmappen ha några föråldrade paket som inte längre behövs av den senaste Visual Studio-installationen. Du kan använda alternativet --clean för att ta bort föråldrade paket från mappen nätverkslayout.

För att göra detta behöver du filsökvägarna till katalogmanifesten som innehåller de föråldrade paketen. Du hittar katalogmanifesten i en "Arkiv"-mapp i cachen för nätverkslayouten. De sparas där när du uppdaterar en layout. I mappen "Arkiv" finns det en eller flera "GUID"-namngivna mappar, som var och en innehåller ett föråldrat katalogmanifest. Antalet "GUID"-mappar ska vara detsamma som antalet uppdateringar som gjorts i layouterna.

Några filer sparas i varje "GUID"-mapp. De två filer som är mest intressanta är en "catalog.json" -fil och en "version.txt" -fil. Filen "catalog.json" är det föråldrade katalogmanifestet som du måste skicka till alternativet --clean. Den andra version.txt filen innehåller versionen av det här föråldrade katalogmanifestet. Baserat på versionsnumret kan du bestämma om du vill ta bort föråldrade paket från det här katalogmanifestet. Du kan göra samma sak när du går igenom de andra "GUID"-mapparna. När du har fattat beslutet om de kataloger som du vill rensa kör du kommandot --clean genom att ange filsökvägarna till dessa kataloger.

Här är ett exempel på hur du använder alternativet --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

När du kör det här kommandot analyserar installationsprogrammet nätverkslayoutmappen för att hitta listan över filer som tas bort. Sedan kan du granska de filer som ska tas bort och bekräfta borttagningarna.

Konfigurera layouten så att den alltid innehåller och tillhandahåller det senaste installationsprogrammet

Not

Från och med juni 2023 levereras det senaste installationsprogrammet som standard med varje uppdatering till versioner av Visual Studio 2017, Visual Studio 2019 och Visual Studio 2022 som stöds. Så du behöver inte göra något explicit för att få den senaste versionen av installationsprogrammet med de senaste funktionerna och felkorrigeringarna i layouten och på dina klienter.

Men om du använder en layout som skapades före juni 2023 kan du också uttryckligen konfigurera layouten så att alltid inkludera och tillhandahålla den senaste installationsprogrammet till dina klienter, även om installationsprogrammet anses vara en del av en nyare version av Visual Studio. När klienten uppdateras från den här layouten hämtar klienten därför det senaste installationsprogrammet som ingår och tillhandahålls av den här layouten. Fördelen är att när den senaste installationsprogrammet finns på klienten kan dina klientinstallationer dra nytta av felkorrigeringarna och de nya funktioner som vi fortsätter att lägga till i installationsprogrammet.

Det finns flera sätt att aktivera layouten för att inkludera och tillhandahålla det senaste installationsprogrammet:

• Du kan använda en version av Visual Studio som byggdes på eller efter juni 2023.

• Du kan skicka parametern --useLatestInstaller till bootstrappern när du skapar eller uppdaterar layouten. Detta gör att en inställning anges i layout.json-filen, som finns i layoutens rotkatalog. Här är ett exempel på hur du uppdaterar layouten och konfigurerar den så att den använder det senaste och bästa installationsprogrammet som är tillgängligt.

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

• Du kan redigera layout.json filen direkt för att lägga till den här inställningen.

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

Det går inte att programmatiskt ta bort den här inställningen i layout.json-filen, så om du vill att layouten ska stoppa med hjälp av det senaste installationsprogrammet som Microsoft gör tillgängligt, och i stället använda den version av installationsprogrammet som motsvarar bootstrappern (som troligen är äldre än det senaste installationsprogrammet), redigerar du filen layout.json och tar bort inställningen "UseLatestInstaller": true.

Observera att du kanske hittar den här "UseLatestInstaller": true inställningen i layoutens response.json-fil också, men den ignoreras där för att säkerställa att layouten alltid har det senaste installationsprogrammet. Den response.json filen används för att ange standardkonfigurationsalternativ för -klienten när klienten installerar eller uppdaterar från en layout. Den här inställningen "useLatestInstaller": true i layout.json-filen används för att säkerställa att innehållet i layout innehåller den senaste installationsprogrammet, så att klientdatorerna sedan kan hämta det senaste installationsprogrammet från layouten.

Felkoder

Om du använde parametern --wait anges %ERRORLEVEL% miljövariabeln till något av följande värden, beroende på resultatet av åtgärden:

Värde	resultat
0	Åtgärden har slutförts
740	Behörighetsförhöjning krävs
1001	Installationsprocessen för Visual Studio körs
1003	Visual Studio används
1602	Åtgärden avbröts
1618	En annan installation som körs
1641	Åtgärden har slutförts och omstarten har initierats
3010	Åtgärden har slutförts, men installationen kräver omstart innan den kan användas
5003	Bootstrapper kunde inte ladda ned installationsprogrammet
5004	Åtgärden avbröts
5005	Bootstrapper fel vid analys av kommandorad
5007	Åtgärden blockerades – datorn uppfyller inte kraven
8001	Fel vid kontroll av armdator
8002	Fel vid förkontroll av bakgrundsnedladdning
8003	Fel som kan väljas av support
8004	Målkatalogfel
8005	Fel vid verifiering av källbelastning
8006	Visual Studio-processer som körs
8010	Operativsystemet stöds inte. Se Systemkrav
-1073720687	Anslutningsfel
-1073741510	Microsoft Visual Studio Installer avslutades (av användaren eller den externa processen)
Annan (till exempel: -1, 1, 1603	Feltillstånd inträffade – kontrollera loggarna för mer information

Få stöd för nätverkslayouten

Om du får problem med nätverkslayouten vill vi veta mer om det. Det bästa sättet att berätta för oss är att använda verktyget Report a Problem som visas både i Visual Studio Installer och i Visual Studio IDE. Om du är IT-administratör och inte har Visual Studio installerat kan du skicka IT-administratörsfeedback här. När du använder det här verktyget skulle det vara till stor hjälp om du kunde skicka loggarna med Visual Studio Collect-verktyget som kan hjälpa oss att diagnostisera och åtgärda problemet.

Vi tillhandahåller också en installationschatt (på engelska) för installationsrelaterade problem.

Vi har även andra supportalternativ. Titta på vår Visual Studio Developer Community.

Relaterat innehåll

• Visual Studio-administratörsguide
• Distribuera Visual Studio från en layout till en klientdator
• Uppdatera en nätverksbaserad installation av Visual Studio
• Felsöka nätverksrelaterade fel när du installerar eller använder Visual Studio
• Konfigurera principer för företagsdistributioner av Visual Studio
• Visual Studio-produktens livscykel och service
• Använd kommandoradsparametrar för att installera Visual Studio
• Visual Studio-arbetsbelastning och komponent-ID
• Installera certifikat som krävs för offlineinstallation av Visual Studio