Parancssori paraméterek használata a Visual Studio telepítéséhez, frissítéséhez és kezeléséhez

Amikor programozott módon vagy parancssorból telepíti a Visual Studiót, különböző parancssori paraméterekkel szabályozhatja vagy testre szabhatja a telepítést a következő műveletek végrehajtásához:

• Indítsa el a telepítést az ügyfélen bizonyos előre kiválasztott beállításokkal és műveletekkel.
• Automatizálja a telepítési vagy frissítési folyamatot.
• Hozza létre vagy tartsa karban a termékfájlok hálózati elrendezését az ügyfélszámítógépek telepítéséhez vagy frissítéséhez.

A következő parancssori parancsok és paraméterek használhatók a következő végrehajtható fájlokkal vagy programokkal:

• A telepítő indítóprogramja, amely a letöltési folyamatot és a kezdeti telepítést kezdeményező kis (például vs_enterprise.exe, ~1 MB) fájl.
• A Visual Studio telepítője, amely már telepítve lehet a gépen, és a C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exemappában található. A telepítőt programozott módon kell elindítania egy másik könyvtárból, amelyben a telepítő található. A telepítőt általában a parancsok frissítésére vagy módosítására használják.
• Winget parancs használata a winget --override kapcsolóval.
• A microsoftos frissítési katalógus letölthető rendszergazdai frissítési csomaggal programozott módon frissítheti a hálózati elrendezést. További információt a Az elrendezés frissítése vagy módosítása cikkben talál.

Ezekben a helyzetekben nem minden parancs vagy paraméter működik, és minden speciális kikötés vagy kivétel dokumentálva van. Ezenkívül bizonyos esetekben előfordulhat, hogy nem rendelkezik hozzáféréssel a korábban ismertetett összes végrehajtható fájlhoz. Előfordulhat például, hogy az ügyfélszámítógépek csak akkor rendelkeznek a telepítővel programozott végrehajtáshoz, ha a Visual Studio elrendezésen keresztül lett telepítve.

Ha le szeretné szerezni a Visual Studio 2026 legújabb bootstrappereit, amelyek mindig az aktuális csatorna legújabb verzióját telepítik, töltse le az alábbi táblázat egyik fájlját. Másik lehetőségként a Visual Studio 2026 egy adott verziójának vagy egy adott csatornájának telepítéséhez tekintse meg a Visual Studio 2026 kiadási előzményeit ismertető oldalt. Ezen az oldalon az egyes karbantartási kiadásokhoz tartozó javított verziójú rendszerindítókra mutató hivatkozások találhatók.

Kiadás	Bootstrapper
Visual Studio 2026 Enterprise	vs_enterprise.exe
Visual Studio 2026 Professional	vs_professional.exe
Visual Studio 2026 Közösség	vs_community.exe
Visual Studio 2026 Build Tools	vs_buildtools.exe

Borravaló

Ha korábban letöltött egy bootstrapper-fájlt, és ellenőrizni szeretné, hogy milyen verziót fog telepíteni, az alábbiak szerint. Windows rendszerben nyissa meg a Fájlkezelőt, kattintson a jobb gombbal a bootstrapper fájlra, válassza a Tulajdonságok lehetőséget, majd válassza a Részletek lapot. A Termékverzió mező a rendszerindító által telepített csatornát és verziót ismerteti. A verziószámot mindig a "megadott legfrissebb karbantartási verzióként" kell olvasni, és a csatorna csak akkor aktuális, ha kifejezetten meg van adva. Így a Stable 18.0 termékverziójával rendelkező bootstrapper telepíti a legújabb 18.0.x karbantartási kiadást, amely a 18.0 Stabil csatornán érhető el. Egy olyan telepítőprogram, amelynek termékverziója egyszerűen csak "Visual Studio 2026", telepíteni fogja a Visual Studio 2026 legújabb verzióját a Stabil csatornára.

Parancsok és parancssori paraméterek telepítése, frissítése, módosítása, javítása, eltávolítása és exportálása

Amikor a Visual Studio bootstrappert vagy a telepítőt programozott módon invokálják a termék telepítéséhez vagy egy elrendezés fenntartásához:

• Az első paraméter a végrehajtandó műveletet leíró parancs (az ige).
• A következő választható parancssori paraméterek, amelyek mindegyike két kötőjellel (---) van előtaggal el van adva, tovább határozzák meg, hogy ennek a műveletnek hogyan kell történnie.

A Visual Studio összes parancssori paramétere nem érzékenyek a kis- és nagybetűkre, és további példákat találhat a parancssori paraméterek példái oldalon.

Példa szintaxisra: vs_enterprise.exe [command] <optional parameters>...

parancs	leírás
(üres)	Az alapértelmezett parancs mindkettő telepíti a terméket, és az összes elrendezéskarbantartási művelethez használatos.
modify	Módosítja a telepített terméket.
update	Telepített termék frissítése.
updateall	Az összes telepített terméket szekvenciális sorrendben frissíti. --quiet és --passive paraméterekkel működik.
repair	Kijavít egy telepített terméket.
uninstall	Eltávolít egy telepített terméket.
export	Exportálja a telepítési konfigurációt egy *.vsconfig fájlba.

