建立、維護及部署 Visual Studio 的網路安裝

發行項
02/23/2023

適用于：Visual StudioVisual Studio for MacVisual Studio Code

有時候企業系統管理員想要建立網路安裝點，其中包含可部署到用戶端工作站的 Visual Studio 檔案。這是為了協助用戶端電腦可能具有有限許可權或對網際網路的有限存取，或當組織想要在特定版本的開發人員工具組上標準化的情況。我們已設計 Visual Studio，讓系統管理員可以 建立和維護 (檔案快取) 的網路設定，這些配置可以儲存在內部網路共用上。網路設定包含初始安裝和後續產品更新所需的所有 Visual Studio 檔案。

此網頁有許多資訊，並分組為下列各節：

開始之前：醒目提示秘訣和其他重要考慮，您應該在規劃時考慮。
取得正確的啟動載入器：尋找位置的指引，以及如何區分可供您使用的各種啟動載入器。
建立網路設定：描述如何使用正確的產品內容、通道設定和安裝程式版本建立配置，以及如何將它複製到網路共用。
更新、修改和維護網路設定：如何最佳維護配置的資訊，包括如何更新版面配置的產品版本、產品內容、通道設定、安裝程式版本和資料夾大小。
在用戶端電腦上安裝配置：描述如何設定用戶端預設設定，例如預設要安裝的工作負載和元件，以及用戶端應該從何處尋找更新。也包含如何在用戶端電腦上執行 Visual Studio 版面配置 的初始安裝 。有關從版面配置更新原本安裝之用戶端電腦的指導方針和資訊，涵蓋在 Visual Studio 網頁的個別更新網路型安裝中。
說明與支援：要求協助的位置

開始之前

開始之前，有一些重要事項可以規劃並注意。

資料夾管理： 例如，如果您的企業 (使用多個版本的 Visual Studio，Visual Studio 2019 Professional 和 Visual Studio 2019 Enterprise) ，您必須為每個版本建立個別的網路安裝點。此外，雖然某些組織已成功使用符號連結來解決 80 個字元的限制，但版面配置路徑必須少於 80 個字元。
規劃更新：您應該先決定用戶端電腦應該如何接收產品更新，再進行初始用戶端安裝。這是確保用戶端的更新位置設定正確設定的必要條件。您的選擇包括讓用戶端從網路設定位置或從網際網路上的 Microsoft 託管伺服器取得更新。

重要

當您只使用 Visual Studio 2019 功能時，建構管理有下列限制：一旦用戶端從配置安裝，用戶端的更新位置就會鎖定且無法變更。這表示，如果您打算讓用戶端從配置接收更新，同時保留其修復和卸載功能，則必須將所有後續的產品更新放在用戶端安裝的來源原始版面配置資料夾中。換句話說，基底 Visual Studio 2019 功能 不支援 用戶端從一個版面配置位置執行原始安裝的能力，然後讓該用戶端從不同的版面配置位置接收產品更新。

修正產品更新位置的限制，且產品更新必須位於與原始安裝配置相同的配置資料夾中，且 Visual Studio 2022 中不存在 。在 Visual Studio 2022 中，您可以輕鬆地變更用戶端的來源位置以進行更新。我們讓您能夠包含及使用最新的 (Visual Studio 2022) 安裝程式，該安裝程式可控管 Visual Studio 產品系列 的所有 新式版本，以管理 Visual Studio 2019 版面配置，並消除產品 2019 版的限制。下一節將版面配置設定為一律包含並提供最新的安裝程式說明如何啟用此功能。

資料夾管理： 例如，如果您的企業 (使用多個版本的 Visual Studio，Visual Studio 2022 Professional 和 Visual Studio 2022 Enterprise) ，您必須為每個版本建立個別的網路安裝點。此外，雖然某些組織已成功使用符號連結來解決 80 個字元的限制，但版面配置路徑必須少於 80 個字元。
規劃更新：建議您先決定用戶端電腦應該如何接收產品更新，再進行初始用戶端安裝。這是為了確保用戶端的更新位置設定已正確初始化。您的選擇包括讓用戶端從網路設定位置或從網際網路上的 Microsoft 託管伺服器取得更新。幸運的是，在初始安裝發生之後，也可以設定更新的用戶端來源位置。

