將 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 程序可能會在安裝的兩個部分都完成之前結束，因此它會傳回一個不準確的結束代碼，無法準確代表安裝作業的狀態。
從內部內部網路位置安裝
有些企業希望將佈局部署於內部網路，以更妥善地管理地理效能瓶頸，並充分利用網頁快取。 若要將內部網路裝載配置部署到用戶端計算機上，具有系統管理員許可權的用戶必須執行提升許可權的 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 安裝程式嘗試從 Microsoft 托管在 web 上的伺服器下載任何遺漏的內容，您可以使用 --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 開發人員社群。