Fontos

Több különböző számítási feladat, összetevő vagy nyelv megadásakor minden elemhez meg kell ismételnie a --add vagy --remove parancssori kapcsolót.

paraméterek	leírás
--installPath <dir>	Az alapértelmezett telepítési parancs esetében ez a paraméter Nem kötelező, és leírja, hogy hol van telepítve a példány az ügyfélszámítógépen. Más parancsok, például frissítés vagy módosítás esetén ez a paraméter Kötelező, és a példány telepítési könyvtárát jelöli.
--productId <id>	Választható: A termékpéldány azonosítója, amelyet módosítottak, és a --channelId-vel használnak. A productID a következőhöz hasonló: "Microsoft.VisualStudio.Product.Enterprise".
--channelUri	Választható: A frissítési parancs során megadhat egy új --channelUri-t a frissítési beállítások helyének módosításához. Javasoljuk, hogy párosítsa --installPath paraméterrel, hogy egyértelmű legyen, hogy melyik Visual Studio-példányt konfigurálja. Lásd --channelUri szintaxisának példáit
--channelId <id>	A csatorna azonosítója, például VisualStudio.17.Release. Lásd --channelIdszintaxisának példáit. channelId szükséges a módosítási műveletekhez, --productID vagy --installPathmellett.
--add <one or more workload or component IDs>	Választható: A telepítési vagy módosítási parancsok során ez az megismételhető paraméter egy vagy több hozzáadandó számítási feladatot vagy összetevőazonosítót határoz meg. Az artefaktum szükséges összetevői telepítve vannak, de az ajánlott vagy opcionális összetevők nincsenek. Más összetevőket globálisan is vezérelhet --includeRecommended és/vagy --includeOptional paraméterekkel. Több számítási feladat vagy összetevő hozzáadásához ismételje meg a --add parancsot (például --add Workload1 --add Workload2). Finomabb szabályozáshoz hozzáfűzhet ;includeRecommended vagy ;includeOptional az azonosítóhoz (például --add Workload1;includeRecommended vagy --add Workload2;includeRecommended;includeOptional). További információ a munkaigény és összetevő-azonosítók oldalon található.
--all	Választható: A telepítési vagy módosítási parancsok során ez a paraméter a termék összes számítási feladatát és összetevőjét telepíti.
--allWorkloads	Választható: A telepítési vagy módosítási parancsok során ez a paraméter telepíti az összes számítási feladatot és összetevőt, de nem javasolt vagy nem kötelező összetevőket.
--includeRecommended	Választható: A telepítési vagy módosítási parancsok során ez a paraméter tartalmazza a telepített számítási feladatokhoz ajánlott összetevőket. Nem tartalmazza az opcionális összetevőket. A számítási feladatok meg vannak adva --allWorkloads vagy --addsegítségével. Vegye figyelembe, hogy a --includeRecommended paraméter használatával a Frissítési beállítások párbeszédpanelen engedélyezheti, hogy a frissítési folyamat során javasolt összetevőket adjon hozzá a telepített munkafolyamatokhoz. A beállítás módosításához lásd frissítési beállítások testreszabása.
--includeOptional	Választható: A telepítési vagy módosítási parancsok során ez a paraméter tartalmazza a telepített számítási feladatok opcionális összetevőit. Nem tartalmazza az ajánlott összetevőket. A számítási feladatok meg vannak adva --allWorkloads vagy --addsegítségével.
--addProductLang <language-locale>	Választható: A telepítési vagy módosítási parancsok során ez az megismételhető paraméter határozza meg a termékkel együtt telepíteni kívánt felhasználói felületi nyelvi csomagokat. Ha nincs jelen, a telepítés a gép területi beállításának megfelelő nyelvi csomagot használja. További információ: [Nyelvi területi beállítások listája]
--remove <one or more workload or component IDs>	Nem kötelező: A módosítási parancs során ez az megismételhető paraméter egy vagy több eltávolítandó számítási feladatot vagy összetevőazonosítót határoz meg. A --add paraméterhez hasonlóan kiegészíti és viselkedik.
--removeProductLang <language-locale>	Választható: Egy telepítési vagy módosítási parancs során ez az ismétlődő paraméter határozza meg a termékből eltávolítandó felhasználói felületi nyelvi csomagokat. A --addProductLang paraméterhez hasonlóan kiegészíti és viselkedik. További információ: Nyelvi területi beállítások listája szakasz ezen a lapon.
--in <path>	Választható: A konfigurációs beállításokat tartalmazó válaszfájlURI-ja vagy elérési útja.
--quiet	Nem kötelező: Bármely parancshoz használva ez a paraméter megakadályozza, hogy a felhasználói felület megjelenjen a parancs végrehajtása közben. Nincs programozott használatra elérhető standard felhasználók számára, függetlenül attól, hogyan van beállítva az AllowStandardUserControl szabályzat.
--passive, -p	Választható: Ez a paraméter nem interaktív módon jeleníti meg a felhasználói felületet. Ez a paraméter kölcsönösen kizárja (és valójában felülbírálja) a --quiet paramétert. A standard felhasználók programozott módon sem használhatók, függetlenül attól, hogy a AllowStandardUserControl szabályzat be van állítva.
--norestart	Választható: Ezt a paramétert a --passive vagy --quiet paraméterekkel kell párosítani. A telepítés, frissítés vagy módosítás során a --norestart paraméter hozzáadása késlelteti a szükséges újraindítást.
--force	Választható: Ez a paraméter arra kényszeríti a Visual Studiót, hogy akkor is bezárjon, ha bármilyen Visual Studio-folyamat van használatban. A Visual Studio bezárásának kényszerítése munkavesztést okozhat, ezért körültekintően használja.
--installWhileDownloading	Választható: A telepítési, frissítési vagy módosítási parancsok során ez a paraméter lehetővé teszi, hogy a Visual Studio párhuzamosan töltse le és telepítse a terméket. Ez az alapértelmezett felület.
--downloadThenInstall	Nem kötelező: A telepítési, frissítési vagy módosítási parancsok során ez a paraméter arra kényszeríti a Visual Studiót, hogy a telepítés előtt töltse le az összes fájlt. Ez kölcsönösen kizárja a --installWhileDownloading paramétert.
--nickname <name>	Választható: A telepítési parancs során ez a paraméter határozza meg a telepített termékhez rendelendő becenevet. A becenév legfeljebb 10 karakter hosszúságú lehet.
--productKey	Nem kötelező: A telepítési parancs során ez a paraméter határozza meg a telepített termékhez használandó termékkulcsot. A termékkulcs 25 alfanumerikus karakterből áll xxxxxxxxxxxxxxxxxxxxxxxxxformátumban.
--removeOos true	Nem kötelező: A telepítési, frissítési vagy módosítási parancsok során ez a paraméter, amelyet a true vagy falsekövet, közli a Visual Studio Telepítővel, hogy eltávolítja-e az összes olyan telepített összetevőt, amely nem támogatott állapotba vált. Ez a viselkedés egyetlen eseményre alkalmazható. Ha ezt a viselkedést állandóvá szeretné tenni, alkalmazza ezt a paramétert a később ismertetett ModifySettings parancsra, vagy konfigurálja a removeOOS globális szabályzatot. Hasznos segítséget nyújt a gép biztonságának megőrzésében.
--config <path to *.vsconfig file>	Nem kötelező: A telepítési vagy módosítási művelet során a --config paraméterrel átadhat egy konfigurációs fájlt a korábban mentett telepítési konfigurációs fájl alapján hozzáadni kívánt számítási feladatok, összetevők vagy bővítmények megadásához. Ez a művelet csak additív; nem távolít el semmit, ami nincs megadva a fájlban. Emellett a konfigurációs fájlban megadott, a termékre nem érvényes elemek nem lesznek hozzáadva. Javasoljuk, hogy adja meg a konfigurációs fájl teljes elérési útját. Az exportálási művelet során ez a paraméter határozza meg a telepítési konfigurációs fájl mentésének helyét.
--allowUnsignedExtensions	Választható: A telepítési vagy módosítási művelet --passive vagy --quiet környezetben fut egy --config fájl használatával, ha a konfigurációs fájlban bővítmények vannak megadva, akkor ez a paraméter szükséges a bővítmények digitális aláírás nélküli betöltéséhez.
--installerOnly	Választható: A telepítési vagy frissítési művelet során ez a paraméter arra utasítja a Visual Studio Installert, hogy csak magát (a telepítőt) telepítse, és ne a Visual Studio-terméket. Működése egyenértékű a --update paraméterével, de intuitívabb. Az ügyfélgépek elő- és előkonfigurálásához használható.
--help, --?, -h, -?	A lap offline verzióját jeleníti meg.

