Visual Studio 安裝的命令列參數範例

發行項
10/14/2024

為了說明如何使用命令列參數安裝 Visual Studio，以下是幾個範例，您可以自訂以符合您的需求。

在每個範例中，vs_enterprise.exe、vs_professional.exe 和 vs_community.exe 表示 Visual Studio 啟動程序的個別版本，這是起始下載程序的小型檔案 (~ 1MB)。如果您使用不同的版本，請取代為適當的啟動程序名稱。

所有命令都需要提升系統管理權限，如果未從已提升權限的提示字元啟動程序，則會顯示 [使用者帳戶控制] 提示。

您可以在命令列結尾處使用 ^ 字元，將多行串連成單一命令。或者，您可以將這幾行放到一列。在 PowerShell 中，對等項目為倒引號 (`) 字元。

如需您可以使用命令列安裝的工作負載和元件的清單，請參閱 Visual Studio 工作負載和元件識別碼頁面。

使用 --installPath 和 --add 與啟動載入器一起安裝

安裝 Visual Studio 的最小執行個體，不會顯示互動式提示，但會顯示進度：

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

使用法文語言套件以無訊息方式安裝 Visual Studio 的桌面執行個體，並只在安裝產品時傳回。

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

更新

使用命令列更新 Visual Studio 執行個體，顯示進度但不顯示互動式提示。您可以使用在用戶端或配置中找到的啟動程序，以兩個步驟中執行這些系列的命令。第一個命令會更新用戶端上的安裝程式，而第二個命令會更新 Visual Studio 產品。您必須在提升權限的命令提示字元中執行這些命令，因為更新安裝程式需要系統管理員權限。下列範例會模擬在配置中使用常駐啟動程序來更新用戶端。
```
\\layoutserver\share\path\vs_enterprise.exe --update --quiet --wait
\\layoutserver\share\path\vs_enterprise.exe update --wait --passive --norestart --installPath "C:\installPathVS"
```

或者，您也可以使用用戶端上的安裝程式，在一個步驟中更新 Visual Studio 執行個體。標準使用者若已獲授與適當的權限，可以使用安裝程式以程式設計方式執行更新命令，但不允許使用 --passive 或 --quiet 參數。請注意，您無法以程式設計方式從安裝程式所在的同一個目錄起始安裝程式。

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

使用 --wait

在批次檔或指令碼中使用 --wait，以等候初始命令完成，然後再執行下一個命令。針對批次檔，%ERRORLEVEL% 環境變數會包含命令的傳回值，如使用命令列參數安裝 Visual Studio 頁面中所述。有些命令公用程式需要其他參數來等候完成，以及取得安裝程式的傳回值。

只有啟動程序才支援 --wait 參數。

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

下列命令是使用 --wait 搭配 PowerShell 指令碼命令 Start-Process 的範例：

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

或

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

第一個 --wait 會由 Visual Studio 啟動程序所使用，而第二個 -Wait 會由 'Start-Process' 用來等候完成。 -PassThru 參數是 Start-Process 用來使用安裝程式的結束代碼做為其傳回值。

使用 --layout 建立網路配置或本機快取

建立只包含 Visual Studio 核心編輯器的配置 (最少的 Visual Studio 組態) 和英文語言套件。如需更多配置建立範例，請參閱建立 Visual Studio 的網路安裝頁面。
```
vs_professional.exe --layout "C:\VS" ^
--lang en-US ^
--add Microsoft.VisualStudio.Workload.CoreEditor ^
```

使用 --all 來取得整個產品

啟動 Visual Studio Enterprise 版中可用的所有工作負載和元件互動式安裝：
```
vs_enterprise.exe --all
```

使用 --includeRecommended

使用暱稱在已安裝 Visual Studio Community 版並支援 Node.js 開發的電腦上安裝第二個 Visual Studio Professional 的執行個體：
```
vs_professional.exe --installPath C:\VSforNode ^
--add Microsoft.VisualStudio.Workload.Node --includeRecommended --nickname VSforNode
```

使用 --channelURI

使用最新的安裝程式，即可設定 Visual Studio 尋找更新的位置。否則 --channelUri 為更新通道或更新的來源位置。下表提供 channelId 和 channelUri 的範例值及其意義。

通道名稱	--channelUri	--channelId
Visual Studio 2022 目前通道	`https://aka.ms/vs/17/release/channel`	`VisualStudio.17.Release`
Visual Studio 2022 17.0 LTSC 通道	`https://aka.ms/vs/17/release.LTSC.17.0/channel`	`VisualStudio.17.Release.LTSC.17.0`
Visual Studio 2022 預覽通道	`https://aka.ms/vs/17/pre/channel`	`VisualStudio.17.Preview`
Visual Studio 2019 發行通道	`https://aka.ms/vs/16/release/channel`	`VisualStudio.16.Release`
Visual Studio 2017 發行通道	`https://aka.ms/vs/15/release/channel`	`VisualStudio.15.Release`
自訂配置 - 私人通道	`\\layoutserver\share\path\channelmanifest.json`	`VisualStudio.17.Release` (或任何根據的配置)

如果您選擇使用自訂配置作為更新通道，請注意下列指導方針：

--channelUri 必須在自訂配置中指向 'channelmanifest.json' 檔案。
系統管理員可以設定用戶端的登錄設定，以設定自訂配置「私人通道」在更新設定 UI 中的顯示方式。

使用 --remove

從預設安裝的 Visual Studio 執行個體移除分析工具元件。此範例會使用已安裝在用戶端電腦上的安裝程式。標準使用者若有適當的權限，可以使用安裝程式以程式設計方式執行修改命令，但不允許使用 --passive 或 --quiet 參數。請注意，您無法以程式設計方式從安裝程式所在的同一個目錄起始安裝程式。
```
"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
```

您無法在與 --remove 相同的命令中使用 --layout。換句話說，您無法從配置中移除元件。

使用 --removeOos

使用最新的安裝程式，您可以修改安裝，並從預設安裝的 Visual Studio 執行個體中移除所有已轉換為不支援狀態的元件。此範例會使用已安裝在用戶端電腦上的安裝程式來設定 removeOos 設定。標準使用者若已獲授與適當的權限，可以使用安裝程式以程式設計方式執行修改命令，但不允許使用 --passive 或 --quiet 參數。您無法以程式設計方式從安裝程式所在的同一個目錄起始安裝程式。

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

調整更新設定，以在每次產品更新時，一致地移除已轉換為不再支援狀態的所有元件：

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

使用 --path

所有這些範例都假設您正在使用啟動程序來安裝新產品。

使用安裝、快取和共用路徑：

vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache" --path shared="C:\VS\shared"
只使用安裝和快取路徑：

vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path cache="C:\VS\cache"
只使用安裝和共用路徑：

vs_enterprise.exe --add Microsoft.VisualStudio.Workload.CoreEditor --path install="C:\VS" --path shared="C:\VS\shared"
只使用安裝路徑：

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

使用 export

使用匯出可儲存來自安裝的選取項目。此範例會使用已安裝在用戶端電腦上的安裝程式。

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

使用匯出可從頭開始儲存自訂選取項目。此範例會使用已安裝在用戶端電腦上的安裝程式。

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

使用 --config

使用 --config 可從先前儲存的安裝組態檔安裝工作負載和元件：
```
vs_enterprise.exe --config "C:\my.vsconfig" --installPath "C:\VS"
```
使用 --config 可將工作負載和元件新增至現有的安裝。此範例會使用已安裝在用戶端電腦上的安裝程式。標準使用者若有適當的權限，可以使用安裝程式以程式設計方式執行修改命令，但不允許使用 --passive 或 --quiet 參數。您無法以程式設計方式從安裝程式所在的同一個目錄起始安裝程式。
```
"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modify --installPath "C:\VS" --config "C:\my.vsconfig"
```

使用 --config 來設定配置的內容：

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

使用 winget

使用 Windows 封裝管理員 "winget" 工具，以程式設計方式在機器上安裝或更新 Visual Studio，以及其他由 winget 管理的封裝。若要自訂安裝並指定其他工作負載和元件，您可以使用 winget 的 --override 參數與 winget 的 install 命令，並傳入匯出的 vsconfig 檔案，如下所示：

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

您也可以使用 winget configure 並傳入 .yaml 檔案來修改現有的 Visual Studio 安裝。此方法會使用這裡記載的 Visual Studio PowerShell DSC 提供者。

支援或疑難排解

有時可能會發生一些問題。若 Visual Studio 安裝失敗，請參閱針對 Visual Studio 安裝和升級問題進行疑難排解，以取得逐步指導方針。

以下是一些支援選項：

針對安裝相關問題，請使用安裝聊天（僅限英文）支持選項。
使用問題報告工具，來回報產品問題，此工具會出現在 Visual Studio Installer 和 Visual Studio IDE 中。如果您是 IT 系統管理員且未安裝 Visual Studio，則可以提交 IT 系統管理員意見反應。
在 Visual Studio 開發人員社群 \(英文\) 中建議功能、追蹤產品問題和尋找解答。

共用方式為

Visual Studio 安裝的命令列參數範例

使用 --installPath 和 --add 與啟動載入器一起安裝

更新

使用 --wait

使用 --layout 建立網路配置或本機快取

使用 --all 來取得整個產品

使用 --includeRecommended

使用 --channelURI

使用 --remove

使用 --removeOos

使用 --path

使用 export

使用 --config

使用 winget

支援或疑難排解

意見反應

其他資源

共用方式為

Visual Studio 安裝的命令列參數範例

使用 --installPath 和 --add 與啟動載入器一起安裝

更新

使用 --wait

使用 --layout 建立網路配置或本機快取

使用 --all 來取得整個產品

使用 --includeRecommended

使用 --channelURI

使用 --remove

使用 --removeOos

使用 --path

使用 export

使用 --config

使用 winget

支援或疑難排解

相關內容

意見反應

其他資源