Een netwerkinstallatie van Visual Studio maken en onderhouden

📣 We horen graag uw feedback!Neem even de tijd om deze enquête te voltooien en laat ons weten hoe we de indelingservaring kunnen verbeteren. Bedankt voor uw steun!

Soms wil een ondernemingsbeheerder een privé-installatiecache maken (ook wel een 'indeling' genoemd) die Visual Studio-bestanden bevat die kunnen worden geïmplementeerd op clientcomputers binnen een organisatie.

Het maken van een indeling is handig in de volgende situaties:

• Een gebruiker heeft beperkte machtigingen
• De clientcomputers hebben beperkte toegang tot internet
• Een organisatie wil standaardiseren op een bepaalde versie van de ontwikkelhulpprogrammaset

We hebben Visual Studio ontworpen zodat een beheerder zowel een indeling kan maken als onderhouden en opslaan op een interne netwerkshare en deze optioneel beschikbaar kan maken op het intranet van een organisatie. De indeling fungeert als de bronlocatie voor alle Visual Studio-bestanden die nodig zijn voor zowel de eerste clientinstallatie als de volgende updates.

De informatie op deze pagina is gegroepeerd in drie hoofdsecties:

• De indeling maken: beschrijft hoe u de indeling maakt met de juiste productinhoud, de standaardinstellingen configureert, deze opslaat op een netwerkbestandsshare en deze beschikbaar maakt op uw intranet.
• Behoud de indeling: informatie over hoe u de productversie van de indeling het beste kunt bijwerken of de productinhoud, kanaalinstellingen, installatieversie en mapgrootte van de indeling kunt wijzigen.
• Hulp en ondersteuning: waar u om hulp kunt vragen

De indeling maken

De opslaglocatie van de netwerkbestandsshare voorbereiden

Eerst moet u bepalen waar u de gedownloade Visual Studio-pakketten gaat opslaan. Als u meerdere edities van Visual Studio in gebruik hebt binnen uw onderneming (bijvoorbeeld Visual Studio 2022 Professional en Visual Studio 2022 Enterprise), moet u voor elke editie een afzonderlijke indeling maken. Het maken van een afzonderlijke indeling voor elke editie kan veel schijfruimte verbruiken, met name wanneer u denkt dat indelingsupdates ook schijfruimte verbruiken.

Het indelingspad moet uit minder dan 80 tekens bestaan; sommige organisaties gebruiken symbolische koppelingen om de beperking van 80 tekens te omzeilen.

De Visual Studio bootstrapper downloaden om de indeling te maken

Download de juiste bootstrapper voor de versie van Visual Studio die u wilt gebruiken en kopieer deze naar de map die u wilt gebruiken als opslagplaats van de indeling. Zodra de indeling is gemaakt, kunt u deze gebruiken om Visual Studio op elke clientcomputer te installeren. De bootstrapper is het uitvoerbare bestand dat u gebruikt om andere indelingsbewerkingen te maken, bij te werken en uit te voeren. U moet beschikken over een internetverbinding en beheerdersmachtigingen om deze stap te kunnen voltooien.

Met de volgende bootstrappers installeert u altijd de nieuwste veilige versie van Visual Studio 2022 op het Current-kanaal, ongeacht wanneer u ze uitvoert. Als u een indeling wilt maken of bijwerken naar een specifieke versie of een specifiek kanaal van Visual Studio 2022, downloadt u de groenblijvende en vaste versie bootstrapper voor de onderhoudsrelease voor het gewenste kanaal van ReleaseGeschiedenis van Visual Studio 2022. Kopieer deze naar de map die u wilt gebruiken als de bronlocatie van de indeling.

Uitgave	Bootstrapper
Visual Studio 2022 Enterprise	vs_enterprise.exe
Visual Studio 2022 Professional	vs_professional.exe
Visual Studio 2022 Community	vs_community.exe
Buildhulpprogramma's voor Visual Studio 2022	vs_buildtools.exe

Tip