Elrendezési parancs és parancssori paraméterek

Minden elrendezéskezelési művelet( például elrendezés létrehozása vagy frissítése) a bootstrapper exe használatával fut, és feltételezi, hogy a parancs az alapértelmezett telepítés (üres). Minden elrendezéskezelési műveletnek a szükséges --layout kezdeti paraméterrel kell kezdődnie. Az alábbi táblázat ismerteti azokat a paramétereket, amellyel létrehozhat vagy frissíthet egy elrendezést a parancssor használatával.

elrendezési paraméterek	leírás
--layout <dir>	Megadja az offline telepítési gyorsítótár létrehozásához vagy frissítéséhez szükséges könyvtárat. További információ: A Visual Studiohálózati telepítésének létrehozása.
--lang <one or more language-locales>	Választható: A --layout használatával készít elő offline telepítési gyorsítótárat a megadott egy vagy több megadott nyelvvel rendelkező erőforráscsomagokkal. További információ: Nyelvi területi beállítások listája szakasz ezen a lapon.
--add <one or more workload or component IDs>	Választható: Egy vagy több hozzáadandó számítási feladat vagy összetevőazonosító. Az artefaktum szükséges összetevői telepítve vannak, de az ajánlott vagy opcionális összetevők nincsenek. A --includeRecommended és/vagy --includeOptionalhasználatával több összetevőt is szabályozhat globálisan. Finomabb szabályozáshoz hozzáfűzhet ;includeRecommended vagy ;includeOptional az azonosítóhoz (például --add Workload1;includeRecommended vagy --add Workload2;includeOptional). További információ a munkaigény és összetevő-azonosítók oldalon található. Megjegyzés: Ha --add használ, csak a megadott számítási feladatok és összetevők, valamint azok függőségei lesznek letöltve. Ha --add nincs megadva, a rendszer minden számítási feladatot és összetevőt letölt az elrendezésbe.
--includeRecommended	Választható: A telepített számítási feladatokhoz ajánlott összetevőket tartalmazza, az opcionális összetevőket azonban nem. A számítási feladatok meg vannak adva --allWorkloads vagy --addsegítségével.
--includeOptional	Választható: Tartalmazza az elrendezésben szereplő számítási feladatokhoz javasolt és választható összetevőket. A munkaterhelések --addszerint vannak megadva.
--wait	Választható: A folyamat a kilépési kód visszaadása előtt megvárja a telepítés befejezését. wait akkor hasznos, ha olyan telepítéseket automatizál, amelyeknél meg kell várni, amíg a telepítés befejeződik a telepítés visszatérési kódjának kezeléséhez. A --wait paraméter csak a bootstrapperbe adható át; a telepítő (setup.exe) nem támogatja. Az elrendezések frissítésekor hasznos. További példákat itt talál.
--useLatestInstaller	Választható: Örökölt funkciók, amelyek csak a 2023 áprilisánál régebbi Visual Studio bootstrapperekhez alkalmazhatók. A 2023 áprilisa után szállított termékek alapértelmezés szerint a legújabb telepítőt használják. Ha ez a paraméter jelen van, akkor a Visual Studio Installer legújabb verziója szerepel az elrendezésben, még akkor is, ha a termék egy újabb főverziójához tartozik. A legújabb telepítő akkor lehet hasznos, ha ki szeretné használni a legújabb verzióban elérhető új funkciókat vagy hibajavításokat. További információ: Az elrendezés konfigurálása a legújabb telepítő dokumentációjának használatára.
--config <path to *.vsconfig file>	Választható: Ha van ilyen, a Visual Studio a konfigurációs fájl tartalmát használja az elrendezés konfigurálásához. Győződjön meg arról, hogy megadja a konfigurációs fájl teljes elérési útját.
--noWeb	Választható: Ha van ilyen, a Visual Studio telepítője az elrendezési könyvtárban lévő fájlokat használja a Visual Studio telepítéséhez, és nem tölt le csomagokat az internetről. Ha egy felhasználó olyan összetevőket próbál telepíteni, amelyek nem szerepelnek az elrendezésben, a telepítés sikertelen lesz. Ne használja ezt a paramétert, ha belső intranetes webhelyen üzemeltetett elrendezést próbál üzembe helyezni. További információért lásd: Telepítés olyan ügyfélen, amely nem rendelkezik internet-hozzáféréssel. Fontos: A --noWeb paraméter nem állítja le, hogy a Visual Studio Installer egy internetkapcsolattal rendelkező ügyfélszámítógépen frissítéseket keressen, ha az ügyfél úgy van konfigurálva, hogy a Microsoft által üzemeltetett kiszolgálókat keresse a frissítésekhez. Ebben az esetben --noWeb egyszerűen megakadályozza, hogy az ügyfél letöltse a termékcsomagokat.
--verify	Választható: Az elrendezés tartalmának ellenőrzése. A listában minden sérült vagy hiányzó fájl szerepel.
--fix	Választható: Az elrendezés tartalmának ellenőrzése. Ha a fájlok sérültek vagy hiányoznak, a rendszer újra betölti őket. Az elrendezés javításához internet-hozzáférés szükséges.
--clean <one or more paths to catalogs>	Választható: Eltávolítja az összetevők régi verzióit egy újabb verzióra frissített elrendezésből.