下載 Visual Studio 啟動載入器以建立網路設定

下載您想要之 Visual Studio 版本的啟動載入器，並將它複製到您想要作為配置來源位置的目錄。一旦建立版面配置，您就可以使用它將 Visual Studio 安裝到任何用戶端電腦上。啟動載入器是您用來建立、更新和執行其他配置作業的可執行檔。您必須連接網際網路，才能完成此步驟。

下列啟動載入器一律會安裝最新的最安全 Visual Studio 2019 版本，無論您何時執行它們。或者，如果您想要建立或更新配置至特定版本的 Visual Studio 2019，請移至 Visual Studio 2019 版本頁面，其中包含每個服務版本的固定版本啟動載入器連結，並下載您想要的版本。將它複製到您要作為版面配置來源位置的目錄。

版本	啟動載入器
Visual Studio 2019 Enterprise 16.11 版	vs_enterprise.exe
Visual Studio 2019 Professional 16.11 版	vs_professional.exe
Visual Studio 2019 組建工具 16.11 版	vs_buildtools.exe

其他支援的啟動載入器包括 vs_teamexplorer.exe、 vs_testagent.exe和 vs_testcontroller.exe。

以下所列的啟動載入器一律會在目前的通道上安裝最新的最安全 Visual Studio 2022 版本，不論何時執行。或者，如果您想要針對特定版本或 Visual Studio 2022 的特定通道建立或更新版面配置，請移至 Visual Studio 2022 版本歷程記錄頁面，其中包含每個通道上每個服務版本的永久和固定版本啟動載入器連結，並下載您想要的版本。將它複製到您要作為版面配置來源位置的目錄。

版本	啟動載入器
Visual Studio 2022 Enterprise	vs_enterprise.exe
Visual Studio 2022 Professional	vs_professional.exe
Visual Studio 2022 組建工具	vs_buildtools.exe

提示

如果您先前已下載啟動載入器檔案，並想要確認其版本為何，以下是做法。在 Windows 中，開啟檔案總管，以滑鼠右鍵按一下啟動載入器檔案，選擇 [內容]，選擇 [詳細資料] 索引標籤，然後檢視[產品版本號碼]。若要將該數位與 Visual Studio 版本相符，請參閱 Visual Studio 2019 Releases 頁面底部的資料表。

提示

如果您先前已下載啟動載入器檔案，並想要確認其將安裝的版本，以下是其安裝方式。在 Windows 中，開啟檔案總管，以滑鼠右鍵按一下啟動載入器檔案，選擇 [屬性]，然後選擇 [詳細資料]索引標籤。[產品版本] 欄位將描述啟動載入器將安裝的通道和版本。除非明確指定，否則版本號碼應一律讀取為「指定專案的最新服務版本」，且通道會假設為「目前」。因此，具有 LTSC 17.0 產品版本的啟動載入器將會安裝 17.0.x 的最新服務版本，該版本可在 17.0 LTSC 通道上使用。具有產品版本的啟動載入器，只要說 Visual Studio 2022 將會在目前通道上安裝最新維護版本的 Visual Studio 2022。

建立網路設定

您必須連接網際網路，才能完成此步驟。

以系統管理員許可權開啟命令提示字元，流覽至您下載啟動載入器的目錄，然後使用啟動載入器的參數，如使用命令列參數來安裝 Visual Studio 頁面以建立和維護網路設定。建立初始版面配置的常見範例如下，以及在 Visual Studio 安裝頁面的命令列參數範例中說明。

單一語言地區設定的完整初始配置需要大約 35 GB 的磁碟空間，Visual Studio Community需要 45 GB 才能Visual Studio Enterprise。其他語言地區設定需要大約一半 GB。