Als u eerder een bootstrapper-bestand hebt gedownload en wilt controleren welke versie het gaat installeren, gaat u als volgt te werk. Open Verkenner in Windows, klik met de rechtermuisknop op het bootstrapper-bestand, kies Eigenschappen en kies vervolgens het tabblad Details. In het veld Productversie worden het kanaal en de versie weergegeven die door de bootstrapper worden geïnstalleerd. Het versienummer moet altijd worden gelezen als 'nieuwste onderhoudsversie van wat is opgegeven', en het kanaal wordt ervan uitgegaan dat het huidig is, tenzij expliciet is opgegeven. Een bootstrapper met een productversie van LTSC 17.0 installeert dus de nieuwste 17.0.x-onderhoudsrelease die beschikbaar is op het 17.0 LTSC-kanaal. Een bootstrapper met een Product-versie genaamd Visual Studio 2022 installeert de nieuwste serviceversie van Visual Studio 2022 via het Current-kanaal.

De Visual Studio-pakketten downloaden

U moet een internetverbinding hebben om deze stap uit te voeren.

Open een opdrachtprompt met verhoogde bevoegdheid, navigeer naar de map waarin u de bootstrapper hebt gedownload en gebruik de parameters van de bootstrapper zoals gedefinieerd in het opdrachtregelparameters gebruiken om Visual Studio-pagina te installeren om uw netwerkindeling te maken en te onderhouden. In de volgende voorbeelden ziet u veelvoorkomende manieren om initiële indelingen te maken. Meer voorbeelden vindt u op de opdrachtregelparametervoorbeelden voor een Visual Studio-installatiepagina.

Voor een volledige eerste indeling voor een landinstelling met één taal is ongeveer 40 GB schijfruimte vereist voor Visual Studio Community en ongeveer 50 GB voor Visual Studio Enterprise. Extra taalregio's vereisen elk ongeveer een halve GB.

De aanbevolen methode is om een eerste indeling van Visual Studio te maken met alle workloads en de juiste talen en de pakketten op te slaan in de indelingsmap op de netwerkserver. Op die manier heeft elke clientinstallatie toegang tot het volledige Visual Studio-productaanbod en de mogelijkheid om een subset te installeren. Als u een volledige indeling van Visual Studio wilt maken, voert u de volgende opdracht uit vanuit de map waarop u de netwerkindeling wilt hosten:

vs_enterprise.exe --layout c:\VSLayout

Zorg ervoor dat uw indeling is gebaseerd op het juiste kanaal

Het is belangrijk ervoor te zorgen dat de netwerkindeling gebaseerd is op het juiste kanaal, omdat dit een van de criteria is die de beheerder , indien in de gehele organisatie geïmplementeerd, gebruikt om te bepalen welke clientexemplaren moeten worden bijgewerkt. Als uw indeling bijvoorbeeld is gebaseerd op het Kanaal VisualStudio.17.Release.LTSC.17.0 en als uw clients zijn geconfigureerd voor het ontvangen van updates van door Microsoft gehoste servers, zijn eventuele beveiligingsupdates die beschikbaar zijn op het 17.0 LTSC-kanaal beschikbaar voor de clients die zijn geïnstalleerd of bijgewerkt vanuit die indeling.

De bootstrappers die eerder werden vermeld, zijn gebaseerd op het Current-kanaal. Als u een indeling wilt maken op basis van een van de LTSC-kanalen, verkrijgt u de bootstrapper van het juiste kanaal van de Visual Studio 2022-releasegeschiedenis pagina, kopieert u deze naar de indelingsmap en gebruikt u deze om de indeling te maken of bij te werken.

De inhoud van een indeling configureren

Er zijn verschillende opties die u kunt gebruiken om de inhoud van uw netwerkindeling aan te passen. U kunt een gedeeltelijke indeling maken die alleen een specifieke set taallokalen van ,, workloads, componenten en hun aanbevolen of optionele afhankelijkhedenbevat. Een gedeeltelijke indeling is handig als u weet dat u slechts een subset van workloads op clientwerkstations gaat implementeren. Typische opdrachtregelparameters voor het aanpassen van de indeling zijn:

• --add om werkbelasting- of onderdeel-ID's op te geven.
  Als --add wordt gebruikt, worden alleen de werkbelastingen en onderdelen die zijn opgegeven met --add gedownload. Als --add niet wordt gebruikt, worden alle workload en onderdelen gedownload.
• --includeRecommended om alle aanbevolen componenten voor de opgegeven workload-id's op te nemen.
• --includeOptional om alle optionele onderdelen voor de opgegeven workload-id's in te sluiten.
• --config om een *.vsconfig-bestand te gebruiken om de werkbelastingen, onderdelen of extensies op te geven die in de indeling moeten worden opgenomen of waar de indeling naar moet verwijzen. Zorg ervoor dat u het volledige pad opgeeft van het configuratiebestand.
• --lang taalinstellingenopgeven.

