Använda kommandoradsparametrar för att installera, uppdatera och hantera Visual Studio

När du installerar Visual Studio programmatiskt eller från en kommandotolk kan du använda olika kommandoradsparametrar för att styra eller anpassa installationen för att utföra följande åtgärder:

• Starta installationen på klienten med vissa alternativ och beteenden förvalda.
• Automatisera installationen eller uppdateringsprocessen.
• Skapa eller underhålla en nätverkslayout för produktfilerna för att installera eller uppdatera klientdatorer.

Följande kommandoradsverb och parametrar kan användas med följande körbara filer eller program:

• Installationsprogrammet, som är den lilla (~1 MB) filen (till exempel vs_enterprise.exe) som initierar nedladdningsprocessen och den inledande installationen.
• Installationsprogrammet för Visual Studio som kanske redan är installerat på datorn och finns i mappen C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe. Du måste initiera installationsprogrammet programmatiskt från en annan katalog som installationsprogrammet finns i. Installationsprogrammet används vanligtvis för att uppdatera eller ändra kommandon.
• Med ett winget-kommando som använder wingets --override-växel.
• Med ett administratörsuppdateringspaket, som är tillgängligt att ladda ned från Microsoft Update Catalog, för att programmatiskt uppdatera nätverkslayouten. Mer information finns i artikeln Uppdatera eller ändra layouten.

Alla kommandon eller parametrar fungerar inte i var och en av dessa situationer, och eventuella särskilda varningar eller undantag dokumenteras. I vissa scenarier kanske du inte har åtkomst till alla dessa körbara filer som beskrevs tidigare. Klientdatorer kan till exempel bara ha installationsprogrammet tillgängligt för programmässig körning om Visual Studio installerades via en layout.

För att hämta de senaste bootstrappers för Visual Studio 2022, som alltid ser till att installera den senaste versionen av den aktuella kanalen, kan du ladda ned en av filerna från följande tabell. Om du vill installera en specifik version eller en specifik kanal i Visual Studio 2022, se sidan versionshistorik för Visual Studio 2022 . Den här sidan innehåller länkar till bootstrappers med fast version för varje serviceversion.

Utgåva	Bootstrapper
Visual Studio 2022 Enterprise	vs_enterprise.exe
Visual Studio 2022 Professional	vs_professional.exe
Visual Studio 2022 Community	vs_community.exe
Visual Studio 2022 Build Tools	vs_buildtools.exe

Tips

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

Installera, uppdatera, ändra, reparera, avinstallera och exportera kommandon och kommandoradsparametrar

När du anropar Visual Studio-bootstrappern eller installationsprogrammet programmatiskt för att installera produkten eller för att underhålla en layout:

• Den första parametern är kommandot (verbet) som beskriver åtgärden som ska utföras.
• De efterföljande valfria kommandoradsparametrarna, alla prefix med två bindestreck (--), definierar ytterligare hur åtgärden ska ske.

Alla Visual Studio-kommandoradsparametrar är skiftlägesokänsliga och fler exempel finns på kommandoradsparameterexempel sidan.

Syntaxexempel: vs_enterprise.exe [command] <optional parameters>...

kommando	Beskrivning
(tom)	Standardkommandot installerar både produkten och används för alla layoutunderhållsåtgärder.
modify	Ändrar en installerad produkt.
update	Uppdaterar en installerad produkt.
updateall	Uppdaterar alla installerade produkter i sekventiell ordning. Fungerar med parametrarna --quiet och --passive.
repair	Reparerar en installerad produkt.
uninstall	Avinstallerar en installerad produkt.
export	Exporterar installationskonfigurationen till en *.vsconfig fil.

Viktig

När du anger flera distinkta arbetsbelastningar eller komponenter eller språk måste du upprepa --add eller --remove kommandoradsväxeln för varje objekt.

