Opdrachtregelparameters gebruiken om Visual Studio te installeren, bij te werken en te beheren

Wanneer u Visual Studio programmatisch of vanaf een opdrachtprompt installeert, kunt u verschillende opdrachtregelparameters gebruiken om de installatie te beheren of aan te passen om de volgende acties uit te voeren:

• Start de installatie op de client met bepaalde opties en gedrag vooraf geselecteerd.
• Automatiseer het installatie- of updateproces.
• Maak of onderhoud een netwerkindeling van de productbestanden voor het installeren of bijwerken van clientcomputers.

De volgende opdrachtregelopdrachten en -parameters kunnen worden gebruikt met de volgende uitvoerbare bestanden of programma's:

• De setup bootstrapper, het kleine (~1 MB)-bestand (bijvoorbeeld vs_enterprise.exe) waarmee het downloadproces en de eerste installatie worden gestart.
• Het Visual Studio-installatieprogramma dat mogelijk al op de computer is geïnstalleerd en zich in de map C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exebevindt. U moet het installatieprogramma programmatisch starten vanuit een andere map waarin het installatieprogramma zich bevindt. Het installatieprogramma wordt doorgaans gebruikt voor het bijwerken of wijzigen van opdrachten.
• Met een winget-opdracht met behulp van winget's --override switch.
• Met een updatepakket voor beheerders, dat beschikbaar is om te downloaden vanuit de Microsoft Update Catalog, kunt u de netwerkindeling programmatisch bijwerken. Meer informatie vindt u in het artikel Bijwerken of uw indeling wijzigen artikel.

Niet alle opdrachten of parameters werken in elk van deze situaties en eventuele speciale opmerkingen of uitzonderingen worden gedocumenteerd. Bovendien hebt u in sommige scenario's mogelijk geen toegang tot al deze uitvoerbare bestanden die eerder zijn beschreven. Clientcomputers hebben bijvoorbeeld mogelijk alleen het installatieprogramma beschikbaar voor programmatische uitvoering als Visual Studio is geïnstalleerd via een indeling.

Als u de nieuwste bootstrappers voor Visual Studio 2022 wilt downloaden die altijd de nieuwste versie van het Current-kanaal installeren, downloadt u een van de bestanden in de volgende tabel. Als u een specifieke versie of een specifiek kanaal van Visual Studio 2022 wilt installeren, raadpleegt u de pagina Releasegeschiedenis van Visual Studio 2022. Deze pagina bevat koppelingen naar de bootstrappers met vastgestelde versies voor elke onderhoudsrelease.

Editie	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. Het veld Productversie beschrijft het kanaal en de versie die de bootstrapper installeert. Het versienummer moet altijd worden gelezen als 'nieuwste onderhoudsversie van wat is opgegeven', en het kanaal is Current, tenzij expliciet 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 productversie die simpelweg Visual Studio 2022 zegt, installeert de nieuwste versie van Visual Studio 2022 op het huidige kanaal.

Opdrachten en opdrachtregelparameters installeren, bijwerken, wijzigen, herstellen, verwijderen en exporteren

Wanneer u de Visual Studio bootstrapper of het installatieprogramma programmatisch aanroept om het product te installeren of om een indeling te onderhouden:

• De eerste parameter is de opdracht (het werkwoord) die de bewerking beschrijft die moet worden uitgevoerd.
• De volgende optionele opdrachtregelparameters, allemaal voorafgegaan door twee streepjes (--), definiëren verder hoe die bewerking moet plaatsvinden.

Alle opdrachtregelparameters van Visual Studio zijn niet hoofdlettergevoelig en meer voorbeelden vindt u op de voorbeelden van opdrachtregelparameters pagina.

Voorbeeld van syntaxis: vs_enterprise.exe [command] <optional parameters>...

opdracht	Beschrijving
(leeg)	De standaardopdracht installeert het product en wordt gebruikt voor alle onderhoudsbewerkingen voor indelingen.
modify	Hiermee wijzigt u een geïnstalleerd product.
update	Hiermee werkt u een geïnstalleerd product bij.
updateall	Hiermee worden alle geïnstalleerde producten in opeenvolgende volgorde bijgewerkt. Werkt met --quiet en --passive parameters.
repair	Herstelt een geïnstalleerd product.
uninstall	Hiermee verwijdert u een geïnstalleerd product.
export	Hiermee exporteert u de installatieconfiguratie naar een *.vsconfig-bestand.

Belangrijk

Wanneer u meerdere afzonderlijke werkbelastingen of onderdelen of talen opgeeft, moet u de --add of --remove opdrachtregelswitch voor elk item herhalen.