Hier volgen enkele voorbeelden van het maken van een aangepaste netwerkindeling.

• Als u een indeling wilt maken met vereiste onderdelen voor alle workloads in slechts één taal, voert u het volgende uit:

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

• Als u een indeling wilt maken met vereiste onderdelen voor alle workloads in meerdere talen, voert u het volgende uit:

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

• Als u een indeling wilt maken met één workload en alle vereiste en aanbevolen onderdelen voor die workload in alle talen, voert u het volgende uit:

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

• Als u een indeling met twee workloads en één optioneel onderdeel in drie talen wilt maken, voert u het volgende uit:

  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
  

Een configuratiebestand gebruiken om de inhoud van een indeling te initialiseren

U kunt de parameter --config gebruiken om een *.vsconfig bestand door te geven. Zorg ervoor dat u het volledige pad opgeeft van het configuratiebestand. Wanneer u een *.vsconfig-bestand gebruikt tijdens het maken van de indeling, wordt de inhoud van een netwerkindeling aangepast en beperkt tot wat is opgegeven in het configuratiebestand. Het configuratiebestand wordt gekopieerd naar de indelingsmap en gewijzigd in layout.vsconfig.

Alle -extensies die zijn opgegeven in het *.vsconfig-bestand worden niet rechtstreeks naar de indeling gekopieerd. In plaats daarvan bevat het response.json bestand van de indeling een verwijzing naar het zojuist gemaakte layout.vsconfig-bestand, waarbij de installatielocatie voor de extensies van de client wordt gedefinieerd. Als u extensies installeert die niet digitaal zijn ondertekend, moet u de response.json bewerken om "allowUnsignedExtensions": truetoe te voegen. Zie response.json voorbeelden van inhoud.

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

De indeling naar een netwerkshare kopiëren

U moet de indeling op een netwerkshare hosten, zodat deze toegankelijk is vanaf de clientcomputers. Als u de indeling op een lokale computer hebt gemaakt, moet u deze kopiëren naar een netwerkbestandslocatie. In het volgende voorbeeld wordt xcopygebruikt. U kunt ook robocopygebruiken, indien gewenst. Voorbeeld:

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

Standaardinstellingen voor de eerste clientinstallatie configureren voor deze indeling

Er wordt een bestand met de naam response.json gemaakt in de hoofdmap van de indeling. Dit aanpasbare bestand levert de initiële standaardinstellingen om op de client te configureren, wanneer de client aanvankelijk wordt geïnstalleerd vanuit het lay-outbestand. Algemene configuratieopties omvatten de mogelijkheid om te configureren:

• Welke workloads, onderdelen of talen standaard op de client moeten worden geïnstalleerd
• Als aanbevolen onderdelen ook moeten worden geïnstalleerd
• Als de client een installatie-*.vsconfig-bestand moet respecteren
• Waar moet de client updates ontvangen van
• Of componenten die niet worden ondersteund tijdens een update moeten worden verwijderd.
• Als niet-ondertekende extensies stilletjes op een programmatische manier kunnen worden geladen &

Meer informatie vindt u op de pagina Automate Visual Studio-installatie met een antwoordbestand.

Uw indeling toegankelijk maken via een intranetsite

Vanaf juni 2023 kunt u uw indelingen beschikbaar maken op een interne intranetsite, waarmee u kunt profiteren van de mogelijkheden voor het cachen van webserverbestanden en de prestaties van georeplicatie. Als u deze nieuwe functie wilt gebruiken, moet u de nieuwste Visual Studio bootstrappers en het nieuwste Visual Studio-installatieprogramma gebruiken. IT-beheerders moeten het volgende doen om te profiteren van deze intranetwebhostingmogelijkheid:

1. Maak en onderhoud eerst een netwerkindeling en zorg ervoor dat de bits aanwezig zijn en regelmatig worden bijgewerkt op de netwerkshare. Vergeet ook niet om de channelUri-waarde in de response.json van de indeling te configureren als u wilt dat uw clients hun updates ontvangen van de locatie van de intranetindeling.