建議的方法是建立Visual Studio Enterprise的初始配置，其中包含網路伺服器上配置目錄中的所有語言和所有工作負載。如此一來，您的用戶端就能存取整個產品供應專案。若要建立 Visual Studio 的完整版面配置，請從您打算裝載網路設定的電腦執行下列命令：

vs_enterprise.exe --layout c:\VSLayout

確定您的版面配置具有正確的通道

請務必確定網路設定是以正確的通道為基礎，因為這是系統管理員更新的其中一個準則，如果他們在整個組織中部署，請使用來識別應該更新的用戶端實例。例如，如果您的版面配置是以 VisualStudio.17.Release.LTSC.17.0 通道為基礎，而且您的用戶端已設定為從 Microsoft 託管伺服器接收更新，則我們會在 17.0 LTSC 通道上提供的任何安全性更新，都可供從該配置安裝或更新的用戶端使用。

以上所列的啟動載入器是以目前通道為基礎。若要根據其中一個 LTSC 通道建立配置，只要從 Visual Studio 2022 發行歷程記錄頁面取得正確的通道啟動載入器，將其複製到您的版面配置資料夾，然後使用它來建立或更新版面配置。

設定網路設定的內容

有數個選項可用來自訂網路設定的內容。您可以建立部分配置，以便只包含一組特定語言地區設定、工作負載、元件，及其建議或選擇性相依性。如果您知道只會在用戶端工作站部署一部分的工作負載，這可能十分有用。用於自訂配置的一般命令列參數包括：

--add 表示指定工作負載或元件識別碼。
如果使用 --add，則只會下載使用 --add 指定的工作負載和元件。如未使用 --add，則會下載所有工作負載和元件。
--includeRecommended 表示包含指定之工作負載識別碼的所有建議元件。
--includeOptional 表示包含指定之工作負載識別碼的所有選擇性元件。
--lang 可指定語言地區設定。

下列範例示範如何建立自訂部分配置。

若要針對一種語言建立具有所有工作負載和元件的版面配置，請執行：
```
vs_enterprise.exe --layout C:\VSLayout --lang en-US
```
若要針對多種語言建立具有所有工作負載和元件的版面配置，請執行：
```
vs_enterprise.exe --layout C:\VSLayout --lang en-US de-DE ja-JP
```
若要建立具有一個工作負載的版面配置，以及該工作負載的所有建議元件，請針對所有語言執行：
```
vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --includeRecommended
```

若要為三種語言建立具有兩個工作負載和一個選擇性元件的版面配置，請執行：

vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Component.Git --lang en-US de-DE ja-JP

使用 .vsconfig 檔案自訂版面配置的內容

您也可以使用匯出的 vsconfig 檔案來自訂網路設定的內容。這項功能相當新，因此您必須在版面配置中使用最新的安裝程式。

vs_enterprise.exe --layout C:\VSLayout --config "C:\myconfig.vsconfig" --useLatestInstaller

確定您的版面配置使用最新的安裝程式

建議您一律在版面配置中使用最新的 Visual Studio 安裝程式，並將它散發給用戶端。如此一來，您就能存取我們在後續產品版本中提供的新功能。例如，如果您在 Visual Studio 2019 版面配置中散發 Visual Studio 2022 安裝程式，則根據該版面配置，Visual Studio 2019 用戶端將能夠變更更新的來源位置。如果您想要從一個版面配置安裝，但有更新來自另一個版面配置，這項功能會很有用。以下說明進一步的詳細資料，包括如何使用最新的安裝程式關閉

重要

使用最新安裝程式的功能僅適用于原本隨附于 Visual Studio 2022 之後所建置的 Visual Studio 2019 啟動載入器。因此，下列範例中的vs_enterprise.exe必須是 2021 年 11 月 10 日之後 隨附的版本。

若要建立使用最新和最大安裝程式之整個產品的版面配置，請執行
```
vs_enterprise.exe --layout C:\VSLayout --useLatestInstaller
```