Speciális elrendezési paraméterek	leírás
--channelId <id>	Választható: A telepítendő példány csatornaazonosítója, amely úgy van megadva, mint a VisualStudio.17.Release. A channelId megadása kötelező a telepítési parancshoz, és más parancsok esetén figyelmen kívül hagyva, ha --installPath van megadva. Lásd --channelIdszintaxisbeli példáit.
--channelUri <uri>	Választható: A csatornajegyzék URI-ja. Ez az érték szabályozza a frissítések forráshelyét, és a kezdeti érték konfigurálva van az elrendezés response.json fájljában. Tekintse meg --channelUri lehetséges értékeinek szintaxisát. Ha a frissítéseket nem szeretné, --channelUri nem létező fájlra mutathat (például --channelUri C:\doesntExist.chman). Ez a paraméter használható a telepítési parancshoz; más parancsok figyelmen kívül hagyják.
--installChannelUri <uri>	Választható: A telepítéshez használandó csatornajegyzék URI-ja. A --channelUri által megadott URI (amelyet --installChannelUri megadásakor kell megadni) a frissítések észlelésére szolgál. Ez a paraméter használható a telepítési parancshoz; más parancsok figyelmen kívül hagyják.
--installCatalogUri <uri>	Választható: A katalógusjegyzék telepítéshez használandó URI-ja. Ha meg van adva, a csatornakezelő megpróbálja letölteni a katalógusjegyzéket ebből az URI-ból, mielőtt az URI-t használja a telepítési csatorna jegyzékében. Ez a paraméter támogatja az offline telepítést, ahol az elrendezési gyorsítótár a már letöltött termékkatalógussal jön létre. Ez a paraméter használható a telepítési parancshoz; más parancsok figyelmen kívül hagyják.
--productId <id>	Választható: A telepített példány termékazonosítója. Ez a paraméter a normál telepítési körülmények között előre ki van töltve. A productID a következőhöz hasonló: "Microsoft.VisualStudio.Product.Enterprise".
--arch all	Választható: Alapértelmezés szerint az elrendezések csak x64 termék bináris fájljaival jönnek létre. Ha az x64 bináris fájlok mellett arm bináris fájlokat szeretne belefoglalni egy elrendezésbe, használja a --arch all vagy --arch * paramétert. A --arch arm64 használható csak ARM binárisok elrendezéséhez.
--keepLayoutVersion	Választható: Az elrendezés módosításainak alkalmazása az elrendezésben szereplő termékverzió frissítése nélkül.
--locale <language-locale>	Választható: A telepítő felhasználói felületének megjelenítési nyelvének módosítása. A beállítás megmarad. További információ: Nyelvi területi beállítások listája szakasz ezen a lapon.
--cache	Választható: Ha van ilyen, a csomagok a későbbi javításokhoz megmaradnak azután, hogy telepítve lettek. Ez felülbírálja a későbbi telepítésekhez, javításokhoz vagy módosításokhoz használandó globális házirend-beállítást. Az alapértelmezett beállítás a csomagok gyorsítótárazása. Ez az eltávolítási parancs esetében figyelmen kívül lesz hagyva. További információért olvassa el, hogyan letiltani vagy áthelyezni a csomaggyorsítótár-.
--nocache	Választható: Ha van ilyen, a csomagok a telepítés vagy javítás után törlődnek. Ezek csak szükség esetén lesznek újra letöltve, és használat után újra törlődnek. Ez felülbírálja a későbbi telepítésekhez, javításokhoz vagy módosításokhoz használandó globális házirend-beállítást. Az alapértelmezett beállítás a csomagok gyorsítótárazása. Ez az eltávolítási parancs esetében figyelmen kívül lesz hagyva. További információért olvassa el, hogyan letiltani vagy áthelyezni a csomaggyorsítótár-.
--noUpdateInstaller	Választható: Ha van ilyen, megakadályozza, hogy a telepítő a csendes állapot megadásakor frissítse magát. A telepítő végrehajtási hibát jelez és nem nulla kilépési kódot ad vissza, ha a noUpdateInstaller csendes módban van megadva, amikor szükséges a telepítő frissítése.
--path <name>=<path>	Választható: A telepítés egyéni telepítési útvonalainak megadására szolgál. A támogatott elérési utak nevei meg vannak osztva, gyorsítótárazhatók és telepíthetők.
--path cache=<path>	Választható: A telepítési fájlok letöltéséhez a megadott helyet használja. Ez a hely csak a Visual Studio első telepítésekor állítható be. Példa: --path cache="C:\VS\cache"
--path shared=<path>	Nem kötelező: Megosztott fájlokat tartalmaz egymás melletti Visual Studio-telepítésekhez. Egyes eszközök és SDK-k ezen a meghajtón lévő helyre települnek, míg mások felülírhatják ezt a beállítást, és egy másik meghajtóra települhetnek. Példa: --path shared="C:\VS\shared" Fontos: Ez csak egyszer és a Visual Studio első telepítésekor állítható be.
--path install=<path>	Választható: Egyenértékű a –-installPath. Pontosabban a --installPath "C:\VS" és a --path install="C:\VS" egyenértékűek. Egyszerre csak az egyik parancs használható.

