Példa parancssori paraméterre a Visual Studio telepítéséhez

Ha be szeretné szemléltetni, hogyan parancssori paraméterekkel telepíteni a Visual Studio, íme néhány példa, amelyeket testre szabhat az igényeinek megfelelően.

Minden példában vs_enterprise.exe, vs_professional.exeés vs_community.exe a Visual Studio bootstrapper megfelelő kiadását jelölik, amely a letöltési folyamatot kezdeményező kis (~ 1 MB) fájl. Ha másik kiadást használ, cserélje le a megfelelő bootstrapper-nevet.

Rendszergazdai jogosultság szükséges minden parancshoz, és megjelenik egy felhasználói fiókvezérlés kérése, ha a folyamat nem rendszergazdai jogosultsági szintű parancssorból indul el.

A parancssor végén található ^ karakterrel több sort egyesíthet egyetlen parancsba. Azt is megteheti, hogy ezeket a sorokat egyetlen sorba helyezi. A PowerShellben ennek megfelelője a backtick (`) karakter.

Ha nem interaktív módon szeretne parancsokat végrehajtani, használhatja--passive vagy --quiet. Ezekről a paraméterekről további információt a parancsok és a parancssori paraméterek oldalán talál.

A parancssor használatával telepíthető számítási feladatok és összetevők listáját a Visual Studio számítási feladatainak és összetevőazonosítóinak lapján találja.

Telepítés --installPath és --add használatával a bootstrapper mellett

• Telepítse a Visual Studio minimális példányát interaktív kérések nélkül, de a folyamat az alábbiak szerint jelenik meg:

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

• Telepítse csendesen a Visual Studio asztali példányát a francia nyelvi csomaggal, amely csak akkor tér vissza, ha a termék telepítve van.

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

Frissít

• Frissítsen egy Visual Studio-példányt parancssor használatával, miközben az előrehaladás megjelenik és nincsenek interaktív kérések. Ezeket a parancssorozatokat két lépésben futtathatja az ügyfélen vagy egy elrendezésben található bootstrapper használatával. Az első parancs frissíti a telepítőt az ügyfélen, a második parancs pedig frissíti a Visual Studio-terméket. Ezeket a parancsokat rendszergazdai jogú parancssorban kell futtatnia, mert a telepítő frissítéséhez rendszergazdai engedélyekre van szükség. Az alábbi példa egy ügyfél frissítését szimulálja egy örökzöld bootstrapper használatával az elrendezésben.

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

  Egy másik lehetőségként azt is megteheti, hogy egy lépésben frissíti a Visual Studio programtelepítést a helyi telepítő használatával. Vegye figyelembe, hogy a telepítő programozott módon nem indítható el ugyanabból a könyvtárból, amelyben a telepítő található.

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

  Standard felhasználók, ha megfelelő engedélyeket kaptak, programozott módon végrehajthatják a frissítési parancsot a telepítővel, de nem használhatják a --passive vagy --quiet kapcsolót.

A --wait használata

• A --wait kötegelt fájlokban vagy szkriptekben való használatával megvárhatja, amíg a kezdeti parancs befejeződik, mielőtt a következő parancs végrehajtásra kerül. Kötegelt fájlok esetén egy %ERRORLEVEL% környezeti változó tartalmazza a parancs visszatérési értékét, ahogyan az a Parancssori paraméterek használata a Visual Studio oldal telepítéséhez című cikkben található. Egyes parancs-segédprogramok más paramétereket igényelnek a befejezésre való várakozáshoz és a telepítő visszatérési értékének lekéréséhez.

  A --wait paramétert csak a rendszerindító támogatja.

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

  Az alábbi parancs a --wait és a PowerShell-szkript parancs Start-Processhasználatának egy példája:

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

  vagy

    $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()
  

• Az első --wait a Visual Studio bootstrappere használja, a második -Wait pedig a "Start-Process" használja a befejezésre való várakozáshoz. A -PassThru paramétert a Start-Process használja a telepítő kilépési kódjának a visszatérési értékéhez.

Hálózati elrendezés vagy helyi gyorsítótár létrehozása a --layout használatával

• Hozzon létre egy olyan elrendezést, amely csak a Visual Studio alapszerkesztőt (a legkisebb Visual Studio-konfigurációt) és az angol nyelvi csomagot tartalmazza. További elrendezés-létrehozási példák a A Visual Studio hálózati telepítésének létrehozása lapon találhatók.

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

A --all használata a teljes termék beszerzéséhez

• Indítsa el a Visual Studio Enterprise kiadásban elérhető összes számítási feladat és összetevő interaktív telepítését:

  vs_enterprise.exe --all
  

A --includeRecommended használata

• Telepítse a Visual Studio Professional második példányát egy becenévvel egy olyan gépen, amelyen már telepítve van a Visual Studio Community kiadás, és támogatja Node.js fejlesztést:

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

A --channelURI használata

A legújabb telepítőhasználatával konfigurálhatja, hogy a Visual Studio hol keres frissítéseket. A --channelUri más néven frissítési csatorna vagy a frissítések forráshelye. Az alábbi táblázat példaértékeket tartalmaz a channelId és a channelUri értékekhez, valamint azok jelentéseihez.

csatornanév	--channelUri	--channelId
Visual Studio 2026 Stabil csatorna	https://aka.ms/vs/stable/channel	VisualStudio.18.Stable
Visual Studio 2026 Insider-csatorna	https://aka.ms/vs/insiders/channel	VisualStudio.18.Insiders
Visual Studio 2022 Aktuális csatorna	https://aka.ms/vs/17/release/channel	VisualStudio.17.Release
Visual Studio 2022 17.0 LTSC-csatorna	https://aka.ms/vs/17/release.LTSC.17.0/channel	VisualStudio.17.Release.LTSC.17.0
Visual Studio 2022 előzetes verziójú csatorna	https://aka.ms/vs/17/pre/channel	VisualStudio.17.Preview
Visual Studio 2019 Kiadási csatorna	https://aka.ms/vs/16/release/channel	VisualStudio.16.Release
Visual Studio 2017 Kiadási csatorna	https://aka.ms/vs/15/release/channel	VisualStudio.15.Release
Egyéni elrendezés – Privát csatorna	\\layoutserver\share\path\channelmanifest.json	VisualStudio.17.Release (vagy bármi, amire az elrendezés alapult)

Ha egyéni elrendezést használ frissítési csatornaként, vegye figyelembe az alábbi irányelveket:

• Az --channelUri-nak az egyéni elrendezésben lévő „channelmanifest.json” fájlra kell mutatnia.
• A rendszergazdák az ügyfél beállításjegyzék-beállításainak konfigurálásával konfigurálhatják, hogy a "Privát csatorna" egyéni elrendezés hogyan jelenjen meg a Frissítési beállítások felhasználói felületén.

A --remove használata

• Távolítsa el a Profiling Tools összetevőt az alapértelmezett telepített Visual Studio-példányból. Ez a példa az ügyfélszámítógépen már telepített telepítőt használja. a megfelelő engedélyekkel rendelkező standard felhasználók programozott módon végrehajthatják a módosítási parancsot a telepítővel, de nem használhatják a --passive vagy --quiet kapcsolót. Vegye figyelembe, hogy a telepítő programozott módon nem indítható el ugyanabból a könyvtárból, amelyben a telepítő található.

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

A --remove nem használható ugyanabban a parancsban, mint --layout. Más szóval nem lehet eltávolítani az összetevőket az elrendezésből.

A --removeOos parancs használata

A legújabb telepítőhasználatával módosíthatja a telepítést, és eltávolíthatja az összes olyan összetevőt, amely az alapértelmezett telepített Visual Studio-példányból nem támogatott állapotba váltott. Ez a példa az ügyfélszámítógépen már telepített telepítőt használja a removeOos beállítás konfigurálásához. Standard felhasználók, ha megfelelő engedélyeket kaptak, programozott módon végrehajthatják a módosítási parancsot a telepítővel, de nem használhatják a --passive vagy --quiet kapcsolót. A telepítő programozott módon nem indítható el ugyanabból a könyvtárból, amelyben a telepítő található.

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

• Módosítsa a frissítési beállításokat, hogy a termék minden frissítésekor tartósan eltávolítson minden olyan összetevőt, amely nem támogatott állapotba vált:

  "C:\Program Files (x86)\Microsoft Visual studio\Installer\setup.exe" modify ^
  --channelURI https://aka.ms/vs/stable.18.0/channel ^
  --productID Microsoft.VisualStudio.Product.Enterprise ^
  --newChannelURI \\layoutserver\share\path\channelmanifest.json ^
  --removeOos true ^
  --quiet  
  

A --path használata

Az alábbi példák mindegyike feltételezi, hogy egy új terméket telepít egy bootstrapper használatával.

• Használja a telepítési, gyorsítótárazási és megosztott elérési utakat:

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

• Csak a telepítési és gyorsítótár-elérési utakat használja:

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

• Csak a telepítési és megosztott elérési utakat használja:

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

• Csak a telepítési útvonalat használja:

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

Exportálás használata

• Az exportálással mentheti a kijelölést egy telepítésből. Ez a példa az ügyfélszámítógépen már telepített telepítőt használja.

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

• Az exportálás segítségével a nulláról mentheti az egyéni kijelölést. Ez a példa az ügyfélszámítógépen már telepített telepítőt használja.

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

A --config opció használata

• A --config használatával telepítheti a számítási feladatokat és összetevőket egy korábban mentett telepítési konfigurációs fájlból:

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

• A --config használatával számítási feladatokat és összetevőket adhat hozzá egy meglévő telepítéshez. Ez a példa az ügyfélszámítógépen már telepített telepítőt használja. a megfelelő engedélyekkel rendelkező standard felhasználók programozott módon végrehajthatják a módosítási parancsot a telepítővel, de nem használhatják a --passive vagy --quiet kapcsolót. A telepítő programozott módon nem indítható el ugyanabból a könyvtárból, amelyben a telepítő található.

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

• Az elrendezés tartalmának konfigurálásához használja a --config parancsot:

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

A winget használata

A Windows Package Manager "winget" eszközzel programozott módon telepítheti vagy frissítheti a Visual Studiót a gépeken, valamint a winget által felügyelt többi csomaggal együtt. A telepítés testreszabásához és más számítási feladatok és összetevők megadásához használhatja a Winget --override kapcsolóját a Winget install parancsával együtt, és átadhat egy exportált vsconfig-fájlt, így:

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

Egy meglévő Visual Studio-telepítés módosításához használhatja a winget configure, valamint átadhat egy .yaml fájlt. Ez a megközelítés a Visual Studio PowerShell DSC-szolgáltatót használja, amely itt dokumentálva.

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

Néha a dolgok elromlhatnak. Ha a Visual Studio telepítése sikertelen, nézze meg a A Visual Studio telepítési és frissítési problémáinak elhárítása részletes útmutatóját lépésről lépésre.

Í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 rendszergazdai útmutatója
• A Visual Studio telepítése parancssori paraméterekkel
• Visual Studio hálózati telepítésének létrehozása
• Visual Studio munkaterhelései és komponensazonosítói