您必須在網路共用上裝載配置，才能從用戶端電腦執行。如果您在本機電腦上建立版面配置，則必須將其複製到網路位置。下列範例會使用 xcopy。您也可以視需要使用 robocopy 。範例：

xcopy /e c:\VSLayout \\server\share\layoutdirectory

重要事項

若要避免發生錯誤，請確定網路共用上的完整版面配置路徑少於 80 個字元。或者，某些組織已成功使用符號連結來解決 80 個字元的限制。

維護您的版面配置

最佳做法是定期將 Visual Studio 版面配置更新為最新安全版本的產品。這可確保配置可以同時使用為安裝點，以及用戶端安裝的更新來源。本節說明最常見的或實用的版面配置維護作業。

如果您在檔案共用上裝載版面配置，您可能會想要更新版面配置的私人複本 (，例如 c：\VSLayout) ，然後在下載所有更新的內容之後，將它複製到您的檔案共用 (例如 \\server\products\VS) 。如果您未這麼做，在更新版面配置時發生任何執行安裝程式的使用者，可能會因為尚未完全更新而從版面配置取得內容不符。

將版面配置更新為最新的產品版本

Microsoft 經常發行更新的產品版本，以修正功能或安全性問題。強烈建議您將版面配置保持最新版的產品更新，讓您的用戶端一律能夠存取最新安全版本的產品。如果您的用戶端沒有網際網路存取權，而且只能從版面配置接收產品更新，這非常重要。

當您建立初始配置時，指定的選項，例如要包含在配置中的工作負載和語言，都會儲存在版面配置的組態檔中。稍後，當您將該版面配置更新為較新版本的產品時，您不需要在版面配置中重新指定您想要的產品元件。版面配置更新只會將現有元件更新為最新的版本。

假設您已經使用上表中其中一個 evergreen 啟動載入器來建立此部分版面配置。

vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.ManagedDesktop --lang en-US

將此版面配置更新為 Microsoft 所提供的最新版產品，並裝載于 Microsoft 伺服器上很容易。您只需要在版面配置中使用現有的 evergreen 啟動載入器，然後直接執行 --layout 命令，將最新的套件下載到您的版面配置，如下所示：

vs_enterprise.exe --layout c:\VSLayout

您也可以以自動方式將版面配置更新為較新的版本。配置作業會在新的主控台視窗中執行安裝程序。視窗會保持開啟狀態，讓系統管理員可以看到最終版面配置更新結果，以及可能發生之任何錯誤的摘要。例如，如果您想要以自動方式執行版面配置更新作業， (例如，您有定期執行的腳本，以將版面配置更新為最新版本) ，然後使用參數，而 --passive 程式會自動關閉視窗。

vs_enterprise.exe --layout c:\VSLayout --passive

將版面配置更新為特定版本的產品

有時候，您可能想要將版面配置更新為 特定版本的產品。例如，您可能想要讓版面配置符合您已標準化組織的最新安全維護基準版本。以下說明如何執行這項作業：

您可以移至 Visual Studio 2019 Releases 頁面，並下載特定的固定版本啟動載入器、將它複製到您的版面配置，並使用它將配置更新為啟動載入器中指定的確切版本。您會使用與上述完全相同的語法。

您可以使用 系統管理員更新 ，將版面配置更新為特定版本。若要取得 系統管理員更新，請移至 Microsoft Update Catalog ，並搜尋您想要的更新版本。將 update.exe 下載到裝載配置的電腦、開啟命令提示字元，然後執行命令，如下所示：

visualstudioupdate-16.0.0to16.11.23.exe layout --layoutPath c:\VSLayout

請注意，系統管理員更新不會起始原始版面配置安裝;它們只會更新現有的配置或用戶端實例。

您可以移至 Visual Studio 2022 發行歷程記錄頁面，並下載特定的固定版本啟動載入器、將它複製到您的版面配置，並使用它將配置更新為啟動載入器中指定的確切版本。您會使用與上述完全相同的語法。

