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

適用于:yesVisual Studio no Visual Studio for Mac no Visual 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.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 組建工具 vs_buildtools.exe

提示

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

提示

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

建立網路設定

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

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

單一語言地區設定的完整初始配置需要 Visual Studio Community 大約 35 GB 的磁碟空間,以及 Visual Studio Enterprise 的 45 GB。 其他語言 地區設定 需要大約一個 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
    
  • 若要建立具有兩個工作負載和其所有建議和選擇性元件的版面配置,請執行:

    vs_enterprise.exe --layout C:\VSLayout --add Microsoft.VisualStudio.Workload.Azure --add Microsoft.VisualStudio.Workload.ManagedDesktop --includeRecommended --includeOptional
    

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

建議您一律在版面配置中使用最新的 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 的網路設定,以便用來作為用戶端工作站的安裝點和更新來源,以接收最新版的 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 頁面,並下載特定的固定版本啟動載入器、將它複製到您的版面配置,並使用它將配置更新為啟動載入器中指定的確切版本。 您會使用與上述完全相同的語法。

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

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

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

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

修改網路設定的通道

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

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

修改版面配置的內容

可以修改此版面配置,並新增或移除其他工作負載或元件或語言。 在下列範例中,我們會將 Azure 工作負載和當地語系化語言新增至我們上面建立的版面配置。 在進行修改之後,受控桌面和 Azure 工作負載以及英文和德文資源都會包含在此版面配置中。 此外,配置也會更新為最新的可用版本。

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

如果您想要修改現有的部分版面配置,使其變成完整版面配置,請使用 --all 選項,如下列範例所示。

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

以下是如何在不更新版本 的情況下 新增額外的工作負載和當地語系化語言。 (此命令會新增 ASP.NET 和 Web 開發工作負載。) 現在,此版面配置中包含受控桌面、Azure 和 ASP.NET & Web 開發工作負載。 所有這些工作負載也會包含英文、德文和法文的語言資源。 不過,執行此命令時,配置不會更新為最新的可用版本。 它會保持現有的版本。

vs_enterprise.exe --layout c:\VSLayout --add Microsoft.VisualStudio.Workload.NetWeb --lang fr-FR --keepLayoutVersion

重要

更新作業不會將其他選擇性元件下載或安裝到版面配置或用戶端。 如果您需要新增或變更選用元件,請先從 layout.json 組態檔中移除舊的選擇性元件,並在 的 layout.json [新增] 區段中包含您需要的新元件。 然後,當您執行 --layout 命令來更新版面配置時,它會將新新增的元件下載到配置中。

若要在用戶端電腦上安裝這些新元件,請確定您執行這三個步驟。 首先,確認版面配置包含如上所述的新元件。 接下來,將您的用戶端更新為配置中的最新位。 最後,再次在用戶端上執行修改作業,以在用戶端電腦上安裝新增至配置) 的新元件 (。

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

您可以將版面配置設定為 一律 包含並提供最新的安裝程式給用戶端,即使安裝程式被視為較新版本 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
    
    }
    

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

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

確認版面配置

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

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

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

注意

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

請記住,Microsoft 會定期更新 Visual Studio,因此,除非您使用 [固定連結啟動載入器] (#download-the-visual-studio-bootstrapper-to create-the-network-layout) ,否則較新的版面配置可能不會包含與初始版面配置相同的版本。

修正版面配置

使用 --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
    

注意

請耐心等候。 請確定您 --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 參數。

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

您可以修改版面配置資料夾中的某些檔案,以設定產品最初安裝在用戶端電腦上的預設值。 常見的組態選項包括:

  • 在初始安裝期間 ,應該預設選取哪些工作負載、元件或語言 的能力。
  • 能夠指定 用戶端應該從何處接收更新。 選項來自受系統管理員控制的網路設定位置,或來自網際網路上 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 開發人員社群

另請參閱