2. Vervolgens moet een beheerder een interne website voorbereiden en de bron van de website binden aan de locatie van het netwerkbestand van de indeling. Ze moeten er ook voor zorgen dat de webserver de volgende MIME-typen respecteert:

   bestandsextensie	MIME-type
   .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. Als u deze indeling ten slotte op de client wilt implementeren, een PowerShell-script uitvoeren op de client om de eerste installatie uit te voeren. Nadat Visual Studio succesvol is geïnstalleerd op de client vanuit een webgehoste indeling, kunnen clientupdates voor webgehoste indelingen worden bijgewerkt via standaardmethoden.

Zorg ervoor dat uw indeling het meest recente installatieprogramma gebruikt

Notitie

Vanaf juni 2023 wordt het nieuwste installatieprogramma standaard geleverd met elke update naar alle ondersteunde versies van Visual Studio 2017, Visual Studio 2019 en Visual Studio 2022. Dus als u een van deze productversies gebruikt, hoeft u niets expliciet te doen om de nieuwste versie van het installatieprogramma te verkrijgen met de nieuwste functionaliteit en bugfixes.

Als u een versie van Visual Studio gebruikt die vóór juni 2023 is verzonden, raden we u aan altijd het nieuwste Visual Studio-installatieprogramma in uw indeling te gebruiken en deze naar uw clients te distribueren. Als u bijvoorbeeld het installatieprogramma van Visual Studio 2022 distribueert in uw Visual Studio 2019-indeling, hebben uw Visual Studio 2019-clients op basis van die indeling de mogelijkheid om de bronlocatie voor updates te wijzigen of om eenvoudig out-of-support-onderdelen te verwijderen. Meer details worden beschreven in de volgende sectie.

De mogelijkheid om ervoor te zorgen dat u programmatisch gebruikmaakt van het nieuwste installatieprogramma, is alleen beschikbaar voor Visual Studio 2019 bootstrappers die zijn gebouwd nadat Visual Studio 2022 oorspronkelijk is verzonden. De vs_enterprise.exe in het volgende voorbeeld moet dus een versie zijn die na 10 november 2021 is verzonden.

Als u een indeling wilt maken van het hele product dat gebruikmaakt van het meest recente en beste installatieprogramma, voert u

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

Uw indeling onderhouden

Het is een best practice om uw Visual Studio-indeling periodiek bij te werken naar de nieuwste beveiligde versie van het product. Dit zorgt ervoor dat de indeling zowel als een installatiepunt als een updatebron voor clientinstallaties kan worden gebruikt. In de volgende sectie worden de meest voorkomende of nuttige onderhoudsbewerkingen voor lay-outs beschreven.

Als u een indeling op een netwerkbestandsshare host, kunt u een bijgewerkte indeling downloaden naar een persoonlijke lokale share (bijvoorbeeld c:\VSLayoutUpdate) en vervolgens, nadat alle bijgewerkte inhoud is gedownload, kopiëren naar de netwerkbestandsshare voor indeling (bijvoorbeeld \server\products\VS). Als u dit niet doet, kunnen gebruikers die installatie uitvoeren tijdens het bijwerken van de lay-out mogelijk een mismatch in de inhoud krijgen omdat de lay-out nog niet volledig bijgewerkt is.

De indeling bijwerken naar de meest recente versie van het product

Microsoft publiceert regelmatig bijgewerkte versies van het product om functionaliteit of beveiligingsproblemen op te lossen. We raden u ten zeerste aan om uw indeling bijgewerkt te houden met de nieuwste versie van het product, zodat uw klanten altijd toegang hebben tot de nieuwste veiligste versie van het product. Dit is vooral belangrijk als uw klanten geen internettoegang hebben en alleen kunnen alleen productupdates ontvangen van de indeling. Visual Studio brengt doorgaans beveiligingsupdates uit op de tweede dinsdag van de maand, bekend als 'patch dinsdag', dus een goede strategie is om al uw indelingen op patch dinsdagmiddagen bij te werken.

Wanneer u de initiële indeling maakt, worden de opgegeven opties, zoals welke werkbelastingen en talen in de indeling moeten worden opgenomen, opgeslagen in het configuratiebestand van de indeling layout.json. Wanneer u deze indeling later bijwerkt naar een nieuwere versie van het product, hoeft u niet opnieuw op te geven welke onderdelen van het product u wilt gebruiken in de indeling. Met een indelingsupdate worden de bestaande onderdelen in de indeling bijgewerkt naar de meest recente versie.