您可以使用 系統管理員更新 ，將版面配置更新為特定版本。若要取得 系統管理員更新，請移至 Microsoft Update Catalog，搜尋您要更新版面配置的更新。將 update.exe 下載到裝載配置的電腦，在該電腦上開啟命令提示字元，然後執行如下的命令：

visualstudioupdate-17.0.0to17.4.4.exe layout --layoutPath c:\VSLayout

請注意，系統管理員更新不會起始原始版面配置安裝;它們只會更新現有的配置或用戶端實例。

確保您的網路設定是以支援的版本為基礎

有時候，當通道移出支援時，您必須確保網路設定會繼續以支援的通道為基礎，讓您的用戶端可以繼續接收安全性更新的通知。如果您的版面配置是以 VisualStudio.17.Release.LTSC.17.0 通道為基礎，則一旦 17.0 LTSC 通道不受支援，我們就不會發行任何安全性更新，而且您的版面配置和用戶端將會變得不安全。

若要變更版面配置所依據的通道，只要從 Visual Studio 2022 發行歷程記錄頁面取得所需的通道啟動載入器，將它複製到您的版面配置資料夾，然後執行一般更新。然後，您的用戶端應該會適當地收到更新的通知，讓他們能夠保持安全。

修改版面配置的內容

可以修改部分版面配置，並新增其他工作負載、元件或語言。無法可靠地從版面配置中移除元件。

在下列範例中，我們會將 Azure 工作負載和當地語系化語言新增至先前只使用受控桌面工作負載和英文所建立的配置。當我們進行修改之後，受控桌面和 Azure 工作負載，以及英文和德文資源都會包含在此版面配置中。除了新增元件之外， --layout 此命令也會讓配置更新為啟動載入器所指定的版本。因此，如果您使用 evergreen 啟動載入器，則產生的配置將會有新的元件、新的語言，以及所有版面配置內容都會更新為啟動載入器通道上的最新版本。

vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --lang de-DE

如果您想要修改現有的部分版面配置，使其變成完整版面配置，請使用 --all 選項，如下列範例所示。同樣地，此命令會導致配置內容更新為啟動載入器所指定的版本。

vs_enterprise.exe --layout c:\VSLayout --all

您可以傳入包含配置中所需其他元件的 vsconfig 檔案，以將元件新增至版面配置。請注意，這項功能是新功能，因此需要最新的安裝程式。此命令也會讓版面配置內容更新為啟動載入器所指定的版本。

vs_enterprise.exe --layout C:\VSLayout --config "C:\myconfig.vsconfig" --useLatestInstaller

最後，您可以直接編輯 layout.json 配置資料夾中的組態檔，並更新此檔案的 [新增] 區段，以包含您想要包含在版面配置中的其他元件。接著，您必須使用 --layout 先前所述來更新版面配置，以下載最新的元件。

注意

在用戶端電腦上安裝新新增的版面配置元件最簡單的方式，就是從用戶端電腦在版面配置中執行啟動載入器。版面配置中檔案的 response.json 'add' 區段將決定用戶端安裝程式 UI 中預設會選取哪些元件。如果您已使用上述其中一種方法修改版面配置，您可以手動按兩下，並可能調整檔案中的 response.json 'add' 區段，使其更適當地符合新修改 layout.json 檔案之 'add' 區段中的內容。

將版面配置設定為一律包含並提供最新的安裝程式

您可以將版面配置設定為一律包含並提供最新的安裝程式給用戶端，即使安裝程式被視為較新版本 Visual Studio 的一部分也一樣。因此，當您的用戶端從此版面配置更新時，用戶端會取得此版面配置包含和提供的最新安裝程式。優點是，一旦最新的安裝程式在您的用戶端上，您的用戶端安裝就能夠利用我們繼續新增至安裝程式的 Bug 修正和新功能。

提示

如果您想要變更用戶端 Visual Studio 2019 安裝尋找更新的位置， 則必須 在用戶端電腦上取得最新的 Visual Studio 2022 安裝程式。其中一個做法是使用下列參數，在 Visual Studio 2019 版面配置中包含 Visual Studio 2022 安裝程式。使用最新安裝程式的功能僅適用于原本隨附于 Visual Studio 2022 之後所建置的 Visual Studio 2019 啟動載入器。因此，下列範例中的vs_enterprise.exe必須是 2021 年 11 月 10 日之後 隨附的版本。

