Dela via

Exempel på kommandoradsparameter för Visual Studio-installation

  • Artikel

För att illustrera hur du använder kommandoradsparametrar för att installera Visual Studio, finns här flera exempel som du kan anpassa efter dina behov.

I varje exempel representerar vs_enterprise.exe, vs_professional.exeoch vs_community.exe respektive version av Visual Studio-bootstrappern, som är den lilla (~ 1MB) fil som initierar nedladdningsprocessen. Om du använder en annan utgåva ersätter du lämpligt bootstrappernamn.

Alla kommandon kräver administratörsbehörighet, och en uppmaning för användarkontokontroll visas om processen inte startas från en kommandotolk med förhöjda rättigheter.

Du kan använda ^-tecknet i slutet av en kommandorad för att sammanfoga flera rader till ett enda kommando. Du kan också placera dessa rader tillsammans på en enda rad. I PowerShell är motsvarande tecknet backtick (`).

Om du vill köra kommandon på ett icke-interaktivt sätt kan du använda--passive eller --quiet. För mer information om dessa parametrar, se sidan för -kommandon och kommandoradsparametrar.

Listor över de arbetsbelastningar och komponenter som du kan installera med hjälp av kommandoraden finns på sidan Visual Studio-arbetsbelastningar och komponent-ID:n.

Installera med hjälp av --installPath och --add tillsammans med bootstrapper

  • Installera en minimal instans av Visual Studio, utan interaktiva frågor, men förloppet visas:

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

  • Installera en skrivbordsinstans av Visual Studio tyst med det franska språkpaketet och returnera endast när produkten är installerad.

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

Uppdatera

  • Uppdatera en Visual Studio-instans via kommandoraden med att förloppet visas och utan några interaktiva frågor. Du kan köra den här serien med kommandon i två steg med hjälp av en bootstrapper som finns på antingen klienten eller i en layout. Det första kommandot uppdaterar installationsprogrammet på klienten och det andra kommandot uppdaterar Visual Studio-produkten. Du måste köra dessa kommandon i en upphöjd kommandotolk, eftersom uppdatering av installationsprogrammet kräver administratörsbehörighet. I följande exempel simuleras uppdatering av en klient med en evergreen bootstrapper i layouten.

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

Du kan också uppdatera Visual Studio-instansen i ett steg med hjälp av installationsprogrammet på klienten. Standard-användare kan, om de har beviljats lämpliga behörigheter, programmatiskt köra uppdateringskommandot med installationsprogrammet, men de får inte använda växeln --passive eller --quiet. Observera att du inte kan initiera installationsprogrammet programmatiskt från samma katalog som installationsprogrammet finns i.

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

Använda --wait

  • Använd --wait i batchfiler eller skript för att vänta tills det första kommandot har slutförts innan nästa kommando körs. För batchfiler innehåller en %ERRORLEVEL% miljövariabel returvärdet för kommandot, enligt beskrivningen i Använd kommandoradsparametrar för att installera Visual Studio-sidan. Vissa kommandoverktyg kräver att andra parametrar väntar på slutförande och för att hämta installationsprogrammets returvärde.

Parametern --wait stöds endast av bootstrappern.

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

Följande kommando är ett exempel på hur du använder --wait med PowerShell-skriptkommandot Start-Process:

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

eller

 $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()
  • Den första --wait används av Visual Studio-bootstrappern och den andra -Wait används av "Start-Process" för att vänta tills den är klar. Parametern -PassThru används av Start-Process för att använda installationsprogrammets slutkod för dess returvärde.

Använda --layout för att skapa en nätverkslayout eller en lokal cache

  • Skapa en layout som endast innehåller Visual Studio Core-redigeraren (den mest minimala Visual Studio-konfigurationen) och det engelskspråkiga paketet. Fler layoutskapandeexempel finns på sidan Skapa en nätverksinstallation av Visual Studio.

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

Använd --all för att hämta hela produkten

  • Starta en interaktiv installation av alla arbetsbelastningar och komponenter som är tillgängliga i Visual Studio Enterprise-utgåvan:

    vs_enterprise.exe --all

Använda --includeRecommended

  • Installera en andra instans av Visual Studio Professional med ett eget namn på en dator där Visual Studio Community Edition redan är installerat, med stöd för Node.js-utveckling.

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

Använda --channelURI

Med hjälp av senaste installationsprogrammetgår det att konfigurera var Visual Studio söker efter uppdateringar. Den --channelUri kallas även uppdateringskanalen eller uppdateringarnas källa. I följande tabell visas exempelvärden för channelId och channelUri och vad de betyder.

kanalnamn --channelUri --channelId
Visual Studio 2022 Aktuell kanal https://aka.ms/vs/17/release/channel VisualStudio.17.Release
Visual Studio 2022 17.0 LTSC-kanal https://aka.ms/vs/17/release.LTSC.17.0/channel VisualStudio.17.Release.LTSC.17.0
Visual Studio 2022 Preview-kanal https://aka.ms/vs/17/pre/channel VisualStudio.17.Preview
Visual Studio 2019 Utgivningskanal https://aka.ms/vs/16/release/channel VisualStudio.16.Release
Visual Studio 2017 Versionskanal https://aka.ms/vs/15/release/channel VisualStudio.15.Release
Anpassad layout – Privat kanal \\layoutserver\share\path\channelmanifest.json VisualStudio.17.Release (eller vad layouten baserades på)

Om du väljer att använda en anpassad layout som uppdateringskanal bör du tänka på följande riktlinjer:

Använda --remove

  • Ta bort komponenten Profileringsverktyg från den installerade Visual Studio-standardinstansen. I det här exemplet används installationsprogrammet som redan är installerat på klientdatorn. Standard-användare med rätt behörigheter kan programmatiskt köra kommandot modify med hjälp av installationsprogrammet, men de får inte använda växeln --passive eller --quiet. Observera att du inte kan initiera installationsprogrammet programmatiskt från samma katalog som installationsprogrammet finns i.

    "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

Du kan inte använda --remove i samma kommando som --layout. Det går med andra ord inte att ta bort komponenter från en layout.

Använda --removeOos

Med hjälp av senaste installationsprogrammetkan du ändra en installation och ta bort alla komponenter som har övergått till ett tillstånd som inte stöds från den installerade Visual Studio-standardinstansen. I det här exemplet används installationsprogrammet som redan är installerat på klientdatorn för att konfigurera inställningen removeOos. Standard-användare kan, om de har beviljats lämpliga behörigheter, programmatiskt köra kommandot modify med installationsprogrammet, men de får inte använda växeln --passive eller --quiet. Du kan inte initiera installationsprogrammet programmatiskt från samma katalog som installationsprogrammet finns i.

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

  • Justera uppdateringsinställningarna för att beständigt ta bort alla komponenter som övergått till ett tillstånd som inte stöds varje gång produkten uppdateras:

    "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

Använda --path

Alla dessa exempel förutsätter att du installerar en ny produkt med hjälp av en bootstrapper.

  • Använd installations-, cache- och delade sökvägar:

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

  • Använd endast installations- och cachesökvägarna:

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

  • Använd endast installations- och delade sökvägar:

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

  • Använd endast installationssökvägen:

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

Använda export

  • Använd export för att spara markeringen från en installation. I det här exemplet används installationsprogrammet som redan är installerat på klientdatorn.

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

  • Använd export för att spara anpassade val från grunden. I det här exemplet används installationsprogrammet som redan är installerat på klientdatorn.

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

Använda --config

  • Använd --config för att installera arbetsbelastningar och komponenter från en tidigare sparad installationskonfigurationsfil:

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

  • Använd --config för att lägga till arbetsbelastningar och komponenter i en befintlig installation. I det här exemplet används installationsprogrammet som redan är installerat på klientdatorn. Standard-användare med rätt behörigheter kan programmatiskt köra kommandot modify med hjälp av installationsprogrammet, men de får inte använda växeln --passive eller --quiet. Du kan inte initiera installationsprogrammet programmatiskt från samma katalog som installationsprogrammet finns i.

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

  • Använd --config för att konfigurera innehållet i en layout:

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

Använda winget

Använd verktyget Windows Package Manager "winget" för att programmatiskt installera eller uppdatera Visual Studio på dina datorer tillsammans med andra paket som hanteras av winget. Om du vill anpassa installationen och ange andra arbetsbelastningar och komponenter kan du använda wingets --override växel tillsammans med wingets install-kommando och skicka in en exporterad vsconfig-fil så här:

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

Du kan också använda winget configure och skicka in en .yaml-fil för att ändra en befintlig Visual Studio-installation. Den här metoden använder Visual Studio PowerShell DSC-providern som dokumenteras här.

Support eller felsökning

Ibland kan saker gå fel. Om Visual Studio-installationen misslyckas kan du läsa Felsöka problem med installation och uppgradering av Visual Studio för stegvis vägledning.

Här är några fler supportalternativ:

Relaterat innehåll