Stel dat u deze gedeeltelijke indeling al hebt gemaakt met behulp van , een van de bekende bootstrappers in de bovenstaande tabel.

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

Het bijwerken van deze indeling naar de nieuwste versie van het product dat wordt aangeboden door Microsoft en gehost op Microsoft-servers is eenvoudig. U hoeft alleen de bestaande evergreen bootstrapper in de layout te gebruiken en de opdracht --layout uit te voeren in een prompt met verhoogde bevoegdheid om de nieuwste pakketten in uw layout te downloaden, als volgt:

vs_enterprise.exe --layout c:\VSLayout

U kunt de indeling ook naar een bijgewerkte versie bijwerken zonder toezicht. Met de indelingsbewerking wordt het installatieproces uitgevoerd in een nieuw consolevenster. Het venster is geopend, zodat beheerders het uiteindelijke updateresultaat van de indeling kunnen zien en een overzicht van eventuele fouten die kunnen zijn opgetreden. Als u een bewerking voor het bijwerken van de indeling wilt uitvoeren op een onbeheerde manier (u hebt bijvoorbeeld een script dat regelmatig wordt uitgevoerd om de indeling bij te werken naar de nieuwste versie), gebruikt u de parameter --passive en wordt het venster automatisch gesloten.

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

De indeling bijwerken naar een specifieke versie van het product

Soms wilt u de indeling bijwerken naar een bepaalde versie van het product. U wilt uw indeling bijvoorbeeld aanpassen aan de meest recente beveiligde versie van de servicebasislijn waarop u uw organisatie hebt gestandaardiseerd. U doet dit als volgt:

U kunt naar de Releasegeschiedenis van Visual Studio 2022 pagina gaan en een bepaalde bootstrapper met een vaste versie downloaden, deze naar uw indeling kopiëren en gebruiken om de indeling bij te werken naar de exacte versie die is opgegeven in de bootstrapper. U gebruikt dezelfde syntaxis als hierboven.

U kunt een beheerdersupdate gebruiken om uw indeling bij te werken naar een specifieke versie van het product. Als u de beheerdersupdatewilt ophalen, gaat u naar de Microsoft Update-catalogusen zoekt u naar de update waarnaar u de indeling wilt bijwerken. Download de update.exe naar de computer waarop de indeling wordt gehost, open een opdrachtprompt met verhoogde bevoegdheid op die computer en voer een opdracht als volgt uit:

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

Houd er rekening mee dat een beheerdersupdate het maken van een nieuwe indeling niet start; er wordt alleen een bestaande indeling bijgewerkt. Je moet een bootstrapper gebruiken om de eerste lay-out te maken.

Ervoor zorgen dat uw netwerkindeling is gebaseerd op een ondersteunde versie

Af en toe, wanneer kanalen niet langer worden ondersteund, moet u ervoor zorgen dat de netwerkindeling gebaseerd blijft op een ondersteund kanaal, zodat uw clients nog steeds meldingen van beveiligingsupdates kunnen ontvangen. Als uw indeling is gebaseerd op het VisualStudio.17.Release.LTSC.17.0-kanaal, worden er geen beveiligingsupdates meer uitgebracht zodra het 17.0 LTSC-kanaal in juli 2023 niet meer wordt ondersteund en worden uw indeling en clients niet meer beveiligd. Ondersteuningsdatums voor verschillende Visual Studio 2022-kanalen vindt u hier.

Als u het kanaal wilt wijzigen waarop de indeling is gebaseerd, verkrijgt u de bootstrapper van het gewenste kanaal van de Visual Studio 2022 Release History pagina, kopieert u deze naar de indelingsmap en voert u een normale update uit. Uw clients moeten vervolgens op de juiste wijze op de hoogte worden gesteld van een update, zodat ze ook veilig kunnen blijven.

De inhoud van een indeling wijzigen

Het is mogelijk om een gedeeltelijke indeling te wijzigen en extra workloads, onderdelen of talen toe te voegen. Het is niet mogelijk om onderdelen betrouwbaar uit een indeling te verwijderen.