有兩種方式可讓您的版面配置包含並提供最新的安裝程式：

當您建立或更新版面配置時，您可以將參數傳入 --useLatestInstaller 啟動載入器。這會導致在 layout.json 檔案中設定設定，這可在配置的根目錄中找到。以下範例說明如何更新版面配置，並將其設定為使用可用的最新和最大安裝程式。
```
vs_enterprise.exe --layout C:\VSLayout --useLatestInstaller
```

您可以直接編輯 layout.json 檔案以新增此設定。

{
   "installChannelUri": ".\\ChannelManifest.json",
   "channelUri": "\\\\server\\share\\layoutdirectory\\ChannelManifest.json",
   "installCatalogUri": ".\\Catalog.json",
   "channelId": "VisualStudio.16.Release",
   "productId": "Microsoft.VisualStudio.Product.Enterprise",

   "useLatestInstaller": true
   "removeOos": true

}

您無法以程式設計方式移除檔案中的 layout.json 這項設定，因此如果您想要讓版面配置停止使用 Microsoft 提供的最新安裝程式，請改用對應至啟動載入器 (的安裝程式版本，這很可能是比最新安裝程式舊) ，只要編輯 layout.json 檔案並移除 "UseLatestInstaller": true 設定即可。

請注意，您也可以在版面配置檔案 response.json 中找到此 "UseLatestInstaller": true 設定，但會在該處忽略。當用戶端從版面配置安裝或更新時，會使用 response.json 檔案在用戶端上設定預設組態選項。此特定 "useLatestInstaller": true 設定可用來確保 版面配置 的內容包含最新的安裝程式，讓用戶端電腦可以從版面配置取得最新的安裝程式。

設定配置以移除用戶端電腦上的不支援元件。

有些企業會想要利用 Visual Studio 2022 17.4 版中引進的功能，以移除已轉換為支援不足狀態的元件。如果您要管理版面配置，以及用戶端是否收到系統管理員更新，這相當容易設定。首先，您必須設定版面配置，讓安裝程式的最新版本如上所述。其次，您必須將行 "removeOos": true 新增至 response.json 檔案，如上所示。如果您的版面配置已正確設定這兩個詳細資料，後續的系統管理員更新將會遵守此設定，並將從用戶端電腦中移除不支援的元件。

確認版面配置

使用 --verify 在網路設定上執行驗證，以檢查套件檔案是否遺失或無效。在驗證結束時，它會列印遺失和不正確檔案清單。

驗證僅適用於特定 Visual Studio 次要版本的最新版。發行新版本之後，驗證將無法用於包含舊版的版面配置。

vs_enterprise.exe --layout <layoutDir> --verify

注意

選項所需的 --verify 一些重要中繼資料檔案必須位於版面配置資料夾中。如果遺失這些中繼資料檔案，則無法執行 "--verify"，而且安裝程式會產生錯誤。如果您遇到此錯誤，請嘗試再次更新配置，或在不同的資料夾中重新建立新的網路設定。

請記住，Microsoft 會定期更新 Visual Studio，因此除非您使用固定連結啟動載入器，否則較新的版面配置可能不會包含與初始版面配置相同的版本。

修正版面配置

使用 --fix 執行與 --verify 相同的驗證，同時嘗試修正已識別的問題。 --fix 程序需要網際網路連線，因此請先確定您的電腦連線至網際網路，再叫用 --fix。

vs_enterprise.exe --layout <layoutDir> --fix

從版面配置中移除舊版

當您對網路快取執行配置更新之後，配置資料夾可能會有一些過時的套件，這些套件已由最新的 Visual Studio 安裝不再需要。您可以使用 --clean 選項，從網路設定資料夾移除過時的套件。