ModifySettings parancs és parancssori paraméterek

Módosíthatja a frissítési beállításokat, és programozott módon konfigurálhatja a frissítések forráshelyét a Visual Studio egy adott példányához az ügyfélszámítógép telepítőjének vagy rendszerindítójának használatával, és átadhatja a modifySettings parancsot és a kívánt frissítési csatornát.

parancs	leírás
modifySettings	A Visual Studio egy adott példányának frissítési beállításainak módosítására használt parancs.

beállításokMódosítása paraméterek	leírás
--installPath <dir>	Javasolt annak meghatározásához, hogy a Visual Studio melyik példányán kell eljárni.
--newChannelUri	Kötelező: A csatornajegyzék URI-ja. Ez az érték határozza meg, hogy a frissítések következő forráshelyének hol lesz. Tekintse meg --channelUri lehetséges értékeinek szintaxisát. Ha a frissítéseket nem szeretné, --channelUri nem létező fájlra mutathat (például --channelUri C:\doesntExist.chman).
--channelUri	A régi csatornajegyzék URI-ja. Akkor használható, ha a --installPath nem ismert. A termékazonosítóval együtt kell használni a megfelelő példány azonosításához.
--productId <id>	Csak akkor használható, ha a --channelUri meg van adva, és a megfelelő példány azonosítására szolgál. A productID a következőhöz hasonló: "Microsoft.VisualStudio.Product.Enterprise".
--includeRecommended	Választható: A ModifySettings parancs során ez a paraméter (amelynek közvetlenül utána igaz vagy hamis szóval kell rendelkeznie) arra utasítja a Visual Studio telepítőt, hogy a Frissítési beállítások párbeszédpanelen tiltsa le az „ajánlott összetevők hozzáadása a telepített munkaterhelésekhez a frissítés során” funkciót.
--quiet	Választható: Ez a paraméter megakadályozza, hogy a felhasználói felület megjelenjen a parancs végrehajtása közben. Nem használható programmatikusan standard felhasználók által.
--removeOos true	Választható: A ModifySettings parancs során ez a paraméter (amelynek közvetlenül utána igaz vagy hamis szóval kell rendelkeznie) arra utasítja a Visual Studio telepítőjét, hogy tartósan távolítsa el (vagy ne távolítsa el) az összes olyan telepített összetevőt, amely nem támogatott állapotba vált. Hasznos segítséget nyújt a gép biztonságának megőrzésében.

