Delen via

Voorbeelden van opdrachtregelparameters voor de installatie van Visual Studio

  • Artikel

Als u wilt laten zien hoe u opdrachtregelparameters gebruikt om Visual Studiote installeren, ziet u een aantal voorbeelden die u kunt aanpassen aan uw behoeften.

In elk voorbeeld vertegenwoordigen vs_enterprise.exe, vs_professional.exeen vs_community.exe de respectieve editie van de Visual Studio bootstrapper. Dit is het kleine bestand (~ 1MB) waarmee het downloadproces wordt gestart. Als u een andere editie gebruikt, vervangt u de juiste bootstrappernaam.

Alle opdrachten vereisen beheerdersverhoging en er wordt een prompt voor gebruikersaccountbeheer weergegeven als het proces niet wordt gestart vanaf een prompt met verhoogde bevoegdheid.

U kunt het ^ teken aan het einde van een opdrachtregel gebruiken om meerdere regels samen te voegen in één opdracht. U kunt deze lijnen ook op één rij plaatsen. In PowerShell is het equivalent het teken backtick (`).

Als u opdrachten op een niet-interactieve manier wilt uitvoeren, kunt u--passive of --quietgebruiken. Zie de pagina met opdrachten en opdrachtregelparameters voor meer informatie over deze parameters.

Voor lijsten met workloads en onderdelen die u kunt installeren met behulp van de opdrachtprompt, zie de pagina Visual Studio-workload en component-ID's.

Installeren met behulp van --installPath en --add naast de bootstrapper

  • Installeer een minimaal exemplaar van Visual Studio, zonder interactieve prompts, maar de voortgang wordt weergegeven:

    vs_enterprise.exe --installPath C:\minVS ^
--add Microsoft.VisualStudio.Workload.CoreEditor ^
--passive --norestart

  • Installeer een bureaubladexemplaar van Visual Studio stil, met het Franse taalpakket, en keer pas terug wanneer het product is geïnstalleerd.

    vs_enterprise.exe --installPath C:\desktopVS ^
--addProductLang fr-FR ^
--add Microsoft.VisualStudio.Workload.ManagedDesktop ^
--includeRecommended --quiet --wait

Bijwerken

  • Werk een Visual Studio-exemplaar bij via de opdrachtregel met de voortgang die wordt weergegeven en geen interactieve prompts. U kunt deze reeks opdrachten in twee stappen uitvoeren met behulp van een bootstrapper die zich op de clientomgeving of in een lay-out bevindt. Met de eerste opdracht wordt het installatieprogramma op de client bijgewerkt en met de tweede opdracht wordt het Visual Studio-product bijgewerkt. U moet deze opdrachten uitvoeren in een opdrachtprompt met verhoogde bevoegdheid, omdat het bijwerken van het installatieprogramma beheerdersmachtigingen vereist. In het volgende voorbeeld wordt het bijwerken van een client gesimuleerd met behulp van een groenblijvende bootstrapper in de indeling.

    \\layoutserver\share\path\vs_enterprise.exe --update --quiet --wait
\\layoutserver\share\path\vs_enterprise.exe update --wait --passive --norestart --installPath "C:\installPathVS"

U kunt uw Visual Studio-exemplaar ook in één stap bijwerken met behulp van het installatieprogramma op de client. Standaardgebruikers, als ze de juiste machtigingen hebben, kunnen de updateopdracht programmatisch uitvoeren met behulp van het installatieprogramma, maar ze mogen de --passive of --quiet switch niet gebruiken. Houd er rekening mee dat u het installatieprogramma niet programmatisch kunt initiëren vanuit dezelfde map waarin het installatieprogramma zich bevindt.

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" update --passive --norestart --installPath "C:\installPathVS"

--wait gebruiken

  • Gebruik --wait in batchbestanden of scripts om te wachten tot de eerste opdracht is voltooid voordat de volgende opdracht wordt uitgevoerd. Voor batchbestanden bevat een omgevingsvariabele %ERRORLEVEL% de retourwaarde van de opdracht, zoals beschreven in de Opdrachtregelparameters gebruiken om Visual Studio pagina te installeren. Sommige opdrachtprogramma's vereisen andere parameters om te wachten op voltooiing en om de retourwaarde van het installatieprogramma op te halen.

De parameter --wait wordt alleen ondersteund door de bootstrapper.

start /wait vs_professional.exe --installPath "C:\VS" --passive --wait > nul
echo %errorlevel%

De volgende opdracht is een voorbeeld van het gebruik van --wait met de PowerShell-scriptopdracht Start-Process:

$process = Start-Process -FilePath vs_enterprise.exe -ArgumentList "--installPath", "C:\VS", "--passive", "--wait" -Wait -PassThru
Write-Output $process.ExitCode

of

 $startInfo = New-Object System.Diagnostics.ProcessStartInfo
 $startInfo.FileName = "vs_enterprise.exe"
 $startInfo.Arguments = "--all --quiet --wait"
 $process = New-Object System.Diagnostics.Process
 $process.StartInfo = $startInfo
 $process.Start()
 $process.WaitForExit()
  • De eerste --wait wordt gebruikt door de Visual Studio bootstrapper en de tweede -Wait wordt gebruikt door 'Start-Process' om te wachten op voltooiing. De parameter -PassThru wordt gebruikt door Start-Process om de afsluitcode van het installatieprogramma te gebruiken voor de retourwaarde.

--layout gebruiken om een netwerkindeling of een lokale cache te maken

  • Maak een indeling die alleen de Visual Studio-kerneditor (de meest minimale Visual Studio-configuratie) en het Engelse taalpakket bevat. Meer voorbeelden van het maken van indelingen vindt u op de pagina Een netwerkinstallatie van Visual Studio maken.

    vs_professional.exe --layout "C:\VS" ^
--lang en-US ^
--add Microsoft.VisualStudio.Workload.CoreEditor ^

Gebruik --all om het hele product te verkrijgen

  • Start een interactieve installatie van alle workloads en onderdelen die beschikbaar zijn in de Visual Studio Enterprise-editie:

    vs_enterprise.exe --all

Het gebruik van --includeRecommended

  • Installeer een tweede exemplaar van Visual Studio Professional met behulp van een bijnaam op een computer waarop Visual Studio Community Edition al is geïnstalleerd, met ondersteuning voor Node.js ontwikkeling:

    vs_professional.exe --installPath C:\VSforNode ^
--add Microsoft.VisualStudio.Workload.Node --includeRecommended --nickname VSforNode

--channelURI gebruiken

Met behulp van het meest recente installatieprogrammakunt u configureren waar Visual Studio zoekt naar updates. De --channelUri wordt ook wel het updatekanaal of de bronlocatie van updates genoemd. De volgende tabel bevat voorbeeldwaarden voor channelId en channelUri en wat ze betekenen.

kanaalnaam --channelUri- --channelId
Visual Studio 2022 Huidig kanaal https://aka.ms/vs/17/release/channel VisualStudio.17.Release
Visual Studio 2022 17.0 LTSC-kanaal https://aka.ms/vs/17/release.LTSC.17.0/channel VisualStudio.17.Release.LTSC.17.0
Visual Studio 2022 Preview-kanaal https://aka.ms/vs/17/pre/channel VisualStudio.17.Preview
Visual Studio 2019 Release-kanaal https://aka.ms/vs/16/release/channel VisualStudio.16.Release
Visual Studio 2017 Release-kanaal https://aka.ms/vs/15/release/channel VisualStudio.15.Release
Aangepaste indeling - Privékanaal \\layoutserver\share\path\channelmanifest.json VisualStudio.17.Release (of wat de indeling ook op gebaseerd was)

Als u ervoor kiest om een aangepaste indeling als updatekanaal te gebruiken, moet u rekening houden met de volgende richtlijnen:

--remove gebruiken

  • Verwijder het onderdeel Profileringshulpprogramma's uit het standaard geïnstalleerde Visual Studio-exemplaar. In dit voorbeeld wordt het installatieprogramma gebruikt dat al op de clientcomputer is geïnstalleerd. Standaardgebruikers met de juiste machtigingen de opdracht wijzigen programmatisch kunnen uitvoeren met behulp van het installatieprogramma, maar ze mogen de --passive of --quiet switch niet gebruiken. Houd er rekening mee dat u het installatieprogramma niet programmatisch kunt initiëren vanuit dezelfde map waarin het installatieprogramma zich bevindt.

    "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify ^
--installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
--remove Microsoft.VisualStudio.Component.DiagnosticTools ^
--passive

U kunt --remove niet gebruiken in dezelfde opdracht als --layout. Met andere woorden, het is niet mogelijk om onderdelen uit een indeling te verwijderen.

Het gebruiken van --removeOos

Met het meest recente installatieprogrammakunt u een installatie wijzigen en alle onderdelen verwijderen die zijn overgezet naar een niet-ondersteunde status van het standaard geïnstalleerde Visual Studio-exemplaar. In dit voorbeeld wordt het installatieprogramma gebruikt dat al op de clientcomputer is geïnstalleerd om de removeOos-instelling te configureren. Standaardgebruikers kunnen, als ze de juiste machtigingen hebben, de opdracht wijzigen programmatisch uitvoeren met behulp van het installatieprogramma, maar ze mogen de --passive of --quiet-switch niet gebruiken. U kunt het installatieprogramma niet programmatisch initiëren vanuit dezelfde map waarin het installatieprogramma zich bevindt.

 "C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^
 --installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise" ^
 --removeOos true ^
 --passive

  • Pas de update-instellingen aan zodat alle onderdelen die zijn overgezet naar een status buiten de ondersteuning, permanent worden verwijderd telkens wanneer de productupdates worden bijgewerkt:

    "C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^
--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

--path gebruiken

In al deze voorbeelden wordt ervan uitgegaan dat u een nieuw product installeert met behulp van een bootstrapper.

  • Gebruik de installatie-, cache- en gedeelde paden:

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache" --path shared="C:\VS\shared"

  • Gebruik alleen de installatie- en cachepaden:

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache"

  • Gebruik alleen de installatie- en gedeelde paden:

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path shared="C:\VS\shared"

  • Gebruik alleen het installatiepad:

    vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS"

Gebruik maken van export

  • Gebruik exporteren om de selectie van een installatie op te slaan. In dit voorbeeld wordt het installatieprogramma gebruikt dat al op de clientcomputer is geïnstalleerd.

    "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" export --installPath "C:\VS" --config "C:\my.vsconfig"

  • Gebruik exporteren om aangepaste selectie helemaal opnieuw op te slaan. In dit voorbeeld wordt het installatieprogramma gebruikt dat al op de clientcomputer is geïnstalleerd.

    "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" export --channelId VisualStudio.17.Release --productId Microsoft.VisualStudio.Product.Enterprise --add Microsoft.VisualStudio.Workload.ManagedDesktop --includeRecommended --config "C:\my.vsconfig"

--config gebruiken

  • Gebruik --config om de workloads en onderdelen te installeren vanuit een eerder opgeslagen installatieconfiguratiebestand:

    vs_enterprise.exe --config "C:\my.vsconfig" --installPath "C:\VS"

  • Gebruik --config om workloads en onderdelen toe te voegen aan een bestaande installatie. In dit voorbeeld wordt het installatieprogramma gebruikt dat al op de clientcomputer is geïnstalleerd. Standaardgebruikers met de juiste machtigingen de opdracht wijzigen programmatisch kunnen uitvoeren met behulp van het installatieprogramma, maar ze mogen de --passive of --quiet switch niet gebruiken. U kunt het installatieprogramma niet programmatisch initiëren vanuit dezelfde map waarin het installatieprogramma zich bevindt.

    "C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\VS" --config "C:\my.vsconfig"

  • Gebruik --config om de inhoud van een indeling te configureren:

    vs_enterprise.exe --layout C:\layout --config "C:\my.vsconfig"

Winget gebruiken

Gebruik het hulpprogramma Windows Package Manager winget om Visual Studio programmatisch te installeren of bij te werken op uw computers, samen met andere pakketten die worden beheerd door winget. Als u de installatie wilt aanpassen en andere workloads en onderdelen wilt opgeven, kunt u de --override switch van winget naast de install-opdracht van winget gebruiken en een geëxporteerd vsconfig-bestand doorgeven als volgt:

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

U kunt ook winget configure gebruiken en een .yaml-bestand doorgeven om een bestaande Visual Studio-installatie te wijzigen. Deze benadering maakt gebruik van de Visual Studio PowerShell DSC-provider die hierwordt beschreven.

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- (alleen 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