建立並維護 Visual Studio 的網路安裝

企業管理員可能會想要建立私人安裝快取 (也稱為「配置」),其中包含可部署至組織內用戶端電腦的 Visual Studio 檔案。

在下列情況中,建立配置很有用:

  • 使用者的權限有限
  • 用戶端電腦對網際網路的存取受限
  • 組織想要針對特定版本的開發人員工具組進行標準化

我們設計了 Visual Studio,讓管理員可以建立和維護配置、將配置儲存在內部網路共用上,並選擇性地在組織的內部網路上提供配置。 配置可作為所有 Visual Studio 檔案的來源位置,用於初始的用戶端安裝和隨後更新。

本頁資訊分成三個主要部分:

  • 建立配置:描述如何使用正確的產品內容建立配置、設定預設設定、將配置儲存在網路檔案共用上,以及在內部網路上提供配置。
  • 維護配置:說明如何以最佳方式更新配置的產品版本,或修改配置的產品內容、頻道設定、安裝程式版本和資料夾大小。
  • 說明與支援:可尋求協助的位置

建立配置

準備網路檔案共用儲存位置

首先,您必須決定要在何處儲存已下載的 Visual Studio 套件。 如果您的企業中使用多個 Visual Studio 版本 (例如 Visual Studio 2022 Professional 和 Visual Studio 2022 Enteprise),則必須針對每個版本建立個別的配置。 為每個版本建立單獨的配置可能會消耗大量磁碟空間,特別是當您考慮到配置更新也會消耗磁碟空間。

配置路徑必須少於 80 個字元;一些組織成功地使用符號連結來解決 80 個字元的限制。

下載 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 Build Tools 16.11 版 vs_buildtools.exe

其他支援的啟動程序包含 vs_teamexplorer.exevs_testagent.exevs_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 Community vs_community.exe
Visual Studio 2022 Build Tools vs_buildtools.exe

提示

如果您先前已下載啟動程序檔案,且想要確認版本,可以使用以下方式。 在 Windows 中,開啟 [檔案總管],在啟動程序檔案上按一下滑鼠右鍵,選擇 [屬性],然後選擇 [詳細資料] 分頁,再檢視 [產品版本] 號碼。 若要將該號碼與 Visual Studio 的版本進行比對,請參閱 Visual Studio 2019 版本頁面底部的資料表。

提示

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

下載 Visual Studio 套件

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

開啟較高許可權的命令提示字元,導覽至您下載啟動程序所在的目錄,並使用啟動程序的參數 (如 使用命令列參數來安裝 Visual Studio 頁面所定義) 以建立並維護您的網路配置。 下列範例會呈現建立初始配置的常見方式。 在Visual Studio 安裝的命令列參數範例頁面上可以找到更多範例。

如果是 Visual Studio Community,單一語言地區設定的完整初始配置需要大約 40 GB 的磁碟空間,Visual Studio Enterprise 則需要大約 50 GB。 額外的語言地區設定分別需要約 0.5 GB。

建議的作法是建立 Visual Studio 的初始配置,包含所有工作負載和適當的語言,並將套件儲存到網路伺服器上的配置目錄。 如此一來,任何用戶端安裝都可以存取整個 Visual Studio 產品方案,並且能夠安裝任何子集。 若要建立 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 以包含指定工作負載識別碼的所有選用元件。
  • --config 使用 *.vsconfig 檔案指定應包含在配置中或由配置參考的工作負載、元件或延伸模組。 請確實指定組態檔的完整路徑
  • --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
    

使用組態檔初始化配置的內容

您可以使用 --config 參數來傳入 *.vsconfig 檔案。 請確實指定組態檔的完整路徑 。 配置建立期間使用 *.vsconfig 檔案可自訂網路配置的內容,並將網路配置的內容限制為組態檔中指定的內容。 組態檔會複製到配置目錄中,並重新命名為 layout.vsconfig

*.vsconfig 檔案中指定的延伸模組都不會直接複製到配置中。 相反,配置的 response.json 檔案包含對新建立之 layout.vsconfig 檔案的參考,定義用戶端延伸模組的安裝位置。 如果您要安裝未經數位簽署的延伸模組,請務必編輯 response.json 以新增 "allowUnsignedExtensions": true。 請參閱 response.json 內容範例

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

將配置複製到網路共用

您需要在網路共用上裝載配置,這樣才能從用戶端電腦上存取。 如果您已在本機電腦上建立配置,必須將其複製到網路檔案位置。 下列範例會使用 xcopy。 如果需要的話,您也可以使用 robocopy。 範例:

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

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

名為 response.json 的檔案會建立在配置的根資料夾中。 當用戶端從配置進行初始安裝時,此可自訂檔案提供要在用戶端上設定的初始預設設定。 常見的組態選項包括可設定:

  • 用戶端上預設應安裝哪些工作負載、元件或語言
  • 是否也應該安裝建議的元件
  • 用戶端是否應遵守安裝 *.vsconfig 檔案
  • 用戶端應從哪裡接收更新
  • 更新期間是否應刪除不支援的元件
  • 是否允許未經簽署的延伸模組以無訊息 & 程式設計方式載入