Szintaxisbeli példák:

C:\>"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modifySettings --installPath "C:\Program Files\Microsoft Visual Studio\18\Enterprise" --newChannelUri https://aka.ms/vs/stable.18.0/channel --removeOos true

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

Visszaállítási parancs és parancssori paraméterek

A Visual Studio 2022-től kezdve programozott módon visszaállíthatja a frissítést az ügyfélszámítógép telepítőjének használatával, és a telepítési útvonalpéldány mellett a visszaállítási parancsot is átadhatja.

parancs	leírás
rollback	Paranccsal visszaállíthatja a Visual Studio egy adott példányát a korábban telepített frissítésre. Ez a parancs nem működik, ha a DisableRollback engedélyezve van.

visszaállítási paraméterek	leírás
--installPath <dir>	Javasolt annak meghatározásához, hogy a Visual Studio melyik példányán kell eljárni.

Szintaxisbeli példák:

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

Rendszergazdai frissítés parancs és parancssori paraméterek

Letöltheti a Rendszergazdai frissítést a Microsoft Update-katalógusból, és a segítségével frissítheti az ügyfélprogram telepítését vagy a kiosztást.

Elrendezés frissítése

Ha a Visual Studio egy adott verziójára frissíti az elrendezést, töltse le a Rendszergazdai frissítést az elrendezést üzemeltető számítógépre, nyisson meg egy parancssort a számítógépen, és futtasson egy ilyen parancsot:

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

Ügyfél frissítése

Az ügyfélen, ha letölti a rendszergazdai frissítést az ügyfélszámítógép telepítési könyvtárába, egyszerűen kattintson duplán a fájlra a frissítés alkalmazásához. Megnyithat egy parancsablakot is, és az alábbi paraméterek némelyikét átadva módosíthatja az alapértelmezett viselkedést.

A rendszergazdai frissítés konfigurálása az SCCM-ben

Ha a rendszergazdai frissítést a Microsoft Endpoint Manageren (SCCM) keresztül telepíti, módosíthatja a csomagot, hogy az alábbi paraméterekkel módosítsa a viselkedést. A paramétereket az ügyfélszámítógép konfigurációs fájlján keresztül is vezérelheti. További információ: Rendszergazdai frissítés konfigurálásának módszerei

Vegye figyelembe, hogy az összes rendszergazdai frissítési paraméter alapértelmezésként a "frissítés" környezetben fut, kivéve, ha az elrendezési parancs meg van adva.

