共用方式為


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

📣 我們很樂意聽到您的意見反應!請花點時間完成此 問卷,並讓我們知道如何改善版面配置體驗。感謝您的支援!

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

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

  • 用戶的許可權有限
  • 用戶端計算機對因特網的存取有限
  • 組織想要針對特定版本的開發人員工具組進行標準化

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

此頁面的資訊分成三個主要區段:

  • 建立版面配置:說明如何使用正確的產品內容建立版面配置、設定預設設定、將它儲存在網路檔案共用上,並在您的內部網路上提供配置。
  • 維護版面配置:如何最好地更新版面配置的產品版本的資訊,或修改版面配置的產品內容、頻道設定、安裝程式版本和資料夾大小。
  • 說明與支援:要向何處尋求協助

製作版面

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

首先,您必須判斷要儲存下載的 Visual Studio 套件的位置。 如果您在企業中使用多個版本的Visual Studio(例如Visual Studio 2022 Professional和Visual Studio 2022 Enterprise),則必須為每個版本建立個別的版面配置。 為每個版本建立個別的版面配置可能會耗用大量的磁碟空間,特別是當您考慮版面配置更新也會耗用磁碟空間時。

配置路徑必須少於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 組建工具 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 組建工具 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。 額外的 語言地區設定 需要大約半 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 包含所有指定工作負載 ID 的可選元件。
  • --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 月開始,您可以在內部內部網路網站上提供您的版面配置,讓您利用 Webserver 檔案快取和地理複製效能功能。 若要使用這項新功能,您必須使用最新的 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 成功從網路裝載的佈局安裝到客戶端之後,客戶端更新就可以透過標準方法更新網路裝載的佈局

確保您的版面配置正在使用最新的安裝程式。

注意

自 2023 年 6 月起,最新的安裝程式預設會隨附所有支援的 Visual Studio 2017、Visual Studio 2019 和 Visual Studio 2022 的所有更新。 因此,如果您使用其中一個產品版本,則不需要明確執行任何動作,以取得具有最新功能和 Bug 修正的安裝程式最新版本。

如果您使用 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伺服器上的最新產品版本很容易。 您只需在佈局中使用現有的 evergreen 引導程式,並在高階命令提示字元中執行 --layout 命令,即可將最新的套件下載到您的佈局,如下所示:

vs_enterprise.exe --layout c:\VSLayout

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

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

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

有時候您可能會想要將您的版面配置更新為特定版本的產品 。 例如,您可能希望使您的版面配置符合您已將組織標準化的最新安全維護基準版本。 以下是如何執行此動作:

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

您可以使用 系統管理員更新,將您的版面配置更新到產品的特定版本。 若要取得 系統管理員更新,請移至 Microsoft 更新類別目錄,並搜尋您要更新版面配置的更新版本。 將 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

請注意,系統管理員更新不會起始新版面配置的建立;它只會更新現有的版面配置。 您需要使用Bootstrap工具來建立初始版面配置。

確保您的網路配置是以支援的版本為基礎

有時候,當通道移出支援時,您必須確保網路配置會繼續以支援的通道為基礎,讓您的用戶端可以繼續接收安全性更新的通知。 如果您的版面配置是以 VisualStudio.17.Release.LTSC.17.0 通道為基礎,則一旦 2023 年 7 月 17.0 LTSC 信道不支援,我們不會再發行任何安全性更新,而且您的版面配置和用戶端將會變得不安全。 各種 Visual Studio 2022 通道的支援日期,請參閱

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

修改版面的內容

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

在下列範例中,我們會將 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 的一部分也一樣。 因此,當您的用戶端從此版面配置更新時,用戶端會取得此版面配置所包含和提供的最新安裝程式。 優點是,一旦最新的安裝程式在您的用戶端上,您的用戶端安裝就能夠利用我們繼續新增至安裝程式的 Bug 修正和新功能。

提示

如果您想要 變更用戶端 Visual Studio 2019 安裝尋找更新的位置,或如果您想要移除所有不支援的元件,則 必須 取得用戶端電腦上最新的 Visual Studio 2022 安裝程式。 其中一種方法是使用下列參數,在Visual Studio 2019版面配置中包含Visual Studio 2022 安裝程式。 最新安裝程式的使用功能僅適用於 Visual Studio 2019 的啟動載入器,這些載入器是在 Visual Studio 2022 最初推出後建置的。 因此,下列範例中的 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 開發人員社群