使用最小離線版面配置來更新 Visual Studio

發行項
10/05/2023

對於未連線到網際網路的電腦，建立最小版面配置是更新離線 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 <一或多個產品識別碼>	要從中產生最小離線版面配置的產品識別碼，以逗號分隔。 Microsoft.VisualStudio.Product.Enterprise Microsoft.VisualStudio.Product.Professional Microsoft.VisualStudio.Product.BuildTools Microsoft.VisualStudio.Product.TestAgent Microsoft.VisualStudio.Product.TestController Microsoft.VisualStudio.Product.TeamExplorer	必要	--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 開發人員社群 \(英文\) 中建議功能、追蹤產品問題和尋找解答。