In het onderstaande voorbeeld voegen we de Azure-workload en een gelokaliseerde taal toe aan de indeling die eerder is gemaakt met alleen de workload Managed Desktop en de Engelse taal. Nadat we de wijziging hebben aangebracht, worden zowel managed desktop- als Azure-workloads en zowel de Engelse als de Duitse resources opgenomen in deze indeling. Naast het toevoegen van onderdelen, zorgt de --layout opdracht er ook voor dat de indeling wordt bijgewerkt naar de versie die is opgegeven door de bootstrapper. Dus als u de groenblijvende bootstrapper gebruikt, heeft de resulterende indeling het nieuwe onderdeel, de nieuwe taal en alle indelingsinhoud wordt bijgewerkt naar de nieuwste versie van het bootstrapper-kanaal.

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

Als u een bestaande gedeeltelijke indeling wilt wijzigen zodat deze een volledige indeling wordt, gebruikt u de optie --all, zoals wordt weergegeven in het volgende voorbeeld. Opnieuw zorgt deze opdracht ervoor dat de indelingsinhoud wordt bijgewerkt naar de versie die is opgegeven door de bootstrapper.

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

U kunt onderdelen toevoegen aan een indeling door een *.vsconfig-bestand door te geven dat de extra onderdelen bevat die u in uw indeling wilt opnemen. Als u dit doet, overschrijft de nieuwe *.vsconfig inhoud de bestaande layout.vsconfig inhoud. Raadpleeg de vorige sectie Een configuratiebestand gebruiken om de inhoud van een indelingte initialiseren voor meer informatie.

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

Ten slotte kunt u het layout.json configuratiebestand rechtstreeks bewerken in de indelingsmap en de sectie 'toevoegen' van dit bestand bijwerken om de extra onderdelen op te nemen die u in uw indeling wilt opnemen. Vervolgens moet u de indeling bijwerken met behulp van --layout zoals eerder beschreven om de meest recente onderdelen te downloaden.

Notitie

De eenvoudigste manier om de nieuw toegevoegde lay-outcomponenten op een clientmachine te installeren, is door de bootstrapper vanuit de lay-out op de clientmachine uit te voeren. De sectie Toevoegen van het response.json-bestand in de indeling bepaalt welke onderdelen standaard zijn geselecteerd in de gebruikersinterface van het installatieprogramma van de client. Als u de indeling hebt gewijzigd met behulp van een van de bovenstaande methoden, kunt u handmatig controleren en mogelijk de sectie 'toevoegen' in het response.json bestand aanpassen, zodat deze beter overeenkomt met de inhoud in de sectie Toevoegen van het zojuist gewijzigde layout.json-bestand.

Configureer de indeling om niet-ondersteunde onderdelen op de clientcomputer te verwijderen.

Sommige ondernemingen willen profiteren van de functie die is geïntroduceerd in Visual Studio 2022 versie 17.4 waarmee onderdelen worden verwijderd die zijn overgezet naar een status buiten ondersteuning. Dit is relatief eenvoudig in te stellen als u een indeling beheert en als uw clients beheerdersupdates ontvangen. Eerst moet u uw indeling configureren om de nieuwste versie van het installatieprogramma te hebben, zoals hieronder wordt beschreven. Ten tweede moet u de regel "removeOos": true toevoegen aan het response.json-bestand. Als voor uw indeling deze twee details juist zijn ingesteld, respecteren volgende updates van beheerders deze instelling en worden onderdelen die niet meer worden ondersteund van de clientcomputers verwijderd.

Een indeling controleren

Gebruik --verify om verificatie uit te voeren op de netwerkindeling die controleert of de pakkettenbestanden ontbreken of ongeldig zijn. Aan het einde van de verificatie wordt de lijst met ontbrekende en ongeldige bestanden afgedrukt.

Verificatie werkt alleen voor de nieuwste versie van een specifieke secundaire versie van Visual Studio. Zodra er een nieuwe versie wordt uitgebracht, werkt verificatie niet voor indelingen die eerdere versies bevatten.

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

Notitie

Enkele belangrijke metagegevensbestanden die nodig zijn voor de --verify optie moeten zich in de indelingsmap bevinden. Als deze metagegevensbestanden ontbreken, kan '--verify' niet worden uitgevoerd en krijgt u een foutmelding in Setup. Als deze fout optreedt, probeert u de indeling opnieuw bij te werken of maakt u een nieuwe netwerkindeling in een andere map.

Houd er rekening mee dat Microsoft regelmatig updates naar Visual Studio verzendt, dus als u een groenblijvende bootstrapper gebruikt, bevat een recentere indeling mogelijk niet dezelfde versie als de oorspronkelijke indeling. Als u echter een vaste koppeling bootstrappergebruikt, krijgt u (bijna) altijd een deterministische set bestanden.