若要這麼做，您需要包含這些過時套件之目錄資訊清單的檔案路徑。您可以在網路設定快取的「封存」資料夾中找到目錄資訊清單。當您更新配置時，即會將它們儲存在該處。在 [封存] 資料夾中，有一或多個 "GUID" 具名資料夾，且各包含過時目錄資訊清單。「GUID」資料夾的數目應該與您的版面配置所做的更新數目相同。

有一些檔案儲存在每個 "GUID" 資料夾內。最有趣的兩個檔案是 "catalog.json" 檔案和 "version.txt" 檔案。 "catalog.json" 檔案是您需要傳遞至 --clean 選項的過時目錄資訊清單。其他 version.txt 檔案包含此過時目錄資訊清單的版本。根據版本號碼，您可以決定是否要從此目錄資訊清單中移除過時套件。當您瀏覽其他 "GUID" 資料夾時，可以執行相同動作。在您決定想要清除的目錄之後，請提供這些目錄的檔案路徑來執行 --clean 命令。

以下是如何使用 --clean 選項的範例：

c:\VSLayout\vs_enterprise.exe --layout c:\VSLayout --clean c:\VSLayout\Archive\1cd70189-fc55-4583-8ad8-a2711e928325\Catalog.json --clean c:\VSLayout\Archive\d420889f-6aad-4ba4-99e4-ed7833795a10\Catalog.json

當您執行此命令時，安裝程式會分析您的網路設定資料夾，以尋找將移除的檔案清單。您接著可能會檢閱要刪除的檔案，並確認刪除。

從網路安裝將 Visual Studio 安裝到用戶端電腦

系統管理員可以在執行安裝指令碼時，將 Visual Studio 部署到用戶端工作站。或者，具有系統管理員權限的使用者可以直接從共用執行安裝程式，以在其電腦上安裝 Visual Studio。

使用者可以執行下列命令，從網路設定手動安裝產品：
```
\\server\products\VS\vs_enterprise.exe
```
系統管理員可以執行下列命令，以便使用自動模式來安裝：
```
\\server\products\VS\vs_enterprise.exe --quiet --wait --norestart
```

請確定執行安裝的使用者或系統帳戶具有包含配置之網路共用的適當存取權。如需詳細資訊，請參閱在安裝或使用 Visual Studio 時針對網路相關錯誤進行疑難排解。

注意

請耐心等候。請確定您 --wait 已完成安裝程式和產品。從配置安裝或更新用戶端時，安裝程式一律是安裝或更新的第一件事，然後 Visual Studio 產品本身會安裝或更新。 這兩個 程式都需要完成，才能視為成功的更新。

當在自動自動批次檔中執行安裝或更新時， --wait 此選項有助於確保 vs_enterprise.exe 程式在傳回結束代碼之前，等候安裝完成。如果企業系統管理員想要在完成的安裝上執行進一步的動作，例如將產品金鑰套用至成功的安裝，這非常有用。使用 --wait 選項可防止後續作業提前啟動。如果您不使用 --wait ，程式 vs_enterprise.exe 可以在安裝兩個部分完成之前結束，因此會傳回不代表安裝作業狀態的不正確結束代碼。

在沒有網際網路存取權的用戶端上安裝

當您從版面配置安裝時，所安裝的內容預設會從版面配置取得。不過，如果您選取的元件不在版面配置中，且用戶端已設定為查看 Microsoft 裝載的伺服器是否有更新，則安裝程式也會嘗試從網際網路取得 Visual Studio 套件。如果您想要防止 Visual Studio 安裝程式嘗試從配置中遺漏的 Web 下載任何內容，請使用 --noWeb 選項。如果使用 --noWeb ，且配置遺漏任何選取要安裝的內容，則安裝程式將會失敗。

重要

如果用戶端已設定為查看 Microsoft 裝載的伺服器是否有更新，此選項 --noWeb 不會停止連線到網際網路連線用戶端電腦上的 Visual Studio 安裝程式檢查更新。相反地， --noWeb 只要防止用戶端下載產品套件即可。如需詳細資訊，請參閱從網路設定頁面更新已安裝的 Visual Studio 用戶端。