rendszergazdai frissítési paraméterek	leírás
--installerUpdateArgs [optional parameters]	Ez a paraméter a rendszergazdai frissítési forgatókönyvek szempontjából releváns paraméterek "átmenő tömbjeként" működik. Az erre a célra engedélyezett választható paraméterek a következők: --quiet: Ez a rendszergazdai frissítések alapértelmezett felülete, és itt látható a teljesség érdekében. --passive: Ez a paraméter felülbírálja a --quiet paramétert. Emiatt a felhasználói felület nem interaktív módon jelenik meg. --norestart: Ezt a paramétert --quiet vagy --passive együtt kell használni, és a szükséges újraindítások késleltetését okozza. --noWeb: Ez a paraméter megakadályozza, hogy a Visual Studio az interneten ellenőrizze a termék frissítéseit. --force: Ez a paraméter arra kényszeríti a Visual Studiót, hogy akkor is bezárjon, ha a Visual Studio használatban van. Körültekintően használja ezt a paramétert, mert az munkavesztést okozhat. Ezt a paramétert csak akkor szabad használni, ha a rendszergazdai frissítést felhasználói környezetben hajtják végre; a rendszer figyelmen kívül hagyja, ha a rendszergazdai frissítést rendszerkörnyezetben hajtja végre. --installWhileDownloading: Ez a paraméter lehetővé teszi, hogy a Visual Studio párhuzamosan töltse le és telepítse a terméket. Ez a rendszergazdai frissítések alapértelmezett felülete, és itt találja a teljesség érdekében. --keepWindowsUpdateOn: Ez a paraméter megakadályozza, hogy a telepítő kikapcsolja a Windows Update-ügynököt az ügyfélen. Ezt a paramétert akkor érdemes használnia, ha rendszergazdai frissítést importál a katalógusból az SCCM-be. Előfordulhat, hogy az SCCM-csomag időtúllépését az alapértelmezett 10 percnél hosszabbra kell állítania. Az SCCM központi telepítési típusának kötelezőre állítása szükségtelené teszi ezt a paramétert. --downloadThenInstall: Ez a paraméter arra kényszeríti a Visual Studiót, hogy a telepítés előtt töltse le az összes fájlt. Ez kölcsönösen kizárja a --installWhileDownloading paramétert.
--checkPendingReboot	A frissítés megszakad, ha folyamatban van az újraindítás a gépen, függetlenül attól, hogy melyik alkalmazás okozhatta. Az alapértelmezett beállítás az, hogy ne ellenőrizze a függőben lévő újraindításokat.

Példa szintaxisra a paraméterek rendszergazdai frissítésbe való átadásához:

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

Távolítsa el a csatornaparancsokat és a parancssori paramétereket.

Azokról a csatornákról, amelyek elérhetők frissítés céljából, gyorsítótárazva vannak az ügyféloldalon, és idővel rendetlenséget okozhatnak. Manuálisan eltávolíthatja frissítési csatornákat a Visual Studio Installer megnyitásával, majd átkapcsol az Elérhető fülre, és kattint a termékkártya jobb felső sarkában található X gombra. A csatornákat (például a régebbi elrendezési helyeket) programozott módon eltávolíthatja a removeChannel paranccsal. Az ügyfélszámítógépen programszerűen futtathatja a vswhere-t annak meghatározásához, hogy mely csatornák vannak gyorsítótárazva az ügyfélszámítógépen.

parancs	leírás
removeChannel	Egy csatorna eltávolítására szolgáló parancs az ügyfélszámítógépről.

removeChannel paraméterek	leírás
--channelUri	Kötelező A régi csatornajegyzék URI-ja.
--quiet	Nem kötelező Ez a paraméter megakadályozza a felhasználói felület megjelenítését a parancs végrehajtása közben.
--passive	Nem kötelező Ez a paraméter felülbírálja a --quiet paramétert. Emiatt a felhasználói felület nem interaktív módon jelenik meg.

Példa szintaxisra:

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

A Winget használata a Visual Studio telepítéséhez vagy módosításához

A Windows Package Manager "winget" eszközzel programozott módon telepítheti, módosíthatja vagy frissítheti a Visual Studiót a gépén, valamint a winget által felügyelt többi csomaggal együtt.

Alapértelmezés szerint a Winget csak telepíti a Visual Studio alapvető számítási feladatait.

winget install --id Microsoft.VisualStudio.Community

Ha azonban testre szeretné szabni a telepítést, és további számítási feladatokat és összetevőket szeretne megadni a kezdeti telepítés során, használhatja a Winget --override kapcsolóját a Winget install parancsával együtt, és átadhat egy exportált vsconfig fájl, amely tartalmazza a hozzáadni kívánt számítási feladatokat és összetevőket:

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

Természetesen közvetlenül a kezdeti telepítés során is felvehet összetevőket, például:

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

Ha már telepítve van a Visual Studio a gépére, akkor winget configure parancsát, valamint a Visual Studio PowerShell DSC-szolgáltató, egy yaml-fájlt és egy .vsconfig fájlt is használhat, összetevőket adhat hozzá egy meglévő Visual Studio-telepítéshez. A Winget configure parancsa lényegében a Visual Studio "módosítási" műveleteként működik. Tekintse meg , hogyan hozhat létre WinGet-konfigurációs fájlt, ha szeretné megtudni, hogyan hozhat létre winget-konfigurációt.