Een indeling herstellen

Gebruik --fix om dezelfde verificatie uit te voeren als --verify en probeer ook de geïdentificeerde problemen op te lossen. Het --fix proces heeft een internetverbinding nodig, dus zorg ervoor dat uw computer is verbonden met internet voordat u --fixaanroept.

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

Oudere versies uit een indeling verwijderen

Nadat u indelingsupdates voor een netwerkcache hebt uitgevoerd, bevat de indelingsmap mogelijk enkele verouderde pakketten die niet meer nodig zijn voor de nieuwste Installatie van Visual Studio. U kunt de optie --clean gebruiken om verouderde pakketten uit de map met netwerkindelingen te verwijderen.

Hiervoor hebt u het bestandspad(en) nodig om manifesten te catalogiseren die deze verouderde pakketten bevatten. U vindt de catalogusmanifesten in een map Archief in de cache voor netwerkindeling. Ze worden daar opgeslagen wanneer u een indeling bijwerkt. In de map Archief bevinden zich een of meer mappen met de naam GUID, die elk een verouderd catalogusmanifest bevatten. Het aantal GUID-mappen moet hetzelfde zijn als het aantal updates dat is aangebracht in uw indelingen.

Er worden enkele bestanden opgeslagen in elke GUID-map. De twee bestanden die het meest van belang zijn, zijn een "catalog.json" bestand en een "version.txt" bestand. Het bestandcatalog.jsonis het verouderde catalogusmanifest dat u moet doorgeven aan de optie --clean. Het andere version.txt bestand bevat de versie van dit verouderde catalogusmanifest. Op basis van het versienummer kunt u beslissen of u verouderde pakketten uit dit catalogusmanifest wilt verwijderen. U kunt hetzelfde doen als u door de andere GUID-mappen gaat. Nadat u de beslissing hebt genomen over de catalogus(s) die u wilt opschonen, voert u de opdracht --clean uit door de bestandspaden naar deze catalogi op te geven.

Hier volgt een voorbeeld van het gebruik van de optie --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

Wanneer u deze opdracht uitvoert, analyseert Setup uw map met netwerkindelingen om de lijst met bestanden te vinden die worden verwijderd. Vervolgens kunt u de bestanden bekijken die worden verwijderd en de verwijderingen bevestigen.

De indeling zo configureren dat deze altijd het meest recente installatieprogramma bevat en levert

Notitie

Vanaf juni 2023 wordt het nieuwste installatieprogramma standaard geleverd met elke update naar ondersteunde versies van Visual Studio 2017, Visual Studio 2019 en Visual Studio 2022. U hoeft dus niets expliciet te doen om de nieuwste versie van het installatieprogramma te verkrijgen met de nieuwste functionaliteit en bugfixes in uw indeling en op uw clients.

Als u echter een indeling gebruikt die vóór juni 2023 is gemaakt, kunt u uw indeling ook expliciet configureren voor altijd opnemen en het meest recente installatieprogramma aan uw clients verstrekken, zelfs als het installatieprogramma als onderdeel van een recentere versie van Visual Studio wordt beschouwd. Wanneer uw client wordt bijgewerkt op basis van deze indeling, krijgt de client dus het nieuwste installatieprogramma dat is opgenomen en geleverd door deze indeling. Het voordeel is dat zodra het meest recente installatieprogramma op uw client staat, uw clientinstallaties kunnen profiteren van de bugfixes en nieuwe functionaliteit die we blijven toevoegen aan het installatieprogramma.

Er zijn verschillende manieren om uw indeling aan te passen voor het opnemen en aanbieden van het nieuwste installatieprogramma.

• U kunt een versie van Visual Studio gebruiken die is gebouwd op of na juni 2023.

• U kunt de parameter --useLatestInstaller doorgeven aan de bootstrapper wanneer u de indeling maakt of bijwerkt. Dit zorgt ervoor dat een instelling wordt ingesteld in het layout.json-bestand, dat te vinden is in de hoofdmap van de indeling. Hier volgt een voorbeeld van het bijwerken van de indeling en het configureren van de indeling voor het gebruik van het nieuwste en beste installatieprogramma dat beschikbaar is.

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

• U kunt het layout.json bestand rechtstreeks bewerken om deze instelling toe te voegen.

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

