使用最小離線版面配置來更新 Visual Studio
對於未連線到網際網路的電腦，建立最小版面配置是更新離線 Visual Studio 執行個體最簡單且最快的方式。
最小版面配置工具會產生專為小組需求量身打造的版面配置。 企業系統管理員可以使用此工具為大多數版本的 Visual Studio (包括 Visual Studio 2017) 建立更新版面配置。 不同於完整的 Visual Studio 版面配置，最小版面配置只會包含更新的套件，因此產生和部署一律會更小、更快。 您可以僅指定所需的語言、工作負載和元件，進一步將更新版面配置的大小降到最低。
如何產生最小版面配置
重要
這些指示假設您先前已建立及使用過版面配置。 如需如何執行這項操作的詳細資訊，請參閱更新 Visual Studio 的網路型安裝頁面。
如需進一步了解 Visual Studio 生命週期，請參閱 Visual Studio 產品生命週期和服務頁面。
此工具會建立 Visual Studio 2017 (15.9) 和更新版本的更新版面配置。 版面配置可以部署到網路/離線電腦，以更新 Visual Studio 執行個體。 在一般版面配置建立期間，會下載該特定版本的所有套件。 需要建立一般版面配置，才能在 Visual Studio 執行個體上進行修復、解除安裝和其他標準作業。 最小版面配置只會下載更新的套件，因此更小且更容易複製到離線電腦。
安裝最小版面配置工具
首先，下載位於此處的最小版面配置工具。 當出現提示時，請務必選擇 [儲存]，然後選取 [執行]。
接下來，按一下 [是]，以接受 [使用者帳戶控制] 提示。
最小版面配置工具會安裝到
C:\Program Files (x86)\Microsoft Visual Studio\MinimalLayout。
如何使用最小版面配置工具
MinimalLayout.exe 會使用下列命令和選項來產生版面配置。 執行此工具至少需要一個命令。 以下是執行工具的方式：
MinimalLayout.exe [command] <options>...
命令
預覽：使用此命令來預覽將要下載的套件數量，以及用來建立此版面配置的空間總計。
產生：使用此命令來產生更新 Visual Studio 的最小版面配置。
重新產生：使用此命令以使用現有的最小版面配置回應檔重新產生版面配置。 每個最小版面配置都會產生
MinimalLayout.json回應檔，其中包含原始最小版面配置輸入參數。 您可以使用重新產生命令和MinimalLayout.json回應檔來重新產生最小版面配置。 如果您想要根據先前的最小版面配置回應檔，為新的 Visual Studio 更新建立最小版面配置，這會很有用。針對此命令，需要來自已產生版面配置的
MinimalLayout.json檔案路徑。MinimalLayout.exe regenerate --filePath C:\MinimalLayout\MinimalLayout.json確認：使用此命令來判斷版面配置資料夾是否已損毀。
修正：使用此命令來修正損毀的版面配置資料夾，包括取代版面配置資料夾中的任何遺漏套件。
選項。
| 選項。 | 描述 | 必要/選用 | 範例 |
|---|---|---|---|
| --targetLocation <dir> | 指定要在其中建立最小離線版面配置的目錄。 | 必要 | --targetLocation c:\VSLayout\ |
| --baseVersion <版本> | 從此版本開始產生最小離線版面配置。 | 必要 | --baseVersion 16.4.0 |
| --targetVersion <版本> | 最小離線版面配置最多會產生包含此版本。 | 必要 | --targetVersion 16.4.4 |
| --languages | 指定要包含在最小離線版面配置中的語言。 您可以指定多個值，以空格分隔。 | 必要 | --languages en-US fr-FR |
| --productIds <一或多個產品識別碼> | 要從中產生最小離線版面配置的產品識別碼，以逗號分隔。
|
必要 | --productIds Microsoft.VisualStudio.Product.Enterprise,Microsoft.VisualStudio.Product.Professional |
| --filePath | 來自已建立版面配置之 MinimalLayout.json 檔案的檔案路徑。 此選項只會與「重新產生」命令搭配使用。 | 重新產生命令的必要項目 | --filePath C:\VSLayout\minimalLayout.json 請注意，重新產生命令只會採用 --filePath 作為選項。 |
| --add <一或多個工作負載或元件識別碼> | 指定一或多個要新增的工作負載或元件識別碼。 可以全域新增額外元件，使用 --includeRecommended 和/或 –-includeOptional。 您可以指定多個工作負載或元件識別碼，以空格分隔。 |
選擇性 | --add Microsoft.VisualStudio.Workload.ManagedDesktop Microsoft.VisualStudio.Workload.NetWeb Component.GitHub.VisualStudio |
| --includeRecommended | 包含所安裝任何工作負載的建議元件，但不包含選擇性元件。 | 選擇性 | 針對特定工作負載： --add Microsoft.VisualStudio.Workload。 ManagedDesktop;includeRecommended 若要套用至所有工作負載：--includeRecommended |
| --includeOptional | 包含所安裝任何工作負載的選擇性元件，包含建議元件。 | 選擇性 | 針對特定工作負載： --add Microsoft.VisualStudio.Workload。 ManagedDesktop;includeOptional 若要套用至所有工作負載：--includeOptional |
產生最小版面配置
重要
這些指示假設您先前已建立網路安裝版面配置。 如需如何執行這項操作的詳細資訊，請參閱建立 Visual Studio 的網路安裝頁面。
使用產生命令為您的指定版本範圍建立最小版面配置。 您也必須知道產品識別碼、語言，以及所需的任何特定工作負載。 此最小版面配置會從基底版本更新至包括目標版本在內的任何 Visual Studio 執行個體。
建立版面配置之前，您可以使用預覽命令來找出下載的大小總計和包含的套件數目。 此命令會採用與產生命令相同的選項，並將詳細資料寫入主控台。
讓我們逐步解說一些如何預覽、產生和重新產生最小版面配置的範例：
首先，以下範例說明如何預覽僅限英文版 Visual Studio Enterprise 16.4.0 至 16.4.4 版的版面配置。
MinimalLayout.exe preview --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --languages en-US以下說明如何使用一個工作負載來產生相同的版面配置。
MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeOptional --languages en-US以下說明使用現有回應檔重新產生最小離線版面配置。
MinimalLayout.exe regenerate --filepath c:\VSLayout\MinimalLayout.json
使用產生命令的一些其他範例：
以下說明如何新增額外的工作負載，並只包含建議的套件。
MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Professional --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop Microsoft.VisualStudio.Workload.NetWeb;includeRecommended --languages en-US您也可以產生支援多個產品的最小離線版面配置。
MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise,Microsoft.VisualStudio.Product.Professional --baseVersion 16.4.0 --targetVersion 16.4.4 --languages en-US最後，以下說明如何在最小版面配置中包含多種語言。
MinimalLayout.exe generate --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeOptional --languages en-US fr-FR
如何維護最小版面配置
使用確認和修正命令，在建立之後維護您的最小版面配置。 確認命令會判斷最小版面配置中是否有任何損毀或遺失的套件。 如果您在執行確認命令之後遇到任何問題，請使用修正命令來更正遺失或損毀的套件。
以下說明如何確認版面配置是否損毀或遺失套件：
MinimalLayout.exe Verify --targetLocation c:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop --includeRecommended --languages en-US以下說明如何修正該版面配置：
MinimalLayout.exe fix --targetLocation C:\VSLayout\ --productIds Microsoft.VisualStudio.Product.Enterprise --baseVersion 16.4.0 --targetVersion 16.4.4 --add Microsoft.VisualStudio.Workload.ManagedDesktop;includeRecommended --languages en-US
注意
此版面配置無法用來修復 Visual Studio 安裝。 若要修復現有的 Visual Studio 執行個體，請參閱修復 Visual Studio。
如何使用最小離線版面配置來更新現有的 Visual Studio 安裝
產生最小版面配置之後，您可以將整個最小版面配置資料夾複製到用戶端電腦。 如果電腦無法存取其原始位置中的最小版面配置資料夾，則這是必要項目。
瀏覽至資料夾並識別啟動載入器應用程式名稱。 啟動載入器應用程式的名稱取決於產生最小版面配置時所指定的 ProductId 值。 如需常見範例，請參閱下表。
| ProductId 值 | 應用程式名稱 |
|---|---|
| Microsoft.VisualStudio.Product.Enterprise | vs_enterprise.exe |
| Microsoft.VisualStudio.Product.Professional | vs_professional.exe |
| Microsoft.VisualStudio.Product.BuildTools | vs_buildtools.exe |
更新會在兩個步驟中套用至 Visual Studio 執行個體。 從更新 Visual Studio 安裝程式開始，然後更新 Visual Studio。
更新 Visual Studio 安裝程式
執行下列命令，視需要以正確的啟動載入器應用程式名稱取代
vs_enterprise.exe。vs_enterprise.exe --quiet --update --offline C:\VSLayout\vs_installer.opc更新 Visual Studio 應用程式
若要更新 Visual Studio，您必須指定您想要更新之 Visual Studio 執行個體的 installPath。 如果已安裝多個 Visual Studio 執行個體，則必須個別更新每個執行個體。 強烈建議您使用更新命令指定
–noWeb選項，以避免安裝不在最小版面配置中的元件。 這可防止您將 Visual Studio 保持為無法使用的狀態。執行下列命令，適當地取代 installPath 命令列參數。 請務必使用正確的啟動載入器應用程式名稱。
vs_enterprise.exe update --noWeb --quiet --installpath "C:\Program Files (x86)\Microsoft Visual Studio\2019\Enterprise"
更新 Visual Studio 安裝程式
執行下列命令，視需要以正確的啟動載入器應用程式名稱取代
vs_enterprise.exe。vs_enterprise.exe --quiet --update --offline C:\VSLayout\vs_installer.opc更新 Visual Studio 應用程式
若要更新 Visual Studio，您必須指定您想要更新之 Visual Studio 執行個體的 installPath。 如果已安裝多個 Visual Studio 執行個體，則必須個別更新每個執行個體。 強烈建議您使用更新命令指定
–noWeb選項，以避免安裝不在最小版面配置中的元件。 這可防止您將 Visual Studio 保持為無法使用的狀態。執行下列命令，適當地取代 installPath 命令列參數。 請務必使用正確的啟動載入器應用程式名稱。
vs_enterprise.exe update --noWeb --quiet --installpath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise"
支援或疑難排解
有時可能會發生一些問題。 若 Visual Studio 安裝失敗，請參閱針對 Visual Studio 安裝和升級問題進行疑難排解，以取得逐步指導方針。
以下是一些支援選項：
- 我們也提供安裝聊天 (僅限英文) 支援選項，可回答安裝的相關問題。
- 您可以透過 Visual Studio 安裝程式及 Visual Studio IDE 中的回報問題工具回報產品的問題。 如果您是 IT 系統管理員且未安裝 Visual Studio，您可以在這裡提交 IT 系統管理員意見反應。
- 在 Visual Studio 開發人員社群 \(英文\) 中建議功能、追蹤產品問題和尋找解答。