A Winget --override parancsa mellett sem a upgrade kapcsolót, sem a Visual Studio DSC-szolgáltatót nem lehet használni, mivel upgrade lényegében csak a Visual Studio "frissítési" műveleteként működik, és telepíti a már kiválasztott összetevők legújabb verzióját. Nem adhat hozzá összetevőket frissítéssel vagy bővítéssel. Az összetevők hozzáadásához a winget configure parancsot kell használnia.

Vegye figyelembe, hogy a Visual Studio Installer-műveletekhez jelenleg rendszergazdai jogosultságok szükségesek, ezért a Winget arra kéri, hogy szükség esetén emelje fel a jogosultságokat a parancs végrehajtásához. Emellett jelenleg nem lehetséges a Winget használata több kiadás (azaz különböző termékváltozatok) vagy ugyanazon termékváltozat több példányának egyidejű telepítéséhez egy ügyfélszámítógépen. Végül a Visual Studiót be kell zárni, ha konfigurálja (módosítja) az összetevők hozzáadásához vagy a legújabb verzióra való frissítéséhez.

Számítási feladatok azonosítóinak és összetevőazonosítóinak listája

A Visual Studio terméke szerint rendezett számítási feladatok és összetevők azonosítóinak listáját a Visual Studio számítási feladatainak és összetevőazonosítóinak oldalán találja.

Nyelvi helyi beállítások listája

nyelvi környezet	nyelv
Cs-cz	Cseh
De-de	Német
En-us	Angol
Es-es	Spanyol
Fr-fr	Francia
It-it	Olasz
Ja-jp	Japán
Ko-kr	Koreai
Pl-pl	Lengyel
Pt-br	Portugál - Brazília
Ru-ru	Orosz
Tr-tr	Török
Zh-cn	Kínai – Egyszerűsített
Zh-tw	Kínai - Hagyományos

Hibakódok

A művelet eredményétől függően a %ERRORLEVEL% környezeti változó a következő értékek egyikére van állítva:

Érték	Eredmény
0	A művelet sikeresen befejeződött
740	Szintemelés szükséges
1001	A Visual Studio telepítőfolyamata fut
1003	A Visual Studio használatban van
1602	A művelet törölve lett.
1618	Egy másik, futó telepítés
1641	A művelet sikeresen befejeződött, és az újraindítást kezdeményezték
3010	A művelet sikeresen befejeződött, de a telepítés használatához újra kell indítani
5003	A Bootstrapper nem tudta letölteni a telepítőt
5004	A művelet törölve lett.
5005	Bootstrapper parancssori elemzési hiba
5007	A művelet le lett tiltva – a számítógép nem felel meg a követelményeknek
8001	Arm gép ellenőrzési hiba
8002	Háttérben futó letöltési előellenőrzési hiba
8003	Támogatáson kívül választható hiba
8004	A célkönyvtár hibája
8005	A forrás adattartalmának ellenőrzése nem sikerült
8006	Futnak a Visual Studio-folyamatok
8010	Az operációs rendszer nem támogatott. Tekintse meg a rendszerkövetelmények
-1073720687	Csatlakozási hiba
-1073741510	A Microsoft Visual Studio Installer leállt (a felhasználó vagy a külső folyamat)
Más (például: -1, 1, 1603 )	Hibaállapot történt – további információkért tekintse meg a naplókat

Minden művelet több naplófájlt hoz létre a %TEMP% könyvtárban, amelyek jelzik a telepítés előrehaladását. Rendezze a mappát dátum szerint, és keresse meg azokat a fájlokat, amelyek dd_bootstrapper, dd_clientés dd_setup kezdődnek a bootstrapperhez, a telepítőalkalmazáshoz és a telepítőmotorhoz.

Támogatás vagy hibaelhárítás

Néha a dolgok elromlhatnak. Ha a Visual Studio telepítése sikertelen, tekintse meg a Visual Studio telepítési és frissítési problémáinak elhárításához szükséges lépéseket tartalmazó útmutatót.

Íme néhány további támogatási lehetőség:

• A telepítéssel kapcsolatos problémák esetén használja a telepítési csevegési (csak angol nyelvű) támogatási lehetőséget.
• Termékproblémák bejelentése a Probléma eszközzel, amely a Visual Studio Installerben és a Visual Studio IDE-ben is megjelenik. Ha Ön informatikai rendszergazda, és nincs telepítve a Visual Studio, elküldheti rendszergazdai visszajelzést.
• Javasoljon egy funkciót, kövesse nyomon a termékekkel kapcsolatos problémákat, és keressen választ a Visual Studio fejlesztői közösségében.

Kapcsolódó tartalom

• Visual Studio telepítési parancssori paraméteres példái
• Visual Studio offline telepítésének létrehozása
• Visual Studio telepítésének automatizálása válaszfájllal
• Visual Studio feladatköreit és összetevőazonosítóit