如果您收到錯誤訊息，指出「找不到符合下列參數的產品」，請確定您使用 --noweb 參數。

設定此配置的初始用戶端安裝預設值

您可以在 layout 資料夾中修改 response.json 檔案，以在產品最初安裝在用戶端電腦上時設定的預設值。常見的組態選項包括：

在初始安裝期間 ，應該預設選取哪些工作負載、元件或語言 的能力。
能夠指定 用戶端應該從何處接收更新。範例包括網際網路上的預設 Microsoft 主控伺服器，或來自受系統管理員控制的網路設定位置。

如需如何自訂和設定配置預設用戶端設定的詳細資訊，請參閱使用回應檔將 Visual Studio 安裝自動化。

設定企業部署行為的原則

您也可以控制其他企業部署行為，例如安裝、更新和下載行為、系統管理員更新行為、版面配置在 [ 更新設定 ] 對話方塊中的顯示方式，以及通知行為。

如需詳細資訊，請參閱設定 Visual Studio 企業部署的原則。

錯誤碼

如果已使用 --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 進程
-1073720687	連線失敗
-1073741510	Microsoft Visual Studio 安裝程式已由使用者或外部處理序終止
其他 (例如： -1、1、1603)	發生失敗狀況 - 請檢查記錄檔以取得詳細資訊

取得網路設定的支援

如果您遇到網路設定的問題，我們想要瞭解。告知我們的最佳方式是使用報告問題工具，其同時出現在 Visual Studio 安裝程式和 Visual Studio IDE 中。如果您是 IT 系統管理員且未安裝 Visual Studio，您可以在這裡提交 IT 管理員意見反應。當您使用此工具時，如果 VS Collect 工具可以傳送記錄，這有助於我們診斷並修正問題。

我們也提供安裝聊天 (僅限英文) 支援選項，可回答安裝的相關問題。

我們也提供其他支援選項。請參閱我們的Visual Studio 開發人員社群。

建立、維護及部署 Visual Studio 的網路安裝

開始之前

下載 Visual Studio 啟動載入器以建立網路設定

建立網路設定

確定您的版面配置具有正確的通道

設定網路設定的內容

使用 .vsconfig 檔案自訂版面配置的內容

確定您的版面配置使用最新的安裝程式

維護您的版面配置

將版面配置更新為最新的產品版本

將版面配置更新為特定版本的產品

確保您的網路設定是以支援的版本為基礎

修改版面配置的內容

將版面配置設定為一律包含並提供最新的安裝程式

設定配置以移除用戶端電腦上的不支援元件。

確認版面配置

修正版面配置

從版面配置中移除舊版

從網路安裝將 Visual Studio 安裝到用戶端電腦

在沒有網際網路存取權的用戶端上安裝

設定此配置的初始用戶端安裝預設值

設定企業部署行為的原則

錯誤碼

取得網路設定的支援

另請參閱

其他資源

其他資源

建立、維護及部署 Visual Studio 的網路安裝

開始之前

下載 Visual Studio 啟動載入器以建立網路設定

建立網路設定

確定您的版面配置具有正確的通道

設定網路設定的內容

使用 .vsconfig 檔案自訂版面配置的內容

確定您的版面配置使用最新的安裝程式

將配置複製到網路共用

維護您的版面配置

將版面配置更新為最新的產品版本

將版面配置更新為特定版本的產品

確保您的網路設定是以支援的版本為基礎

修改版面配置的內容

將版面配置設定為一律包含並提供最新的安裝程式

設定配置以移除用戶端電腦上的不支援元件。

確認版面配置

修正版面配置

從版面配置中移除舊版

從網路安裝將 Visual Studio 安裝到用戶端電腦

在沒有網際網路存取權的用戶端上安裝

設定此配置的初始用戶端安裝預設值

設定企業部署行為的原則

錯誤碼

取得網路設定的支援

另請參閱

其他資源

其他資源