如需詳細資訊,請參閱使用回應檔自動安裝 Visual Studio 頁面。

讓您的配置可透過內部網站存取

從 2023 年 6 月開始,您可以在內部網路網站上提供配置,從而利用網頁伺服器檔案快取和異地複寫效能功能。 若要使用這項新功能,您需要使用最新的 Visual Studio 啟動載入器和最新的 Visual Studio 安裝程式。 IT 管理員必須執行下列動作,才能運用此內部網路 Web 裝載功能:

  1. 首先需要建立和維護網路配置,並確保其顯示在網路共用上,並且會定期更新。 此外,如果您想要讓用戶端從內部網路配置位置取得更新,請記得在配置的 response.json 中設定 channelUri 值

  2. 接下來,管理員必須準備內部網站,並將網站的來源繫結至配置的網路檔案位置。 他們還需要確保 Web 伺服器遵循以下 MIME 類型:

    副檔名 MIME 類型
    .cab application/vnd.ms-cab-compressed
    .exe application/octet-stream
    .json application/json
    .msi application/octet-stream
    .msu application/octet-stream
    .nupkg application/octet-stream
    .opc application/octet-stream
    .ps1 application/postscript
    .vsix application/octet-stream
    .xml text/xml
    .zip application/x-zip-compressed
  3. 最後,若要在用戶端上部署此配置,請在用戶端上執行 PowerShell 指令碼以執行初始安裝。 Visual Studio 從 Web 裝載的配置成功安裝到用戶端後,便可以透過標準方法更新 Web 託管的配置的用戶端更新

請確保您的配置使用的是最新的安裝程式

注意

自 2023 年 6 月起,最新的安裝程式預設會針對所有支援的 Visual Studio 2017、Visual Studio 2019 和 Visual Studio 2022 版本隨附每項更新。 因此,如果您使用其中一個產品版本,不需要特別執行任何動作,即可取得最新版本的安裝程式,其中包含最新的功能和錯誤修正。

如果您使用的是 2023 年 6 月之前提供的 Visual Studio 版本,我們建議您一律在配置中使用最新的 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

維護配置

最佳做法是定期將 Visual Studio 配置更新到產品的最新安全版本。 這可確保配置可以作為安裝點,也可以作為用戶端安裝的更新來源。 以下章節介紹最常見或最實用的配置維護作業。

如果您在網路檔案共用上裝載配置,請將更新後的配置下載至私人本地共用 (例如 c:\VSLayoutUpdate),然後在所有已更新的內容下載完成之後,複製到配置網路檔案共用 (例如 \server\products\VS)。 如果不這麼做,則在更新配置時碰巧執行安裝程式的使用者可能會從配置中獲得不相符的內容,因為它尚未完全更新。

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

Microsoft 經常發行產品的更新版本,以修正功能或安全性問題。 我們強烈建議您將配置與最新版本的產品保持一致,以便用戶端隨時可以存取近期最安全的產品版本。 如果您的用戶端沒有網際網路存取權,而且只能從配置接收產品更新時,這會特別重要。 Visual Studio 通常會在當月的第二個星期二發行安全性更新,稱為「修補檔星期二」,因此在當天下午更新所有配置會是良好的策略。

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

假設您已使用上表中的其中一個常用啟動程序建立此部分配置。

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

將此配置更新為 Microsoft 提供且裝載在 Microsoft 伺服器上的最新產品版本相當容易。 您只需要在配置中使用現有的常青啟動載入器,並在提高權限的提示下執行 --layout 命令,即可將最新的軟體套件下載到您的配置中,如下所示:

vs_enterprise.exe --layout c:\VSLayout

您也可以透過自動方式,將配置更新為較新版本。 配置作業會在新的主控台視窗中執行安裝程序。 此視窗會保持開啟,以便管理員查看最終的配置更新結果,以及可能已發生的錯誤摘要。 如果您要透過自動方式執行配置更新作業 (例如讓指令碼定期執行以將配置更新為最新版本),請使用 --passive 參數,處理程序將會自動關閉視窗。

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

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

您可以將配置更新為特定版本的產品。 例如,可以讓配置符合服務基準最新安全版本 (您為組織標準化的服務基準)。 方法如下:

您可以前往 Visual Studio 2019 版本頁面,並下載特定的固定版本啟動程序、複製到您的配置,並用來將配置更新為啟動程序中指定的確切版本。 使用與上述完全相同的語法。

您可以使用管理員更新,將配置更新為特定版本的產品。 若要取得管理員更新,請前往 Microsoft Update 目錄,然後搜尋您要將配置更新為哪個版本。 將 update.exe 下載到裝載配置的電腦、開啟較高許可權的命令提示字元,然後執行如下命令:

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