parametrar	Beskrivning
--installPath <dir>	För standardinstallationskommandot är den här parametern Valfri och beskriver var instansen är installerad på klientdatorn. För andra kommandon som uppdatering eller ändring är den här parametern Krävs och anger installationskatalogen för instansen att agera på.
--productId <id>	Valfri: ID för produktinstansen som ändras och används med --channelId. productID liknar "Microsoft.VisualStudio.Product.Enterprise".
--channelUri	Valfri: Under ett uppdateringskommando kan du skicka in en ny --channelUri för att ändra platsen för uppdateringsinställningarna. Vi rekommenderar att du parkopplar med --installPath parameter så att det är explicit vilken instans av Visual Studio du konfigurerar. Se syntaxexempel på --channelUri
--channelId <id>	ID:t för kanalen, till exempel VisualStudio.17.Release. Se syntaxexempel på --channelId. channelId krävs för att ändra åtgärder, tillsammans med antingen --productID eller --installPath.
--add <one or more workload or component IDs>	Valfri: Under ett kommando för installation eller ändring anger denna repeterbara parameter ett eller flera ID:n för arbetsuppgifter eller komponenter som ska läggas till. De nödvändiga komponenterna i artefakten installeras, men inte de rekommenderade eller valfria komponenterna. Du kan styra andra komponenter globalt med hjälp av parametrarna --includeRecommended och/eller --includeOptional. Om du vill inkludera flera arbetsbelastningar eller komponenter upprepar du kommandot --add (till exempel --add Workload1 --add Workload2). För finkornig kontroll kan du lägga till ;includeRecommended eller ;includeOptional till ID:t (till exempel --add Workload1;includeRecommended eller --add Workload2;includeRecommended;includeOptional). Mer information finns på sidan för arbetsbelastning och komponent-ID.
--all	Valfri: Under ett kommando för installation eller ändring gör den här parametern att alla arbetsbelastningar och komponenter för produkten installeras.
--allWorkloads	Valfri: Under ett kommando för installation eller ändring installerar den här parametern alla arbetsbelastningar och komponenter, men inga rekommenderade eller valfria komponenter.
--includeRecommended	Valfri: Under ett kommando för installation eller ändring innehåller den här parametern de rekommenderade komponenterna för alla arbetsbelastningar som är installerade. Den innehåller inte de valfria komponenterna. Arbetsbelastningarna anges antingen med --allWorkloads eller --add. Observera att med hjälp av parametern --includeRecommended aktiverar du dialogrutan Uppdateringsinställningar för att "lägga till rekommenderade komponenter för installerade arbetsbelastningar vid uppdatering". Se Anpassa uppdateringsinställningar för att ändra den här inställningen.
--includeOptional	Valfri: Under ett kommando för installation eller ändring innehåller den här parametern de valfria komponenterna för alla arbetsbelastningar som är installerade. Den innehåller inte de rekommenderade komponenterna. Arbetsbelastningarna anges antingen med --allWorkloads eller --add.
--addProductLang <language-locale>	Valfritt: Under ett kommando för installation eller ändring anger den här repeterbara parametern de språkpaket för användargränssnitt som ska installeras med produkten. Om den inte finns använder installationen språkpaketet som motsvarar datorspråket. Mer information finns i [Lista över språkinställningar]
--remove <one or more workload or component IDs>	Valfri: Under ett ändringskommando anger den här repeterbara parametern en eller flera arbetsbelastnings- eller komponent-ID:er som ska ta borts. Den kompletterar och fungerar på samma sätt som parametern --add.
(#list-of-language-locales) på den här sidan.
--removeProductLang <language-locale>	Valfri: Under ett installations- eller ändringskommando avgör den här repeterbara parametern språkpaketen för användargränssnittet som ska tas bort från produkten. Den kompletterar och fungerar på samma sätt som parametern --addProductLang.
--in <path>	Valfri: URI:n eller sökvägen till en -svarsfil, som kan innehålla konfigurationsinställningar.
--quiet	Valfri: Används med alla kommandon förhindrar den här parametern att användargränssnitt visas medan kommandot körs. Det går inte att använda programmatiskt av standardanvändare oavsett hur AllowStandardUserControl-princip anges.
--passive, -p	Valfri: Den här parametern gör att användargränssnittet visas på ett icke-interaktivt sätt. Den här parametern är ömsesidigt uteslutande från (och åsidosätter faktiskt) parametern --quiet. Inte heller tillgängligt att använda programmatiskt av standardanvändare oavsett hur AllowStandardUserControl-principen anges.
--norestart	Valfri: Den här parametern måste vara kopplad till parametrarna --passive eller --quiet. Under ett kommando för installation, uppdatering eller ändring fördröjer tillägg av --norestart-parametern alla nödvändiga omstarter.
--force	Valfri: Den här parametern tvingar Visual Studio att stängas även om någon Visual Studio-process används. Att tvinga Visual Studio att stänga kan orsaka arbetsförlust, så använd det med försiktighet.
--installWhileDownloading	Valfritt: Under ett kommando för installation, uppdatering eller ändring gör den här parametern att Visual Studio både kan ladda ned och installera produkten parallellt. Det är standardupplevelsen.
--downloadThenInstall	Valfri: Under ett kommando för installation, uppdatering eller ändring tvingar den här parametern Visual Studio att ladda ned alla filer innan de installeras. Det utesluter varandra med parametern --installWhileDownloading.
--nickname <name>	Valfri: Under ett installationskommando definierar den här parametern smeknamnet för att tilldela till en installerad produkt. Smeknamnet får inte vara längre än 10 tecken.
--productKey	Valfri: Under ett installationskommando definierar den här parametern produktnyckeln som ska användas för en installerad produkt. Produktnyckeln består av 25 alfanumeriska tecken i formatet xxxxxxxxxxxxxxxxxxxxxxxxx.
--removeOos true	Valfritt: Under ett kommando för installation, uppdatering eller ändring meddelar den här parametern, följt av true eller false, Visual Studio-installationsprogrammet om alla installerade komponenter som har övergått till ett tillstånd som inte stöds ska tas bort. Det här beteendet gäller för en enskild händelse. Om du vill göra det här beteendet beständigt, tillämpa denna parameter till kommandot modifySettings, som beskrivs senare, eller konfigurera den globala policyn removeOOS. Användbart för att skydda datorn.
--config <path to *.vsconfig file>	Valfri: Under en installation eller ändringsåtgärd kan du skicka in en konfigurationsfil med hjälp av parametern --config för att ange de arbetsbelastningar, komponenter eller tillägg som ska läggas till baserat på en tidigare sparad installationskonfigurationsfil. Den här åtgärden är endast additiv. det tar inte bort något som inte anges i filen. Objekt som anges i konfigurationsfilen som inte gäller för produkten läggs inte till. Vi rekommenderar starkt att du anger den fullständigt kvalificerade sökvägen till konfigurationsfilen. Under en exportåtgärd avgör den här parametern platsen där installationskonfigurationsfilen ska sparas.
--allowUnsignedExtensions	Valfri: Under en installation eller ändringsåtgärd som körs i en --passive eller --quiet-kontext med hjälp av en --config-fil, är den här parametern nödvändig för att kunna läsa in tillägg utan digital signatur.
--installerOnly	Valfri: Under en installation eller uppdatering uppmanar den här parametern Visual Studio Installer att installera sig själv (installationsprogrammet) och inte Visual Studio-produkten. Dess funktioner motsvarar parametern --update, men mer intuitiv. Avsett att användas när du förbereder och förkonfigurerar klientdatorer.
--help, --?, -h, -?	Visar en offlineversion av den här sidan.

Kommandon för layout och kommandoradsparametrar

Alla layouthanteringsåtgärder, till exempel att skapa eller uppdatera en layout, körs med hjälp av bootstrapper-exe och förutsätter att kommandot är standardinstallationen (tom). Alla layouthanteringsåtgärder bör börja med den nödvändiga --layout inledande parametern. I följande tabell beskrivs de andra parametrar som du kan använda för att skapa eller uppdatera en layout med hjälp av kommandoraden.

Layoutparametrar	Beskrivning
--layout <dir>	Specificerar en katalog för att skapa eller uppdatera en offline-installationscache. Mer information finns i Skapa en nätverksbaserad installation av Visual Studio.
--lang <one or more language-locales>	Valfri: Används med --layout för att förbereda en offlineinstallationscache med resurspaket med angivet eller flera angivna språk. Mer information finns i avsnittet Lista över språkspråk på den här sidan.
--add <one or more workload or component IDs>	Valfri: Ett eller flera arbetsbelastnings- eller komponent-ID:t att lägga till. De nödvändiga komponenterna i artefakten installeras, men inte de rekommenderade eller valfria komponenterna. Du kan styra fler komponenter globalt med hjälp av --includeRecommended och/eller --includeOptional. För finkornig kontroll kan du lägga till ;includeRecommended eller ;includeOptional till ID:t (till exempel --add Workload1;includeRecommended eller --add Workload2;includeOptional). Mer information finns på sidan för arbetsbelastning och komponent-ID. Obs: Om --add används laddas endast de angivna arbetsbelastningarna och komponenterna och deras beroenden ned. Om --add inte anges laddas alla arbetsbelastningar och komponenter ned till layouten.
--includeRecommended	Valfri: Innehåller de rekommenderade komponenterna för alla arbetsbelastningar som är installerade, men ej de valfria komponenterna. Arbetsbelastningarna anges antingen med --allWorkloads eller --add.
--includeOptional	Valfri: Innehåller de rekommenderade och valfria komponenterna för alla arbetsbelastningar som ingår i layouten. Arbetsbelastningarna anges med --add.
--wait	Valfri: Processen väntar tills installationen har slutförts innan en slutkod returneras. wait är användbart när du automatiserar installationer där man måste vänta tills installationen har slutförts för att hantera returkoden från installationen. Parametern --wait kan bara skickas till bootstrappern. installationsprogrammet (setup.exe) stöder det inte. Det är användbart när du uppdaterar layouter. Fler exempel finns här.
--useLatestInstaller	Valfri: Legacy-funktionalitet som endast gäller för Visual Studio-bootstrappers som är äldre än april 2023. Allt som levereras efter april 2023 använder det senaste installationsprogrammet som standard. Om den här parametern finns ingår den senaste versionen av Visual Studio Installer i layouten, även om den tillhör en nyare huvudversion av produkten. Det senaste installationsprogrammet kan vara användbart om du vill dra nytta av nya funktioner eller felkorrigeringar som är tillgängliga i den senaste versionen. Mer information finns i Konfigurera layouten för att alltid använda den senaste installationsdokumentationen.
--config <path to *.vsconfig file>	Valfri: Om det finns använder Visual Studio innehållet i konfigurationsfilen för att konfigurera layouten. Kontrollera att du anger den fullständigt kvalificerade sökvägen till konfigurationsfilen.
--noWeb	Valfri: Om det finns använder Visual Studio-installationen filerna i layoutkatalogen för att installera Visual Studio, och det laddar inte ned några paket från webben. Om en användare försöker installera komponenter som inte finns i layouten misslyckas installationen. Använd inte den här parametern om du försöker distribuera en layout som finns på en intern intranätwebbplats. Mer information finns i Installera på en klient som inte har internetåtkomst. Viktigt: Parametern --noWeb hindrar inte Visual Studio Installer på en Internetansluten klientdator från att söka efter uppdateringar om klienten är konfigurerad för att titta på Microsofts värdbaserade servrar efter uppdateringar. I det här fallet hindrar --noWeb helt enkelt klienten från att ladda ned produktpaketen.
--verify	Valfri: Verifiera innehållet i en layout. Eventuella skadade eller saknade filer visas.
--fix	Valfri: Verifiera innehållet i en layout. Om några filer är skadade eller saknas laddas de ned igen. Internetåtkomst krävs för att åtgärda en layout.
--clean <one or more paths to catalogs>	Valfri: Tar bort gamla versioner av komponenter från en layout som uppdateras till en nyare version.

Avancerade layoutparametrar	Beskrivning
--channelId <id>	Valfri: ID för kanalen för den instans som ska installeras, representerad som VisualStudio.17.Release. channelId krävs för installationskommandot och ignoreras för andra kommandon om --installPath anges. Se syntaxexempel på --channelId.
--channelUri <uri>	Valfri: URI för kanalmanifestet. Det här värdet styr källplatsen för uppdateringar och det ursprungliga värdet är konfigurerat i layoutens response.json fil. Se syntaxexempel på --channelUri- för möjliga värden. Om uppdateringar inte är önskade kan --channelUri peka på en fil som inte finns (till exempel --channelUri C:\doesntExist.chman). Den här parametern kan användas för installationskommandot. andra kommandon ignorerar det.
--installChannelUri <uri>	Valfri: URI:n för kanalmanifestet som ska användas för installationen. Den URI som anges av --channelUri (som måste anges när --installChannelUri anges) används för att identifiera uppdateringar. Den här parametern kan användas för installationskommandot. andra kommandon ignorerar det.
--installCatalogUri <uri>	Valfri: URI:n för katalogmanifestet som ska användas för installationen. Om det anges försöker kanalhanteraren ladda ned katalogmanifestet från den här URI:n innan URI:n används i installationskanalmanifestet. Den här parametern används för att stödja offlineinstallation, där layoutcachen skapas med produktkatalogen redan nedladdad. Den här parametern kan användas för installationskommandot. andra kommandon ignorerar det.
--productId <id>	Valfri: ID för produkten för den installerade instansen. Den här parametern fylls i i förväg under normala installationsförhållanden. productID liknar "Microsoft.VisualStudio.Product.Enterprise".
--arch all	Valfri: Som standard skapas layouter med endast x64-produktbinärfiler. Om du vill inkludera ARM-binärfiler för tillämpliga arbetsbelastningar tillsammans med x64-binärfilerna i en layout använder du parametern --arch all eller --arch *. Om du vill skapa en layout med bara ARM-binärfiler använder du --arch arm64
--keepLayoutVersion	Valfri: Tillämpa ändringar i layouten utan att uppdatera produktversionen som ingår i layouten.
--locale <language-locale>	Valfri: Ändra visningsspråket för användargränssnittet för själva installationsprogrammet. Inställningen sparas. Mer information finns i avsnittet Lista över språkspråk på den här sidan.
--cache	Valfri: Om tillgängliga, behålls paketen när de har installerats för efterföljande reparationer. Detta åsidosätter den globala principinställning som ska användas för efterföljande installationer, reparationer eller ändringar. Standardprincipen är att cachelagra paket. Detta ignoreras för avinstallationskommandot. Läs om hur du inaktivera eller flytta paketcachen för mer information.
--nocache	Valfri: Om det finns kommer paket att tas bort när de har installerats eller reparerats. De laddas bara ned igen om det behövs och tas bort igen efter användning. Detta åsidosätter den globala principinställning som ska användas för efterföljande installationer, reparationer eller ändringar. Standardprincipen är att cachelagra paket. Detta ignoreras för avinstallationskommandot. Läs om hur du inaktivera eller flytta paketcachen för mer information.
--noUpdateInstaller	Valfritt: Om det är närvarande förhindrar det installationsprogrammet från att uppdatera sig själv när tyst läge har angetts. Installationsprogrammet misslyckas med kommandot och returnerar en slutkod som inte är noll om noUpdateInstaller anges med tyst när en installationsuppdatering krävs.
--path <name>=<path>	Valfri: Används för att ange anpassade installationssökvägar för installationen. Sökvägsnamn som stöds är delade, cachelagrade och installerade.
--path cache=<path>	Valfri: Använder den plats som du anger för att ladda ned installationsfiler. Den här platsen kan bara ställas in första gången som Visual Studio installeras. Exempel: --path cache="C:\VS\cache"
--path shared=<path>	Valfri: Innehåller delade filer för Visual Studio-installationer sida vid sida. Vissa verktyg och SDK:er installeras på en plats på den här enheten, medan vissa andra kan åsidosätta den här inställningen och installera på en annan enhet. Exempel: --path shared="C:\VS\shared" Viktigt: Detta kan bara anges en gång och första gången som Visual Studio installeras.
--path install=<path>	Valfri: Motsvarar –-installPath. Mer specifikt är --installPath "C:\VS" och --path install="C:\VS" likvärdiga. Endast ett av dessa kommandon kan användas i taget.

ModifySettings-kommando- och kommandoradsparametrar

Du kan ändra uppdateringsinställningarna och programmatiskt konfigurera källplatsen för uppdateringar för en viss instans av Visual Studio med hjälp av antingen installationsprogrammet eller bootstrappern på klientdatorn och skicka in kommandot modifySettings och önskad uppdateringskanal.

kommando	Beskrivning
modifySettings	Verb som används för att ändra uppdateringsinställningarna för en viss instans av Visual Studio.

ändrarInställningar parametrar	Beskrivning
--installPath <dir>	Rekommenderade att använda för att ange vilken instans av Visual Studio som ska användas.
--newChannelUri	Krävs: URI för kanalmanifestet. Det här värdet anger var nästa källplats för uppdateringar ska vara. Se syntaxexempel på --channelUri- för möjliga värden. Om uppdateringar inte är önskade kan --channelUri peka på en fil som inte finns (till exempel --channelUri C:\doesntExist.chman).
--channelUri	URI:n för det gamla kanalmanifestet. Kan användas om --installPath inte är känd. Måste användas tillsammans med productID för att identifiera rätt instans att agera på.
--productId <id>	Måste användas om --channelUri har angetts och används för att identifiera rätt instans att agera på. productID liknar "Microsoft.VisualStudio.Product.Enterprise".
--includeRecommended	Valfritt: Under ett modifySettings-kommando uppmanar den här parametern (som måste ha ordet sant eller falskt direkt efter det) Visual Studio-installationsprogrammet att inaktivera funktionen "lägg till rekommenderade komponenter för installerade arbetsbelastningar vid uppdatering" i dialogrutan Uppdateringsinställning.
--quiet	Valfri: Den här parametern förhindrar att användargränssnitt visas medan kommandot körs. Kan inte användas programmerbart av standardanvändare.
--removeOos true	Valfritt: Under ett modifySettings-kommando instruerar den här parametern (som måste följas direkt av orden true eller false) Visual Studio-installationsprogrammet att permanent ta bort (eller inte ta bort) alla installerade komponenter som har blivit föråldrade och inte längre stöds. Användbart för att skydda datorn.

Syntaxexempel:

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

Återställningskommando och kommandoradsparametrar

Från och med Visual Studio 2022 kan du återställa en uppdatering programmatiskt med hjälp av installationsprogrammet på klientdatorn och skicka in återställningskommandot tillsammans med installationssökvägsinstansen.

kommando	Beskrivning
rollback	Kommando för att återställa en viss instans av Visual Studio till den tidigare installerade uppdateringen. Det här kommandot fungerar inte om DisableRollback är aktiverat.

återställningsparametrar	Beskrivning
--installPath <dir>	Rekommenderade att använda för att ange vilken instans av Visual Studio som ska användas.

Syntaxexempel:

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

Kommandot "Administrator Update" och dess kommandoradsparametrar

Du kan ladda ned en Administratörsuppdatering från Microsoft Update Catalog och använda den för att uppdatera antingen klientinstallationen eller layouten.

Uppdatering av layout

Om du uppdaterar en layout till en viss version av Visual Studio laddar du bara ned administratörsuppdateringen till den dator som är värd för layouten, öppnar en kommandotolk på datorn och kör ett kommando som det här:

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

Uppdatera en klient

Om du laddar ned administratörsuppdateringen till installationskatalogen på klientdatorn på klienten på klienten kan du dubbelklicka på filen för att tillämpa uppdateringen. Du kan också öppna ett kommandofönster och skicka några av parametrarna nedan för att ändra standardbeteendet.

Konfigurera administratörsuppdateringen i SCCM

Om du distribuerar administratörsuppdateringen via Microsoft Endpoint Manager (SCCM) kan du ändra paketet för att justera beteendet med hjälp av parametrarna nedan. Du kan också styra parametrarna via en konfigurationsfil på klientdatorn. Mer information finns i Metoder för att konfigurera en administratörsuppdatering

Observera att alla parametrar för administratörsuppdatering körs som standard i "uppdateringskontexten" såvida inte layoutverb har angetts.

Administratörsuppdateringsparametrar	Beskrivning
--installerUpdateArgs [optional parameters]	Den här parametern fungerar som en "direktmatris" med specifika parametrar som är relevanta för administratörsuppdateringsscenarier. Valfria parametrar som är aktiverade för detta ändamål är: --quiet: Detta är standardupplevelsen för administratörsuppdateringar och visas här för fullständighet. --passive: Den här parametern åsidosätter parametern --quiet. Det gör att användargränssnittet visas på ett icke-interaktivt sätt. --norestart: Den här parametern måste användas tillsammans med antingen --quiet eller --passive och det gör att alla nödvändiga omstarter fördröjs. --noWeb: Den här parametern hindrar Visual Studio från att söka efter uppdateringar av produkten på Internet. --force: Den här parametern tvingar Visual Studio att stängas även om Visual Studio används. Använd den här parametern med försiktighet eftersom den kan orsaka arbetsförlust. Den här parametern får endast användas när administratörsuppdateringen körs i användarkontext. det ignoreras om administratörsuppdateringen körs i systemkontext. --installWhileDownloading: Med den här parametern kan Visual Studio både ladda ned och installera produkten parallellt. Det är standardupplevelsen för administratörsuppdateringar och visas här för fullständighet. --keepWindowsUpdateOn: Den här parametern förhindrar att installationsprogrammet inaktiverar Windows Update-agenten på klienten. Du bör använda den här parametern om du importerar en administratörsuppdatering från katalogen till SCCM. Du kan också behöva ange att TIDSGRÄNSen för SCCM-paketet ska vara längre än standardvärdet på 10 minuter. Om du ändrar SCCM-distributionstypen till Obligatorisk blir den här parametern onödig. --downloadThenInstall: Den här parametern tvingar Visual Studio att ladda ned alla filer innan de installeras. Det utesluter varandra med parametern --installWhileDownloading.
--checkPendingReboot	Uppdateringen avbryts om det finns en väntande omstart på datorn, oavsett vilket program som kan ha orsakat den. Standardvärdet är att inte söka efter väntande omstarter.

Syntaxexempel för att skicka parametrar till en administratörsuppdatering:

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

Ta bort kanalkommando och kommandoradsparametrar

Kanaler som är tillgängliga för uppdateringar cachelagras på klienten och med tiden kan de göra systemet rörigt. Du kan manuellt ta bort uppdateringskanaler genom att öppna Installationsprogrammet för Visual Studio, växla till fliken Tillgänglig och klicka på X i det övre högra hörnet på produktkortet. Du kan programmatiskt ta bort kanaler (till exempel äldre layoutplatser) med hjälp av kommandot removeChannel. Du kan köra vswhere programmatiskt på klientdatorn för att avgöra vilka kanaler som cachelagras på klientdatorn.

kommando	Beskrivning
removeChannel	Kommando för att ta bort en kanal från klientdatorn.

removeChannel-parametrar	Beskrivning
--channelUri	Krävs Den gamla kanalmanifestets URI.
--quiet	Valfritt Den här parametern förhindrar att något användargränssnitt visas medan kommandot körs.
--passive	Valfri Den här parametern åsidosätter parametern --quiet. Det gör att användargränssnittet visas på ett icke-interaktivt sätt.

Syntaxexempel:

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

Använda winget för att installera eller ändra Visual Studio

Du kan använda verktyget Windows Package Manager "winget" för att programmatiskt installera, ändra eller uppdatera Visual Studio på datorn tillsammans med andra paket som hanteras av winget.

Som standard installerar winget bara Visual Studio Core-arbetsbelastningen.

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

Men om du vill anpassa installationen och ange ytterligare arbetsbelastningar och komponenter som ska hämtas under den första installationen kan du använda wingets --override växla tillsammans med wingets install-kommando och skicka in en exporterad vsconfig-fil som innehåller de arbetsbelastningar och komponenter som ska läggas till:

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

Naturligtvis kan du också bara inkludera komponenter direkt under den första installationen, så här:

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

Om du redan har Visual Studio installerat på datorn kan du använda wingets configure-kommando tillsammans med Visual Studio PowerShell DSC-providern, en yaml-fil och en .vsconfig-fil för att lägga till komponenter i en befintlig Visual Studio-installation. Wingets configure-kommando fungerar i princip som en "ändra"-åtgärd i Visual Studio. Se hur du skapar en WinGet-konfigurationsfil för att lära dig hur du skapar en winget-konfiguration.

Det går inte att använda antingen --override-växeln eller Visual Studio DSC-providern tillsammans med Wingets upgrade-kommando, eftersom upgrade i princip bara fungerar som en Visual Studio-uppdateringsåtgärd och installerar den senaste versionen av komponenter som du redan har valt. Du kan inte lägga till komponenter via en uppdatering/uppgradering. Du måste använda "wingets" configure för att lägga till komponenter.

Observera att Visual Studio Installer-åtgärder för närvarande kräver administratörsbehörighet, så winget uppmanar dig att höja dina privilegier om det behövs för att slutföra kommandot. Det går inte heller att använda winget för att installera flera utgåvor (dvs. olika SKU:er) eller flera instanser av samma SKU samtidigt på en klientdator. Slutligen måste Visual Studio stängas om du ska konfigurera (ändra) det för att lägga till komponenter eller uppgradera det till den senaste versionen.

Lista över arbetsbelastnings-ID:n och komponent-ID:n

En lista över arbetsbelastnings- och komponent-ID:t sorterade efter Visual Studio-produkt finns på sidan Visual Studio-arbetsbelastning och komponent-ID:t.

Lista över språklokaler

språk-lokalitet	Language
Cs-cz	Tjeckiska
De-de	Tyska
En-us	Engelska
Es-es	Spanska
Fr-fr	Franska
It-it	Italienska
Ja-jp	Japanska
Ko-kr	Koreanska
Pl-pl	Polska
Pt-br	Portugisiska – Brasilien
Ru-ru	Ryska
Tr-tr	Turkiska
Zh-cn	Kinesiska – förenklad
Zh-tw	Kinesiska – traditionell

Felkoder

Beroende på resultatet av åtgärden anges %ERRORLEVEL% miljövariabeln till något av följande värden:

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

Varje åtgärd genererar flera loggfiler i katalogen %TEMP% som anger förloppet för installationen. Sortera mappen efter datum och leta efter filer som börjar med dd_bootstrapper, dd_clientoch dd_setup för bootstrappern, installationsappen respektive installationsmotorn.

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:

• Använd supportalternativet installationschatt (endast engelska) för installationsrelaterade problem.
• Rapportera produktproblem till oss med hjälp av verktyget Rapportera ett problem som visas både i Visual Studio Installer och i Visual Studio IDE. Om du är IT-administratör och inte har Visual Studio installerat kan du skicka IT-administratörsfeedback.
• Föreslå en funktion, spåra produktproblem och hitta svar i Visual Studio Developer Community.

Relaterat innehåll

• exempel på kommandoradsparameter för Visual Studio-installation
• Skapa en offlineinstallation av Visual Studio
• Automatisera Visual Studio-installation med en svarsfil
• Visual Studio-arbetsbelastning och komponent-ID:n