將 Visual Studio 從配置部署到用戶端電腦
📣我們非常希望聽到您的意見反應！請花一點時間完成這份問卷，告訴我們如何改進版面配置體驗。感謝您的支持！
若要將配置部署到用戶端電腦，您必須先考慮下列主題：
- 準備配置：請確定您的配置已準備好安裝到用戶端。
- 準備用戶端電腦：請確定您的用戶端電腦已準備好安裝 Visual Studio，且您的使用者具有正確的權限。
- 在用戶端電腦上設定全域原則：控制其他 Visual Studio 安裝、更新、通知和下載行為。
- 設定初始用戶端安裝預設值：使用自訂設定來初始化用戶端的安裝。
- 執行定期更新：讓您的用戶端電腦保持更新且安全。
從配置將 Visual Studio 安裝到用戶端電腦
系統管理員可以程式設計的方式將 Visual Studio 配置作為安裝指令碼的一部分部署到用戶端工作站。
從網路配置安裝
具有系統管理員權限的使用者可以執行下列命令，從自動模式的網路配置安裝 Visual Studio。 配置中的 response.json 提供安裝的預設組態設定。
\\server\products\VS\vs_enterprise.exe --quiet --wait
如果使用者選取了在配置中無法使用的專案，則安裝程式會嘗試在網際網路上從 Microsoft 主控伺服器取得這些額外的檔案。 若要確定您的安裝程式在安裝產品時不會嘗試存取網際網路，請使用 --noweb 參數。 例如，使用此命令來執行安裝，並防止用戶端電腦存取網際網路：
\\server\products\VS\vs_enterprise.exe --noWeb --wait --passive --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Workload.NetWeb --includeOptional
注意
請耐心等候。 請確定您已針對安裝程式和產品 --wait 以完成。 從配置安裝或更新用戶端時，安裝程式一律是安裝或更新的首要事項，然後 Visual Studio 產品本身就會安裝或更新。 這兩個程序都需要完成，才能視為成功的更新。
在自動批次檔中執行安裝或更新時，--wait 選項有助於確保 vs_enterprise.exe 程序先等到安裝完成後，再傳回結束代碼。 若企業系統管理員想要在完成的安裝上執行進一步的動作時，此選項非常有用，例如，將產品金鑰套用到成功的安裝。 使用 --wait 選項可防止後續作業過早啟動。 如果您未使用 --wait，則 vs_enterprise.exe 程序可能會在安裝兩個部分完成之前結束，因此會傳回未代表安裝作業狀態的不正確結束代碼。
從內部內部網路位置安裝
有些企業想要在內部網路位置上裝載配置，以更妥善管理地理效能瓶頸，並利用 Web 快取。 若要將內部網路裝載的配置部署到用戶端電腦上，具有系統管理員權限的使用者必須執行提升權限的 PowerShell 指令碼 (如下所示)，才能初始化用戶端電腦上的安裝。
#Do the initial installation from the web hosted layout onto the client in an elevated PowerShell script
#ADMIN CONFIGURATION
#Enter layout URI here
$LayoutUri = "http://MyCompanyIntranetSite/VS2022Enterprise/"
#Enter bootstrapper name which is present in layout.
$BootstrapperName = "vs_Enterprise.exe"
#Add any arguments which you intend to send to bootstrapper.
$Arguments = "--passive --wait"
#SCRIPT FUNCTIONALITY
#Forming URI for bootstrapper
Write-Verbose "LayoutUri: $LayoutUri"
$BootstrapperUri = "$LayoutUri/$BootstrapperName"
Write-Verbose "BootstrapperUri: $BootstrapperUri"
$Arguments += " --layoutUri $LayoutUri"
Write-Verbose "Arguments: $Arguments"
#Creating temp folder and download bootstrapper
$VSLayoutFolderPath = Join-Path -Path $env:TEMP -ChildPath VSLayout
$BootstrapperFile = Join-Path -Path $VSLayoutFolderPath -ChildPath $BootstrapperName
Write-Verbose "The bootstrapper path is: $BootstrapperFile"
if (Test-Path $VSLayoutFolderPath)
{
Write-Verbose "The directory exists - $VSLayoutFolderPath"
if (Test-Path $BootstrapperFile)
{
Write-Verbose "Deleting file - $BootstrapperFile"
Remove-Item $BootstrapperFile
}
}
else
{
Write-Verbose "Creating folder - $VSLayoutFolderPath"
New-Item -ItemType Directory -Path $VSLayoutFolderPath
}
Write-Verbose "Downloading bootstrapper from - $BootstrapperUri to $BootstrapperFile"
Invoke-WebRequest -Uri $BootstrapperUri -OutFile $BootstrapperFile
Write-Verbose "Starting bootstrapper -$BootstrapperFile with arguments $Arguments"
start-process $BootstrapperFile $Arguments
準備用戶端電腦
權限
請確定執行安裝的使用者或系統帳戶可以適當存取包含配置的網路共用。 如需詳細資訊，請參閱對安裝或使用 Visual Studio 時所發生的網路相關錯誤進行疑難排解頁面。
在沒有網際網路存取權的用戶端上進行安裝
您必須確定所有離線用戶端電腦都已安裝正確的憑證。
當您從配置安裝時，用戶端上的安裝程式一律會尋找配置位置中的 Visual Studio 套件。 不過，如果安裝程式嘗試安裝配置中未包含的元件，則會嘗試從更新來源取得 Visual Studio 套件，系統管理員通常會將其設定為指向本身。
如果您想要明確防止 Visual Studio 安裝程式嘗試在 Web 上從 Microsoft 裝載的伺服器下載任何遺漏的內容，可以使用 --noWeb 參數。 如果使用 --noWeb，而且配置遺失已選取要安裝的元件，則安裝程式會失敗。 此外，如果使用 --noWeb 且配置裝載於內部網路網頁伺服器上，而不是檔案網路共用，則安裝程式將會失敗。
使用 --noweb 參數通常會修正錯誤訊息：「找不到符合下列參數的產品」。
機器資源
確定您的完整安裝路徑少於 80 個字元，且您的電腦具有充足的儲存體。 Visual Studio 的完整安裝至少需要 45 -50 GB 的磁碟空間。
錯誤碼
如果已使用 --wait 參數，則會根據作業的結果，將 %ERRORLEVEL% 環境變數設定為下列其中一個值：
| 值 | 結果 |
|---|---|
| 0 | 作業成功完成 |
| 740 | 需要提高權限 |
| 1001 | Visual Studio 安裝程式處理序正在執行 |
| 1003 | Visual Studio 正在使用中 |
| 1602 | 作業已取消 |
| 1618 | 另一個安裝正在執行 |
| 1641 | 作業已成功完成，並已初始重新開機 |
| 3010 | 作業成功完成，但安裝需要重新開機才能使用 |
| 5003 | 啟動載入器無法下載安裝程式 |
| 5004 | 作業已取消 |
| 5005 | 啟動載入器命令列剖析錯誤 |
| 5007 | 作業已封鎖 - 電腦不符合需求 |
| 8001 | Arm 電腦檢查失敗 |
| 8002 | 背景下載前置檢查失敗 |
| 8003 | 終止支援可選取的失敗 |
| 8004 | 目標目錄失敗 |
| 8005 | 驗證來源承載失敗 |
| 8006 | Visual Studio 處理序正在執行 |
| 8010 | 不支援作業系統。 請參閱系統需求 |
| -1073720687 | 連線失敗 |
| -1073741510 | Microsoft Visual Studio 安裝程式已由使用者或外部處理序終止 |
| 其他 (例如： -1、1、1603) |
發生失敗狀況 - 請檢查記錄檔以取得詳細資訊 |
取得部署配置的支援
如果您在用戶端電腦上部署配置時遇到問題，我們需要了解這些問題。 最好的方式是使用 Visual Studio 安裝程式及 Visual Studio IDE 中的 [回報問題] 工具來聯繫我們。 如果您是 IT 管理員且未安裝 Visual Studio，您可以在這裡提交 IT 管理員意見反應。 當您使用此工具時，如果可以透過 VS Collect 工具傳送記錄，將會很有幫助，可協助我們診斷並修正問題。
我們也提供安裝聊天 (僅限英文) 支援選項，可回答安裝的相關問題。
我們也提供其他支援選項。 請參閱我們的 Visual Studio 開發人員社群。