請注意,管理員更新不會起始新配置的建立;它僅會更新現有配置。 您必須使用啟動載入器來建立初始配置。

您可以前往 Visual Studio 2022 發行記錄頁面,並下載特定的固定版本啟動程序、複製到您的配置,並用來將配置更新為啟動程序中指定的確切版本。 使用與上述完全相同的語法。

您可以使用管理員更新,將配置更新為特定版本的產品。 若要取得管理員更新,請前往 Microsoft Update 目錄,然後搜尋您要將配置更新為哪個版本。 將 update.exe 下載到裝載配置的電腦、在該電腦上開啟較高許可權的命令提示字元,然後執行如下命令:

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

請注意,管理員更新不會起始建立新配置;只會更新現有的配置。 您將需要使用啟動載入器來建立初始配置。

確保您的網路設定是以支援的版本為根據

有時候,當通路不再受到支援時,您必須確保網路配置會繼續以支援的通道為根據,讓您的用戶端能繼續接收安全性更新的通知。 如果您的配置是以 VisualStudio.17.Release.LTSC.17.0 通道為根據,則當 17.0 LTSC 通道於 2023 年 7 月不再受到支援時,我們就不會再發行任何相關的安全性更新,您的配置和用戶端將會有安全疑慮。 各個 Visual Studio 2022 通道的支援日期請參閱此處

若要變更配置所基於的通道,請從 Visual Studio 2022 發行歷程記錄頁面獲取所需通道的啟動載入器,將其複製到配置資料夾中,然後執行正常更新。 您的用戶端應該會適當地收到更新的通知,因此也能夠保持安全。

修改配置的內容

可以修改部分配置,並新增 其他工作負載、元件或語言。 可以放心not從配置移除元件。

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

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

如果您想要將現有部分配置修改為完整配置,請使用 --all 選項,如下列範例所示。 同樣的,此命令也會使配置內容更新為啟動程序所指定的版本。

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

您可以傳入 *.vsconfig 檔案,其中包含配置中所需的其他元件,藉此將元件新增至配置。 如果執行此操作,新的 *.vsconfig 內容將覆蓋現有的 layout.vsconfig 內容。 如需詳細資訊,請參閱上一節使用組態檔初始化配置內容

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

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

注意

如果要將新增的配置元件安裝到用戶端電腦,最簡單的方式就是從用戶端電腦執行配置中的啟動程序。 配置中 response.json 檔案的「add」區段將會決定用戶端安裝程式 UI 中預設會選取哪些元件。 如果您已使用上述其中一種方法修改配置,您可以手動再次檢查,且可以調整 response.json 檔案中的「add」區段,使其更符合新修改 layout.json 檔案「add」區段中的內容。

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

有些企業會想要運用 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

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

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

注意

自 2023 年 6 月起,最新的安裝程式預設會針對支援的 Visual Studio 2017、Visual Studio 2019 和 Visual Studio 2022 版本隨附每項更新。 因此,不需要特別執行任何動作,即可取得最新版本的安裝程式,其中包含配置和用戶端的最新功能與錯誤修正。

不過,如果您使用在 2023 年 6 月之前建立的配置,您也可以明確地將配置設定為一律包含並提供最新的安裝程式給用戶端,即使安裝程式被認為是新版 Visual Studio 的一部分也一樣。 因此,當您的用戶端從此配置更新時,用戶端會取得此配置所包含和提供的最新安裝程式。 這樣的好處是,當最新的安裝程式位於用戶端上,您的用戶端安裝就能夠運用我們持續新增至安裝程式的錯誤修正和新功能。

提示

如果您想要變更用戶端 Visual Studio 2019 安裝尋找更新的位置 ,或如果您想要移除所有不再支援的元件,則您必須取得用戶端電腦上最新的 Visual Studio 2022 安裝程式。 其中一種方法是使用下列參數,在 Visual Studio 2019 配置中包含 Visual Studio 2022 安裝程式。 如果您想使用的是最新的安裝程式,只有在 Visual Studio 2022 原始提供之後建置的 Visual Studio 2019 啟動程序才適用。 因此,下列範例中的 vs_enterprise.exe 必須是 2021 年 11 月 10 日之後提供的版本。

有數種方式可讓您的配置包含並提供最新的安裝程式:

  • 您可以使用建置在 2023 年 6 月之後的 Visual Studio 版本。

  • 當您建立或更新配置時,可以將 --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 檔案在用戶端上設定預設組態選項layout.json 檔案中的這個特定 "useLatestInstaller": true 設定是用來確保配置的內容包含最新的安裝程式,讓用戶端電腦接著可以從配置取得最新的安裝程式。

錯誤碼

如果已使用 --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 管理員意見反應。 當您使用此工具時,如果可以透過 Visual Studio Collect 工具傳送記錄,將會很有幫助,可協助我們診斷並修正問題。

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

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