Parameters	Beschrijving
--installPath <dir>	Voor de standaardinstallatieopdracht is deze parameter Optionele en wordt beschreven waar het exemplaar op de clientcomputer is geïnstalleerd. Voor andere opdrachten, zoals bijwerken of wijzigen, is deze parameter verplicht en geeft deze de installatiedirectory aan voor de instantie waarop moet worden ingewerkt.
--productId <id>	Optionele: de ID van het productexemplaar dat wordt gewijzigd en gebruikt met --channelId. De productID is iets als 'Microsoft.VisualStudio.Product.Enterprise'.
--channelUri	Optionele: tijdens een updateopdracht kunt u een nieuwe --channelUri doorgeven om de locatie van de update-instellingen te wijzigen. U kunt het beste de --installPath-parameter koppelen, zodat het duidelijk is welk exemplaar van Visual Studio u configureert. Zie syntaxisvoorbeelden van --channelUri
--channelId <id>	De id van het kanaal, bijvoorbeeld VisualStudio.17.Release. Zie syntaxisvoorbeelden van --channelId. channelId is vereist voor wijzigingsbewerkingen, naast --productID of --installPath.
--add <one or more workload or component IDs>	Optionele: tijdens een installatie- of wijzigingsopdracht geeft deze herhaalbare parameter een of meer workload- of onderdeel-id's op die moeten worden toegevoegd. De vereiste onderdelen van het artefact worden geïnstalleerd, maar niet de aanbevolen of optionele onderdelen. U kunt andere onderdelen globaal beheren met behulp van --includeRecommended en/of --includeOptional parameters. Als u meerdere workloads of onderdelen wilt opnemen, herhaalt u de opdracht --add (bijvoorbeeld --add Workload1 --add Workload2). Voor fijnmazige controle kunt u ;includeRecommended of ;includeOptional toevoegen aan de id (bijvoorbeeld --add Workload1;includeRecommended of --add Workload2;includeRecommended;includeOptional). Raadpleeg de pagina workload- en onderdeel-id's voor meer informatie.
--all	Optionele: tijdens een installatie- of wijzigingsopdracht zorgt deze parameter ervoor dat alle werkbelastingen en onderdelen voor het product worden geïnstalleerd.
--allWorkloads	Optionele: tijdens een installatie- of wijzigingsopdracht installeert deze parameter alle workloads en onderdelen, maar geen aanbevolen of optionele onderdelen.
--includeRecommended	Optionele: tijdens een installatie- of wijzigingsopdracht bevat deze parameter de aanbevolen onderdelen voor alle geïnstalleerde werkbelastingen. Het bevat niet de optionele onderdelen. De werkbelastingen worden opgegeven met --allWorkloads of --add. Houd er rekening mee dat u met behulp van de parameter --includeRecommended het dialoogvenster Instellingen bijwerken inschakelt om aanbevolen onderdelen toe te voegen voor geïnstalleerde werkbelastingen bij de update. Zie Update-instellingen aanpassen om deze instelling te wijzigen.
--includeOptional	Optionele: tijdens een installatie- of wijzigingsopdracht bevat deze parameter de optionele onderdelen voor alle geïnstalleerde workloads. Het bevat niet de aanbevolen onderdelen. De werkbelastingen worden opgegeven met --allWorkloads of --add.
--addProductLang <language-locale>	Optionele: tijdens een installatie- of wijzigingsopdracht geeft deze herhaalbare parameter de taalpakketten voor de gebruikersinterface op die met het product moeten worden geïnstalleerd. Als deze niet aanwezig is, gebruikt de installatie het taalpakket dat overeenkomt met de landinstelling van de computer. Zie de [lijst met taalinstellingen] voor meer informatie
--remove <one or more workload or component IDs>	Optionele: tijdens een wijzigingsopdracht geeft deze herhaalbare parameter een of meer workload- of onderdeel-id's op die moeten worden verwijderd. Het vormt een aanvulling op en gedraagt zich op dezelfde manier als de parameter --add.
(#list-of-language-locales) sectie op deze pagina.
--removeProductLang <language-locale>	Optionele: tijdens een installatie- of wijzigingsopdracht bepaalt deze herhaalbare parameter de taalpakketten voor de gebruikersinterface die uit het product moeten worden verwijderd. Het vormt een aanvulling op en gedraagt zich op dezelfde manier als de parameter --addProductLang.
--in <path>	Optionele: de URI of het pad naar een antwoordbestand, dat configuratie-instellingen kan bevatten.
--quiet	Optionele: Gebruikt met elke opdracht voorkomt deze parameter dat een gebruikersinterface wordt weergegeven terwijl de opdracht wordt uitgevoerd. Niet beschikbaar voor programmatisch gebruik door standaardgebruikers, ongeacht hoe het AllowStandardUserControl-beleid is ingesteld.
--passive, -p	Optionele: deze parameter zorgt ervoor dat de gebruikersinterface op een niet-interactieve manier wordt weergegeven. Deze parameter is wederzijds exclusief van (en in feite overschrijft) de --quiet parameter. Ook niet beschikbaar om programmatisch te gebruiken door standaardgebruikers, ongeacht hoe het beleid AllowStandardUserControl is ingesteld.
--norestart	Optionele: deze parameter moet worden gekoppeld aan de parameters --passive of --quiet. Tijdens het installeren, bijwerken of wijzigen van een opdracht, zorgt het toevoegen van de parameter --norestart ervoor dat een noodzakelijke herstart wordt uitgesteld.
--force	Optionele: met deze parameter wordt Visual Studio gedwongen te sluiten, zelfs als er een Visual Studio-proces wordt gebruikt. Het afdwingen van Visual Studio om te sluiten kan leiden tot verlies van werk, dus wees voorzichtig.
--installWhileDownloading	Optionele: Tijdens een opdracht voor installeren, bijwerken of wijzigen kan Visual Studio het product tegelijkertijd downloaden en installeren. Dit is de standaardervaring.
--downloadThenInstall	Optionele: Tijdens een installatie-, update- of wijzigingsopdracht dwingt deze parameter Visual Studio om alle bestanden te downloaden voordat u ze installeert. Het is wederzijds exclusief van de parameter --installWhileDownloading.
--nickname <name>	Optionele: tijdens een installatieopdracht definieert deze parameter de bijnaam die moet worden toegewezen aan een geïnstalleerd product. De bijnaam mag niet langer zijn dan 10 tekens.
--productKey	Optionele: tijdens een installatieopdracht definieert deze parameter de productcode die moet worden gebruikt voor een geïnstalleerd product. De productcode bestaat uit 25 alfanumerieke tekens in de notatie xxxxxxxxxxxxxxxxxxxxxxxxx.
--removeOos true	Optionele: Tijdens een opdracht voor installeren, bijwerken of wijzigen, geeft deze parameter, gevolgd door true of false, aan het Installatieprogramma van Visual Studio aan of alle geïnstalleerde onderdelen moeten worden verwijderd die zijn overgezet naar een status buiten de ondersteuning. Dit gedrag is van toepassing op één gebeurtenis. Als u dit gedrag permanent wilt maken, past u deze parameter toe op de opdracht modifySettings, die later wordt beschreven of configureert u het globale beleid van removeOOS. Handig om de machine veilig te houden.
--config <path to *.vsconfig file>	Optionele: tijdens een installatie- of wijzigingsbewerking kunt u een configuratiebestand doorgeven met behulp van de parameter --config om de werkbelastingen, onderdelen of extensies op te geven die moeten worden toegevoegd op basis van een eerder opgeslagen installatieconfiguratiebestand. Deze bewerking is alleen additief; er wordt niets verwijderd dat niet is opgegeven in het bestand. Items die zijn opgegeven in het configuratiebestand die niet van toepassing zijn op het product, worden ook niet toegevoegd. U wordt ten zeerste aangeraden het volledig gekwalificeerde pad naar het configuratiebestand op te geven. Tijdens een exportbewerking bepaalt deze parameter de locatie om het installatieconfiguratiebestand op te slaan.
--allowUnsignedExtensions	Optionele: Tijdens een installatie- of wijzigingsbewerking die in een --passive of --quiet-context wordt uitgevoerd met behulp van een --config-bestand, is deze parameter noodzakelijk om extensies zonder digitale handtekening te laden wanneer ze in het configuratiebestand zijn gespecificeerd.
--installerOnly	Optionele: tijdens een installatie- of updatebewerking geeft deze parameter aan dat het Installatieprogramma van Visual Studio alleen zelf (het installatieprogramma) en niet het Visual Studio-product moet installeren. De functionaliteit is gelijk aan de parameter --update, maar intuïtiever. Bedoeld om te worden gebruikt bij het voorbereiden en vooraf configureren van clientcomputers.
--help, --?, -h, -?	Geeft een offlineversie van deze pagina weer.

Indelingsopdracht en opdrachtregelparameters

Alle indelingsbeheerbewerkingen, zoals het maken of bijwerken van een indeling, worden uitgevoerd met behulp van de bootstrapper exe en gaan ervan uit dat de opdracht de standaardinstallatie is (leeg). Alle indelingsbeheerbewerkingen moeten beginnen met de vereiste --layout initiële parameter. In de volgende tabel worden de overige parameters beschreven die u kunt gebruiken om een indeling te maken of bij te werken via de opdrachtregel.

indelingsparameters	Beschrijving
--layout <dir>	Hiermee specificeert u een map om een offline-installatiecache te maken of bij te werken. Zie Een netwerkinstallatie maken van Visual Studiovoor meer informatie.
--lang <one or more language-locales>	Optioneel: wordt gebruikt met --layout om een offline-installatiecache met resourcepakketten in een of meer opgegeven talen voor te bereiden. Zie de sectie Lijst met taalinstellingen op deze pagina voor meer informatie.
--add <one or more workload or component IDs>	Optionele: een of meer workload- of onderdeel-id's die moeten worden toegevoegd. De vereiste onderdelen van het artefact worden geïnstalleerd, maar niet de aanbevolen of optionele onderdelen. U kunt meer onderdelen globaal beheren met behulp van --includeRecommended en/of --includeOptional. Voor fijnmazige controle kunt u ;includeRecommended of ;includeOptional toevoegen aan de id (bijvoorbeeld --add Workload1;includeRecommended of --add Workload2;includeOptional). Raadpleeg de pagina workload- en onderdeel-id's voor meer informatie. Opmerking: als --add wordt gebruikt, worden alleen de opgegeven werkbelastingen en onderdelen en de bijbehorende afhankelijkheden gedownload. Als --add niet is opgegeven, worden alle workloads en onderdelen gedownload naar de layout.
--includeRecommended	Optionele: bevat de aanbevolen onderdelen voor alle geïnstalleerde workloads, maar niet voor de optionele onderdelen. De werkbelastingen worden opgegeven met --allWorkloads of --add.
--includeOptional	Optionele: bevat de aanbevolen en optionele onderdelen voor alle workloads die in de indeling worden opgenomen. De werkbelastingen worden opgegeven met --add.
--wait	Optionele: het proces wacht totdat de installatie is voltooid voordat een afsluitcode wordt geretourneerd. wait is handig bij het automatiseren van installaties waarbij moet worden gewacht tot de installatie is voltooid om de retourcode van die installatie af te handelen. De parameter --wait kan alleen worden doorgegeven aan de bootstrapper; het installatieprogramma (setup.exe) ondersteunt deze niet. Het is handig bij het bijwerken van indelingen. Meer voorbeelden vindt u hier .
--useLatestInstaller	Optionele: verouderde functionaliteit die alleen van toepassing is op Visual Studio bootstrappers ouder dan april 2023. Alles dat na april 2023 wordt verzonden, maakt standaard gebruik van het nieuwste installatieprogramma. Als deze parameter aanwezig is, wordt de nieuwste versie van het Visual Studio-installatieprogramma opgenomen in uw indeling, zelfs als deze deel uitmaakt van een nieuwere primaire versie van het product. Het nieuwste installatieprogramma kan handig zijn als u wilt profiteren van nieuwe functies of oplossingen voor fouten die beschikbaar zijn in de nieuwste versie. Raadpleeg De indeling configureren om altijd de meest recente documentatie voor het installatieprogramma te gebruiken voor meer informatie.
--config <path to *.vsconfig file>	Optionele: Indien aanwezig, maakt Visual Studio gebruik van de inhoud van het configuratiebestand om je lay-out te configureren. Zorg ervoor dat u het volledig gekwalificeerde pad naar het configuratiebestand opgeeft.
--noWeb	Optionele: indien aanwezig, gebruikt Visual Studio setup de bestanden in uw indelingsmap om Visual Studio te installeren en worden er geen pakketten van internet gedownload. Als een gebruiker onderdelen probeert te installeren die niet in de indeling zijn opgenomen, mislukt de installatie. Gebruik deze parameter niet als u een indeling wilt implementeren die wordt gehost op een interne intranetwebsite. Zie Installeren op een client die geen internettoegang heeftvoor meer informatie. Belangrijk: de parameter --noWeb stopt het installatieprogramma van Visual Studio op een clientcomputer met internetverbinding niet om te controleren op updates als de client is geconfigureerd om te kijken naar door Microsoft gehoste servers voor updates. In dit geval voorkomt --noWeb dat de client de productpakketten downloadt.
--verify	Optioneel: controleer de inhoud van een indeling. Beschadigde of ontbrekende bestanden worden vermeld.
--fix	Optioneel: controleer de inhoud van een indeling. Als bestanden beschadigd zijn of ontbreken, worden ze opnieuw gedownload. Internettoegang is vereist om een indeling te herstellen.
--clean <one or more paths to catalogs>	Optionele: hiermee verwijdert u oude versies van onderdelen uit een indeling die wordt bijgewerkt naar een nieuwere versie.

geavanceerde indelingsparameters	Beschrijving
--channelId <id>	Optioneel: De ID van het kanaal voor de instantie die moet worden geïnstalleerd, weergegeven als VisualStudio.17.Release. channelId is vereist voor de installatieopdracht en genegeerd voor andere opdrachten als --installPath is opgegeven. Zie syntaxisvoorbeelden van --channelId.
--channelUri <uri>	Optioneel: de URI van het kanaalmanifest. Deze waarde bepaalt de bronlocatie van updates en de initiële waarde is geconfigureerd in het response.json bestand van de indeling. Raadpleeg syntaxisvoorbeelden van --channelUri- voor mogelijke waarden. Als updates niet nodig zijn, kan --channelUri verwijzen naar een niet-bestaand bestand (bijvoorbeeld --channelUri C:\doesntExist.chman). Deze parameter kan worden gebruikt voor de installatieopdracht; andere opdrachten negeren.
--installChannelUri <uri>	Optionele: de URI van het kanaalmanifest dat moet worden gebruikt voor de installatie. De URI die is opgegeven door --channelUri (die moet worden opgegeven wanneer --installChannelUri is opgegeven) wordt gebruikt om updates te detecteren. Deze parameter kan worden gebruikt voor de installatieopdracht; andere opdrachten negeren.
--installCatalogUri <uri>	Optionele: de URI van het catalogusmanifest dat moet worden gebruikt voor de installatie. Indien opgegeven, probeert de channel manager het catalogusmanifest van deze URI te downloaden voordat de URI in het installatiekanaalmanifest wordt gebruikt. Deze parameter wordt gebruikt ter ondersteuning van offline-installatie, waarbij de lay-outcache wordt gemaakt met de productcatalogus die al is gedownload. Deze parameter kan worden gebruikt voor de installatieopdracht; andere opdrachten negeren.
--productId <id>	Optionele: de id van het product voor het exemplaar dat is geïnstalleerd. Deze parameter wordt vooraf ingevuld in normale installatievoorwaarden. De productID is iets als 'Microsoft.VisualStudio.Product.Enterprise'.
--arch all	Optionele: standaard worden indelingen gemaakt met alleen binaire x64-productbestanden. Gebruik de parameter --arch all of --arch * om BINAIRE ARM-bestanden op te nemen voor toepasselijke workloads naast de binaire x64-bestanden in een indeling. Als u een indeling van alleen binaire ARM-bestanden wilt maken, gebruikt u --arch arm64
--keepLayoutVersion	Optionele: Pas wijzigingen toe op de indeling zonder de productversie bij te werken die in de indeling is opgenomen.
--locale <language-locale>	Optionele: wijzig de weergavetaal van de gebruikersinterface voor het installatieprogramma zelf. De instelling blijft behouden. Zie de sectie Lijst met taalinstellingen op deze pagina voor meer informatie.
--cache	Optionele: Indien aanwezig, worden de pakketten bewaard na installatie voor volgende reparaties. Dit overschrijft de globale beleidsinstelling die moet worden gebruikt voor volgende installaties, reparaties of wijzigingen. Het standaardbeleid is het opslaan van pakketten in de cache. Dit wordt genegeerd voor de uninstallatieopdracht. Lees hoe u de pakketcache kunt uitschakelen of verplaatsen voor meer informatie.
--nocache	Optionele: indien aanwezig, worden pakketten verwijderd nadat ze zijn geïnstalleerd of hersteld. Ze worden alleen opnieuw gedownload als dat nodig is en opnieuw worden verwijderd na gebruik. Dit overschrijft de globale beleidsinstelling die moet worden gebruikt voor volgende installaties, reparaties of wijzigingen. Het standaardbeleid is het opslaan van pakketten in de cache. Dit wordt genegeerd voor de uninstallatieopdracht. Lees hoe u de pakketcache kunt uitschakelen of verplaatsen voor meer informatie.
--noUpdateInstaller	Optionele: Indien aanwezig, voorkomt het dat het installatieprogramma zichzelf bijwerkt wanneer stille modus is opgegeven. Het installatieprogramma zal de opdracht niet uitvoeren en retourneert een niet-nul afsluitcode als noUpdateInstaller is opgegeven met stille modus wanneer een installatieprogramma-update vereist is.
--path <name>=<path>	Optionele: wordt gebruikt om aangepaste installatiepaden voor de installatie op te geven. Ondersteunde padnamen worden gedeeld, in de cache opgeslagen en geïnstalleerd.
--path cache=<path>	Optionele: gebruikt de locatie die u opgeeft om installatiebestanden te downloaden. Deze locatie kan alleen worden ingesteld wanneer Visual Studio voor het eerst wordt geïnstalleerd. Voorbeeld: --path cache="C:\VS\cache"
--path shared=<path>	Optionele: bevat gedeelde bestanden voor Visual Studio-installaties naast elkaar. Sommige hulpprogramma's en SDK's worden geïnstalleerd op een locatie op deze schijf, terwijl andere deze instelling kunnen overschrijven en op een andere schijf installeren. Voorbeeld: --path shared="C:\VS\shared" Belangrijke: dit kan slechts één keer worden ingesteld en op de eerste keer dat Visual Studio is geïnstalleerd.
--path install=<path>	Optionele: gelijk aan –-installPath. In het bijzonder zijn --installPath "C:\VS" en --path install="C:\VS" gelijkwaardig. Slechts één van deze opdrachten kan tegelijk worden gebruikt.

Opdracht- en opdrachtregelparameters ModifySettings

U kunt de update-instellingen wijzigen en de bronlocatie van updates voor een bepaald exemplaar van Visual Studio programmatisch configureren met behulp van het installatieprogramma of de bootstrapper op de clientcomputer en het doorgeven van de opdracht modifySettings en het gewenste updatekanaal.

opdracht	Beschrijving
modifySettings	Werkwoord dat wordt gebruikt om de update-instellingen van een bepaald exemplaar van Visual Studio te wijzigen.

parameters modifySettings wijzigen	Beschrijving
--installPath <dir>	Aanbevolen om te gebruiken om aan te geven op welk exemplaar van Visual Studio moet worden gehandeld.
--newChannelUri	Vereist: de URI van het kanaalmanifest. Deze waarde geeft aan waar de volgende bronlocatie van updates zal zijn. Raadpleeg syntaxisvoorbeelden van --channelUri- voor mogelijke waarden. Als updates niet nodig zijn, kan --channelUri verwijzen naar een niet-bestaand bestand (bijvoorbeeld --channelUri C:\doesntExist.chman).
--channelUri	De URI van het vorige kanaalmanifest. Kan worden gebruikt als het --installPath niet bekend is. Moet worden gebruikt in combinatie met productID om het juiste exemplaar te identificeren waarop moet worden gehandeld.
--productId <id>	Moet worden gebruikt als --channelUri is opgegeven en wordt gebruikt om het juiste exemplaar te identificeren waarop moet worden gehandeld. De productID is iets als 'Microsoft.VisualStudio.Product.Enterprise'.
--includeRecommended	Optionele: Tijdens een modifySettings-opdracht geeft deze parameter (die het woord true of false direct erna moet hebben) aan het Visual Studio-installatieprogramma om de functionaliteit 'aanbevolen componenten voor geïnstalleerde workloads bijwerken' uit te schakelen in het dialoogvenster Update-instelling.
--quiet	Optionele: met deze parameter voorkomt u dat een gebruikersinterface wordt weergegeven terwijl de opdracht wordt uitgevoerd. Niet beschikbaar om programmatisch te gebruiken door standaardgebruikers.
--removeOos true	Optionele: tijdens een opdracht modifySettings geeft deze parameter (die het woord waar of onwaar moet hebben direct erna) aan dat het installatieprogramma van Visual Studio alle geïnstalleerde onderdelen die zijn overgezet naar een status buiten de ondersteuning, permanent verwijderen (of niet verwijderen). Handig om de machine veilig te houden.

Voorbeelden van syntaxis:

C:\>"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modifySettings --installPath "C:\Program Files\Microsoft\Visual Studio\2022\Enterprise" --newChannelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --removeOos true

 C:\>"C:\Program Files\Microsoft\Visual Studio\2022\Enterprise\vs_enterprise.exe" modifySettings --channelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --productID Microsoft.VisualStudio.Product.Enterprise --newChannelUri \\layoutserver\share\path\channelmanifest.json --removeOos true --quiet

Opdracht- en opdrachtregelparameters terugdraaien

Vanaf Visual Studio 2022 kunt u een update programmatisch terugdraaien met behulp van het installatieprogramma op de clientcomputer en de opdracht terugdraaien naast het installatiepadexemplaren doorgeven.

opdracht	Beschrijving
rollback	Opdracht om een bepaald exemplaar van Visual Studio terug te draaien naar de eerder geïnstalleerde update. Deze opdracht werkt niet als de DisableRollback is ingeschakeld.

parameters voor terugdraaien	Beschrijving
--installPath <dir>	Aanbevolen om te gebruiken om aan te geven op welk exemplaar van Visual Studio moet worden gehandeld.

Voorbeelden van syntaxis:

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" rollback -–installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise"

Update-opdracht en opdrachtregelparameters voor administrator

U kunt een Administrator Update- downloaden uit de Microsoft Update-catalogus en deze gebruiken om de clientinstallatie of de indeling bij te werken.

Een indeling bijwerken

Als u een indeling bijwerkt naar een bepaalde versie van Visual Studio, downloadt u de administratorupdate naar de computer waarop de indeling wordt gehost, opent u een opdrachtprompt op die computer en voert u een opdracht als volgt uit:

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

Een client bijwerken

Als u op de client de beheerdersupdate downloadt naar de installatiemap op uw clientcomputer, kunt u gewoon dubbelklikken op het bestand om de update toe te passen. U kunt ook een opdrachtvenster openen en enkele van de onderstaande parameters doorgeven om het standaardgedrag te wijzigen.

De beheerdersupdate configureren in SCCM

Als u de update van de beheerder implementeert via Microsoft Endpoint Manager (SCCM), kunt u het pakket wijzigen om het gedrag aan te passen met behulp van de onderstaande parameters. U kunt de parameters ook beheren via een configuratiebestand op de clientcomputer. Raadpleeg Methoden voor het configureren van een beheerdersupdate- voor meer informatie

Houd er rekening mee dat alle parameters van de Administratorupdate standaard worden uitgevoerd in de context 'update', tenzij het werkwoord 'indeling' is opgegeven.

parameters voor administrator-update	Beschrijving
--installerUpdateArgs [optional parameters]	Deze parameter fungeert als een 'passthrough-matrix' van specifieke parameters die relevant zijn voor updatescenario's voor beheerders. Optionele parameters die voor dit doel zijn ingeschakeld, zijn: --quiet: dit is de standaardervaring voor beheerdersupdates en wordt hier vermeld voor volledigheid. --passive: met deze parameter wordt de parameter --quiet overschreven. Hierdoor wordt de gebruikersinterface op een niet-interactieve manier weergegeven. --norestart: deze parameter moet worden gebruikt in combinatie met --quiet of --passive en zorgt ervoor dat alle benodigde herstarts worden vertraagd. --noWeb: Met deze parameter voorkomt u dat Visual Studio op internet controleert op updates voor het product. --force: met deze parameter wordt Visual Studio gedwongen te sluiten, zelfs als Visual Studio wordt gebruikt. Gebruik deze parameter met voorzichtigheid, omdat dit mogelijk verlies van werk veroorzaakt. Deze parameter mag alleen worden gebruikt wanneer de administrator-update wordt uitgevoerd in de gebruikerscontext; het wordt genegeerd als de administrator-update wordt uitgevoerd in de systeemcontext. --installWhileDownloading: met deze parameter kan Visual Studio het product parallel downloaden en installeren. Dit is de standaardervaring voor beheerdersupdates en wordt hier vermeld voor volledigheid. --keepWindowsUpdateOn: Met deze parameter voorkomt u dat het installatieprogramma de Windows Update-agent op de client uitschakelt. Gebruik deze parameter als u een beheerdersupdate uit de catalogus importeert in SCCM. Mogelijk moet u ook instellen dat de time-out van het SCCM-pakket langer is dan de standaardtijd van 10 minuten. Als u het SCCM-implementatietype wijzigt in Vereist, hoeft u deze parameter niet te gebruiken. --downloadThenInstall: met deze parameter wordt Visual Studio gedwongen om alle bestanden te downloaden voordat u ze installeert. Het is wederzijds exclusief van de parameter --installWhileDownloading.
--checkPendingReboot	De update wordt afgebroken als er een herstart in behandeling is op de computer, ongeacht welke toepassing dit kan hebben veroorzaakt. De standaardinstelling is om niet te controleren op hangende herstarten.

Syntaxisvoorbeeld voor het doorgeven van parameters aan een beheerdersupdate:

visualstudioupdate-16.9.0to16.9.4.exe --installerUpdateArgs=--force,--noWeb,--keepWindowsUpdateOn --checkPendingReboot

Kanaalopdracht en opdrachtregelparameters verwijderen

Kanalen die beschikbaar zijn voor updates, worden op de client in de cache opgeslagen en kunnen na verloop van tijd voor rommel zorgen. U kunt updatekanalen handmatig verwijderen door het installatieprogramma van Visual Studio weer te geven, over te schakelen naar het tabblad Beschikbaar en te klikken op de X in de rechterbovenhoek van de productkaart. U kunt kanalen (bijvoorbeeld oudere indelingslocaties) programmatisch verwijderen met behulp van de opdracht removeChannel. U kunt vswhere programmatisch uitvoeren op de clientcomputer om te bepalen welke kanalen in de cache op de clientcomputer worden opgeslagen.

opdracht	Beschrijving
removeChannel	Opdracht om een kanaal van de clientcomputer te verwijderen.

removeChannel parameters	Beschrijving
--channelUri	Vereist De URI van het oude kanaalmanifest.
--quiet	Optionele Met deze parameter voorkomt u dat een gebruikersinterface wordt weergegeven terwijl de opdracht wordt uitgevoerd.
--passive	Optioneel Met deze parameter wordt de parameter --quiet overschreven. Hierdoor wordt de gebruikersinterface op een niet-interactieve manier weergegeven.

Voorbeeld van syntaxis:

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" removeChannel --channelUri "\\\\server\\share\\layoutdirectory\\ChannelManifest.json"

Winget gebruiken om Visual Studio te installeren of te wijzigen

U kunt het hulpprogramma Windows Package Manager winget gebruiken om Visual Studio programmatisch te installeren, te wijzigen of bij te werken op uw computer, samen met andere pakketten die worden beheerd door winget.

Winget installeert standaard alleen de Visual Studio-kernworkload.

winget install --id Microsoft.VisualStudio.2022.Community

Als u de installatie echter wilt aanpassen en extra werkbelastingen en onderdelen wilt opgeven die tijdens de eerste installatie moeten worden verkregen, kunt u de --override switch van winget naast de opdracht install van winget gebruiken en een geëxporteerd vsconfig-bestand doorgeven dat de werkbelastingen en onderdelen bevat die u wilt toevoegen:

winget install --id Microsoft.VisualStudio.2022.Community --override "--passive --config c:\my.vsconfig"

Natuurlijk kunt u ook rechtstreeks onderdelen opnemen tijdens de eerste installatie, zoals deze:

 winget install --id Microsoft.VisualStudio.2022.Community --override "--quiet --add Microsoft.Visualstudio.Workload.Azure"

Als u Visual Studio al op uw computer hebt geïnstalleerd, kunt u de configure opdracht van winget gebruiken samen met de Visual Studio PowerShell DSC-provider, een yaml-bestand en een .vsconfig-bestand om onderdelen toe te voegen aan een bestaande Visual Studio-installatie. Winget's configure opdracht fungeert in wezen als een Visual Studio 'modify'-bewerking. Zie hoe u een WinGet-configuratiebestand maakt voor meer informatie over het maken van een winget-configuratie.

Het is niet mogelijk om de --override-switch of de Visual Studio DSC-provider naast de upgrade opdracht van winget te gebruiken, omdat upgrade in feite als een updatebewerking van Visual Studio fungeert en de meest recente versie van de onderdelen installeert die u al hebt geselecteerd. U kunt geen onderdelen toevoegen via een update/upgrade. U moet winget's configure gebruiken om onderdelen toe te voegen.

Visual Studio Installer-bewerkingen vereisen momenteel beheerdersbevoegdheden, dus winget vraagt u om uw bevoegdheden zo nodig te verhogen om de opdracht te voltooien. Het is momenteel ook niet mogelijk om winget te gebruiken om meerdere edities (dat wil gezegd, verschillende SKU's) of meerdere exemplaren van dezelfde SKU tegelijkertijd op een clientcomputer te installeren. Ten slotte moet Visual Studio worden gesloten als u deze gaat configureren (wijzigen) om onderdelen toe te voegen of deze bij te werken naar de nieuwste versie.

Lijst met workload-id's en onderdeel-id's

Zie de pagina Visual Studio-workload en component-id's voor een lijst met workload- en onderdeel-id's die zijn gesorteerd op Visual Studio-product.

Lijst van taalgebieden

taal-lokaal	Language
Cs-cz	Tsjechisch
De-de	Duits
En-us	Engels
Es-es	Spaans
Fr-fr	Frans
It-it	Italiaans
Ja-jp	Japans
Ko-kr	Koreaans
Pl-pl	Pools
Pt-br	Portugees - Brazilië
Ru-ru	Russisch
Tr-tr	Turks
Zh-cn	Chinees - Vereenvoudigd
Zh-tw	Chinees - traditioneel

Foutcodes

Afhankelijk van het resultaat van de bewerking is de omgevingsvariabele %ERRORLEVEL% ingesteld op een van de volgende waarden:

waarde	resultaat
0	De bewerking is voltooid
740	Verhoging vereist
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 parseren van de opdrachtregel van de Bootstrapper
5007	Bewerking is geblokkeerd - de computer voldoet niet aan de vereisten
8001	Fout bij controle van arm-machine
8002	Fout bij het vooraf controleren van downloaden op de achtergrond
8003	Selecteerbare fout bij onvoldoende 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

Elke bewerking genereert verschillende logboekbestanden in de %TEMP% map die de voortgang van de installatie aangeven. Sorteer de map op datum en zoek naar bestanden die beginnen met dd_bootstrapper, dd_clienten dd_setup voor de bootstrapper, de installatie-app en de installatie-engine.

Ondersteuning of probleemoplossing

Soms kan het fout gaan. Als de installatie van Visual Studio mislukt, raadpleegt u Problemen met de installatie en upgrade van Visual Studio oplossen voor stapsgewijze instructies.

Hier volgen nog enkele ondersteuningsopties:

• Gebruik de installatiechat (Engelstalig) voor installatieproblemen.
• Meld productproblemen aan ons met behulp van het hulpprogramma Een probleem melden dat wordt weergegeven in het visual studio-installatieprogramma en in de Visual Studio IDE. Als u een IT-beheerder bent en Visual Studio niet hebt geïnstalleerd, kunt u feedback verzenden IT-beheerder.
• Een functie voorstellen, productproblemen bijhouden en antwoorden vinden in de Visual Studio Developer Community.

Verwante inhoud

• opdrachtregelparametervoorbeelden voor Visual Studio-installatie
• Een offline-installatie van Visual Studio maken
• Visual Studio-installatie automatiseren met een antwoordbestand
• Visual Studio-workloads en onderdeel-ID's