U kunt deze instelling niet programmatisch verwijderen in het layout.json bestand. Als u wilt dat de indeling stoppen met het meest recente installatieprogramma dat Microsoft beschikbaar maakt, en in plaats daarvan de versie van het installatieprogramma gebruikt die overeenkomt met de bootstrapper (die meestal ouder is dan het meest recente installatieprogramma), bewerkt u het layout.json bestand en verwijdert u de "UseLatestInstaller": true-instelling.

Houd er rekening mee dat u deze "UseLatestInstaller": true instelling ook in het response.json-bestand van de indeling kunt vinden, maar deze wordt daar genegeerd om ervoor te zorgen dat de indeling altijd het meest recente installatieprogramma heeft. Het response.json-bestand wordt gebruikt om standaardconfiguratieopties in te stellen op de -client wanneer de client wordt geïnstalleerd of bijgewerkt vanuit een indeling. Deze specifieke "useLatestInstaller": true instelling in het layout.json-bestand wordt gebruikt om ervoor te zorgen dat de inhoud van de indeling van de het meest recente installatieprogramma bevat, zodat de clientcomputers vervolgens het meest recente installatieprogramma uit de indeling kunnen verkrijgen.

Foutcodes

Als u de parameter --wait hebt gebruikt, wordt de omgevingsvariabele %ERRORLEVEL% ingesteld op een van de volgende waarden, afhankelijk van het resultaat van de bewerking:

waarde	Resultaat
0	De bewerking is voltooid
740	Vereiste verhoging
1001	Het installatieproces van Visual Studio wordt uitgevoerd
1003	Visual Studio wordt gebruikt
1602	Bewerking is geannuleerd
1618	Een andere installatie die wordt uitgevoerd
1641	De bewerking is voltooid en opnieuw opstarten is gestart
3010	De bewerking is voltooid, maar de installatie vereist opnieuw opstarten voordat deze kan worden gebruikt
5003	Bootstrapper kan het installatieprogramma niet downloaden
5004	Bewerking is geannuleerd
5005	Fout bij het parsen van de Bootstrapper-opdrachtregel
5007	Bewerking is geblokkeerd - de computer voldoet niet aan de vereisten
8001	Fout bij arm-machinecontrole
8002	Fout bij het vooraf controleren van het downloaden op de achtergrond
8003	Selecteerbare fout bij gebrek aan ondersteuning
8004	Fout in doelmap
8005	Fout bij het verifiëren van bronpayloads
8006	Visual Studio-processen die worden uitgevoerd
8010	Besturingssysteem wordt niet ondersteund. Raadpleeg de systeemvereisten
-1073720687	Connectiviteitsfout
-1073741510	Microsoft Visual Studio Installer is beëindigd (door de gebruiker of het externe proces)
Ander (bijvoorbeeld: -1, 1, 1603)	Er is een fout opgetreden: controleer de logboeken voor meer informatie

Ondersteuning krijgen voor uw netwerkindeling

Als u een probleem ondervindt met uw netwerkindeling, willen we dit weten. De beste manier om ons te vertellen is met behulp van het hulpprogramma Een probleem melden dat zowel in het installatieprogramma van Visual Studio als in de Visual Studio IDE wordt weergegeven. Als u een IT-beheerder bent en Visual Studio niet geïnstalleerd heeft, kunt u hier feedback voor IT-beheerders indienen:. Wanneer u dit hulpprogramma gebruikt, zou het erg handig zijn als u de logboeken kunt verzenden door het hulpprogramma Visual Studio Collect waarmee we het probleem kunnen vaststellen en oplossen.

We bieden ook een installatiechat- (alleen Engels) ondersteuningsoptie voor installatieproblemen.

Er zijn ook andere ondersteuningsopties beschikbaar. Bekijk onze Visual Studio Developer Community.

Verwante inhoud

• Beheerdershandleiding voor Visual Studio
• Visual Studio vanuit een indeling implementeren op een clientcomputer
• een netwerkinstallatie van Visual Studio- bijwerken
• Netwerkgerelateerde fouten oplossen bij het installeren of gebruiken van Visual Studio
• Beleidsregels configureren voor bedrijfsimplementaties van Visual Studio
• levenscyclus en onderhoud van Visual Studio-producten
• Opdrachtregelparameters gebruiken om Visual Studio te installeren
• Visual Studio-workload- en onderdeel-id's
• Certificaten installeren die vereist zijn voor offline-installatie van Visual Studio