使用命令行參數來安裝、更新及管理Visual Studio

當您以程式設計方式或從命令提示字元安裝 Visual Studio 時，您可以使用各種命令行參數來控制或自訂安裝，以執行下列動作：

  • 使用預先選取的特定選項和行為，在用戶端上啟動安裝。
  • 自動化安裝或更新程式。
  • 建立或維護產品檔案的網路配置，以安裝或更新用戶端計算機。

下列命令行動詞和參數可以搭配下列可執行檔或程式使用：

  • 安裝啟動程式，它是小型（~1 MB）的檔案（例如，vs_enterprise.exe），負責啟動下載過程和初始安裝。
  • 可能已安裝在電腦上的 Visual Studio 安裝程式，位於資料夾 C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe。 您必須從安裝程式所在的目錄以外的 不同 目錄中程式化地起始安裝程式。 安裝程式通常用於更新或修改命令。
  • 使用包含 的 --override 參數的winget 命令。
  • 使用系統管理員更新套件，可從 Microsoft Update Catalog下載，以程式設計方式更新您的網路配置。 如需詳細資訊，請參閱 更新或修改您的版面配置 文章。

並非所有命令或參數都適用於上述每個情況，而且會記錄任何特殊注意事項或例外狀況。 此外，在某些情況下，您可能無法存取先前所述的所有可執行檔。 例如，如果 Visual Studio 是透過版面配置安裝，則用戶端電腦只能有安裝程式可供程式設計執行。

若要取得一律安裝最新版目前通道的 Visual Studio 2022 啟動載入器，請下載下表中的其中一個檔案。 或者，若要安裝特定版本或 Visual Studio 2022 的特定通道，請參閱 Visual Studio 2022 版本歷程記錄 頁面。 此頁面提供每個維護版本的固定版本啟動載入器連結。

版 Bootstrapper
Visual Studio 2022 企業版 vs_enterprise.exe
Visual Studio 2022 專業版 vs_professional.exe
Visual Studio 2022 社群 vs_community.exe
Visual Studio 2022 組建工具 vs_buildtools.exe

若要取得 Visual Studio 2026 的最新引導安裝程式，這些程式會總是安裝目前通道的最新版本，請下載下表中的其中一個檔案。 或者，若要安裝 Visual Studio 2026 的特定版本或特定通道，請參閱 Visual Studio 2026 發行歷程記錄 頁面。 此頁面提供每個維護版本的固定版本啟動載入器連結。

版 Bootstrapper
Visual Studio 2026 企業版 vs_enterprise.exe
Visual Studio 2026 專業版 vs_professional.exe
Visual Studio 2026 社群 vs_community.exe
Visual Studio 2026 組建工具 vs_buildtools.exe

提示

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

提示

如果您先前已下載啟動載入器檔案，並想要確認其將安裝的版本，以下是其安裝方式。 在 Windows 中，開啟 [檔案總管]，以滑鼠右鍵按兩下啟動載入器檔案，選擇 [屬性] ，然後選擇 [詳細數據] 索引標籤。[產品版本] 字段將描述啟動載入器將安裝 通道和版本。 版本號碼應一律讀取為「指定專案的最新服務版本」，除非明確指定，否則通道為目前版本。 因此，產品版本為穩定 18.0 的引導程式將安裝在 18.0 穩定通道上最新可用的 18.0.x 服務更新版本。 具有產品版本的啟動載入器，其只會指出 Visual Studio 2026 會在穩定通道上安裝最新版本的 Visual Studio 2026。

安裝、更新、修改、修復、卸載和導出命令和命令行參數

叫用 Visual Studio 啟動載入器或安裝程式以程式設計方式安裝產品或維護版面配置時：

  • 第一個參數是描述要執行的作業的命令（動詞命令）。
  • 後續的選擇性命令行參數，前面都加上兩個破折號（--），進一步定義該作業應該如何發生。

所有 Visual Studio 命令行參數都是不區分大小寫的，您可以在 命令行參數範例 頁面上找到更多範例。

語法範例：vs_enterprise.exe [command] <optional parameters>...

命令 描述
（空白） 默認命令會同時安裝產品，並用於所有配置維護作業。
modify 修改已安裝的產品。
update 更新已安裝的產品。
updateall 依序更新所有已安裝的產品。 適用於 --quiet 和 --passive 參數。
repair 修復已安裝的產品。
uninstall 卸載已安裝的產品。
export 將安裝組態匯出至 *.vsconfig 檔案。

重要

指定多個不同的工作負載或元件或語言時，您必須針對每個項目重複 --add 或 --remove 命令行參數。

參數 描述
--installPath <dir> 針對預設安裝命令，此參數 選擇性，並描述實例安裝在用戶端電腦上的位置。 對於更新或修改等其他命令，此參數 必要，並表示實例將要操作的安裝目錄。
--productId <id> 選擇性：已修改之產品實例的標識碼，並與 --channelId搭配使用。 productID 類似 「Microsoft.VisualStudio.Product.Enterprise」。。
--channelUri 可選的：執行更新命令時，您可以傳入新的 --channelUri 以變更更新設定位置。 建議與 --installPath 參數搭配使用，以便明確辨識您要設定的 Visual Studio 實例。 請參閱 語法範例 --channelUri
--channelId <id> 通道的識別碼，例如，VisualStudio.17.Release。 請參閱 --channelId語法範例。 修改操作需要 channelId，以及 --productID 或 --installPath。
--add <one or more workload or component IDs> 選擇性：在安裝或修改命令期間，這個可重複的參數會指定要新增的一或多個工作負載或元件標識碼。 已安裝工件的必要元件，但未安裝建議或選擇性元件。 您可以使用 --includeRecommended 和/或 --includeOptional 參數全域控制其他元件。 若要包含多個工作負載或元件，請重複 --add 命令（例如，--add Workload1 --add Workload2）。 如需更精細的控制，您可以將 ;includeRecommended 或 ;includeOptional 附加至標識碼（例如，--add Workload1;includeRecommended 或 --add Workload2;includeRecommended;includeOptional）。 如需詳細資訊，請參閱 工作負載和元件標識碼 頁面。
--all 選擇性：在執行安裝或修改命令時，此參數會使產品的所有負載和元件被安裝。
--allWorkloads 選擇性：在安裝或修改命令期間，此參數會安裝所有工作負載和元件，但不建議或選擇性元件。
--includeRecommended 選擇性：在安裝或修改命令期間，此參數包含所安裝任何工作負載的建議元件。 它不包含選擇性元件。 工作負載是使用 --allWorkloads 或 --add來指定。 請注意，使用 --includeRecommended 參數，您將啟用 [更新設定] 對話框，以「在更新時新增已安裝工作負載的建議元件」。 請參閱 自定義更新設定 來變更此設定。
--includeOptional 選擇性：在安裝或修改命令期間，此參數包含所安裝任何工作負載的選擇性元件。 它不包含建議的元件。 工作負載是使用 --allWorkloads 或 --add來指定。
--addProductLang <language-locale> 選擇性：在安裝或修改命令期間，這個可重複的參數會指定應該隨產品一起安裝的UI語言套件。 如果語言套件不存在，安裝將使用與電腦地區設定相對應的語言套件。 如需詳細資訊，請參閱 [語言地區設定清單]
--remove <one or more workload or component IDs> 選擇性：在修改命令期間，這個可重複的參數會指定要移除的一或多個工作負載或元件標識碼。 它補足並且行為類似於 --add 參數。
--removeProductLang <language-locale> 選擇性：在安裝或修改命令期間，這個可重複的參數會決定應該從產品中移除的UI語言套件。 它補足並且行為類似於 --addProductLang 參數。 如需詳細資訊，請參閱此頁面上的 語言地區設定清單 一節。
--in <path> 選擇性：應答文件的 URI 或路徑，其中可以包含組態設定。
--quiet 選擇性：搭配任何命令使用，此參數可防止執行命令時顯示任何使用者介面。 不論 AllowStandardUserControl 原則 是如何設定，標準使用者都無法透過程式使用。
--passive, -p 選擇性：此參數會使用戶介面以非互動式方式顯示。 此參數與 --quiet 參數是互斥的（而且事實上會覆寫 --quiet 參數）。 不論如何設定 AllowStandardUserControl 政策，標準使用者仍然無法以程式方式使用。
--norestart 選擇性：此參數必須與 --passive 或 --quiet 參數配對。 在安裝、更新或修改命令期間，新增 --norestart 參數會延遲任何必要的重新啟動。
--force 選擇性：此參數會強制關閉 Visual Studio，即使有任何 Visual Studio 進程正在使用中也一樣。 強制 Visual Studio 關閉可能會導致工作遺失，因此請謹慎使用。
--installWhileDownloading 選擇性：在安裝、更新或修改命令期間，此參數可讓Visual Studio同時下載並安裝產品。 這是預設體驗。
--downloadThenInstall 選擇性：在安裝、更新或修改命令期間，此參數會強制Visual Studio先下載所有檔案，再進行安裝。 它與 --installWhileDownloading 參數互斥。
--nickname <name> 選擇性：在安裝命令期間，此參數會定義要指派給已安裝產品的昵稱。 昵稱不能超過 10 個字元。
--productKey 選擇性：在安裝命令期間，此參數會定義要用於已安裝產品的產品密鑰。 產品金鑰是由格式為 xxxxxxxxxxxxxxxxxxxxxxxxx的 25 個英數位元所組成。
--removeOos true 選擇性：在安裝、更新或修改命令期間，此參數後面接著 true 或 false，告訴 Visual Studio 安裝程式是否要移除所有已移轉至不支持狀態的已安裝元件。 此行為適用於單一事件。 如果您想要讓此行為持續執行，請將此參數套用至modifySettings命令，如稍後所述，或 設定 removeOOS 全域原則。 有助於保護計算機安全。
--config <path to *.vsconfig file> 選擇性：在安裝或修改作業期間，您可以使用 --config 參數傳入組態檔，以根據先前儲存的安裝組態檔來指定要新增的工作負載、元件或延伸模組。 此操作僅為添加; 它不會移除文件中未指定的任何內容。 此外，設定檔中指定但不適用於產品的項目不會被新增。 強烈建議您指定組態檔的完整路徑。 在匯出作業期間，此參數會決定儲存安裝組態檔的位置。
--allowUnsignedExtensions 選擇性：在安裝或修改作業期間，使用 --passive 檔案在 --quiet 或 --config 內容中執行時，如果在組態檔中指定延伸模組，則需要此參數，才能載入沒有數位簽名的延伸模組。
--installerOnly 選擇性：在安裝或更新作業期間，此參數會指示Visual Studio安裝程式只安裝本身（安裝程式），而不是Visual Studio產品。 其功能相當於 --update 參數，但更直覺。 在準備和預先設定用戶端計算機時使用。
--help, --?, -h, -? 顯示此頁面的離線版本。

版面配置命令和命令行參數

所有版面配置管理作業，例如建立或更新版面配置，都是使用啟動載入器 exe 來執行，並假設命令是預設的 Install （空白）。 所有版面配置管理作業都應該從必要的 --layout 初始參數開始。 下表說明您可以使用命令行 建立或更新版面配置 的其他參數。

版面配置參數 描述
--layout <dir> 指定要建立或更新離線安裝快取的目錄。 如需詳細資訊，請參閱 建立Visual Studio的網路型安裝。
--lang <one or more language-locales> 選擇性：搭配使用 --layout，準備具有指定一或多個指定語言之資源套件的離線安裝快取。 如需詳細資訊，請參閱此頁面上的 語言地區設定清單 一節。
--add <one or more workload or component IDs> 選擇性：要新增的一或多個工作負載或元件標識碼。 已安裝工件的必要元件，但未安裝建議或選擇性元件。 您可以使用 --includeRecommended 和/或 --includeOptional全域控制更多元件。 如需更精細的控制，您可以將 ;includeRecommended 或 ;includeOptional 附加至標識碼（例如，--add Workload1;includeRecommended 或 --add Workload2;includeOptional）。 如需詳細資訊，請參閱 工作負載和元件標識碼 頁面。
注意：如果使用 --add，則只會下載指定的工作負載和元件及其相依性。 如果未指定 --add，所有工作負載和元件都會下載到佈局。
--includeRecommended 選用：包含已安裝的所有工作負載的建議元件，但不包含選用元件。 工作負載是使用 --allWorkloads 或 --add來指定。
--includeOptional 選擇性：包含配置中任何工作負載的建議 和 選用元件。 工作負載會以 --add指定。
--wait 選擇性：程式會等到安裝完成，再傳回結束代碼。 在自動化安裝過程中，wait 很有用，因為它可以讓安裝程序等待完成以便處理返回的代碼。 --wait 參數只能傳遞至啟動載入器;安裝程式 （setup.exe） 不支援它。 更新版面配置時很有用。 如需更多範例，請參閱這裡 。
--useLatestInstaller 選用：舊版功能僅適用於 2023 年 4 月之前的 Visual Studio 啟動載入器。 2023年4月之後所運送的任何專案預設都會使用最新的安裝程式。 如果此參數存在，即使它屬於較新的主要版本產品，Visual Studio 安裝程式的最新版本也會包含在您的版面配置中。 如果您想要利用最新版本中可用的新功能或錯誤修正，最新的安裝程式會很有用。 如需詳細資訊，請參閱 設定版面配置以一律使用最新的安裝程式 檔。
--config <path to *.vsconfig file> 選擇性：如果有，Visual Studio 會使用 組態檔的內容 來設定您的佈局。 請確定您指定組態檔的完整路徑。
--noWeb 選擇性：如果存在，Visual Studio 安裝程式會使用版面配置目錄中的檔案來安裝 Visual Studio，而且不會從 Web 下載任何套件。 如果使用者嘗試安裝不在版面配置中的元件，安裝程式會失敗。 如果您嘗試部署裝載於內部內部網路網站上的版面配置，請勿使用此參數。 如需詳細資訊，請參閱 在沒有因特網存取的用戶端上安裝。

重要：如果用戶端設定為查看 Microsoft 裝載的伺服器進行更新，--noWeb 參數不會阻止具備網際網路連線的客戶端電腦上的 Visual Studio 安裝程式檢查更新。 在此情況下，--noWeb 只會防止用戶端下載產品套件。
--verify 可選：確認版面配置的內容。 列出任何損毀或遺失的檔案。
--fix 可選：確認版面配置的內容。 如果有任何檔案損毀或遺失，則會重新下載。 需要因特網存取才能修正版面配置。
--clean <one or more paths to catalogs> 選擇性：從更新為較新版本的版面配置中移除舊版的元件。
進階版面配置參數 描述
--channelId <id> 選填的：要安裝之實例的通道標識碼，表示方式如 VisualStudio.17.Release。 安裝命令需要 channelId，如果指定了 --installPath，則會忽略其他命令。 請參閱 --channelId 的語法範例。
--channelUri <uri> 可選的：通道清單的 URI。 這個值會控管更新 的 來源位置，而且在版面配置 response.json 檔案 中設定初始值。 如需可能的值，請參閱 --channelUri 的 語法範例。 如果不想更新，--channelUri 可以指向不存在的檔案（例如 --channelUri C：\doesntExist.chman）。 此參數可用於安裝命令;其他命令會忽略它。
--installChannelUri <uri> 選用：用於安裝的通道清單 URI。 --channelUri 所指定的 URI（必須在指定 --installChannelUri 時指定）用來偵測更新。 此參數可用於安裝命令;其他命令會忽略它。
--installCatalogUri <uri> 可選：用於安裝的目錄指令清單的 URI。 如果有指定設定，通道管理員會先嘗試從此 URI 下載目錄清單，然後才在安裝通道清單中使用該 URI。 此參數可用來支援離線安裝，使用已下載的產品目錄來建立佈局快取。 此參數可用於安裝命令;其他命令會忽略它。
--productId <id> 可選：已安裝實例的產品 ID。 此參數會在一般安裝條件下預先填入。 productID 類似 「Microsoft.VisualStudio.Product.Enterprise」。。
--arch all 選擇性：根據預設，只會使用 x64 產品二進位檔來建立版面配置。 若要在版面配置中包含適用於工作負載的 ARM 二進位檔以及 x64 二進位檔，請使用 --arch all 或 --arch * 參數。 若要建立僅 ARM 二進位檔的配置，請使用 --arch arm64
--keepLayoutVersion 選擇性：將變更套用至版面配置，而不會更新該版面配置所包含的產品版本。
--locale <language-locale> 選擇性：變更安裝程式本身使用者介面的顯示語言。 設定將會保存。 如需詳細資訊，請參閱此頁面上的 語言地區設定清單 一節。
--cache 選擇性：如果套件存在，則安裝後會被保留以便後續修復。 這會覆蓋用於後續安裝、修復或修改的全域政策設定。 預設政策是快取套件。 卸載命令會忽略這項指令。 如需詳細資訊，請參閱如何 停用或移動套件快取。
--nocache 可選：如果存在，套件將會在安裝或修復之後被刪除。 只有在需要時，它們才會再次被下載，並在使用後再次被刪除。 這會覆蓋用於後續安裝、修復或修改的全域政策設定。 預設政策是快取套件。 卸載命令會忽略這項指令。 如需詳細資訊，請參閱如何 停用或移動套件快取。
--noUpdateInstaller 選擇性：如果存在，則防止安裝程式在指定靜默安裝時自行更新。 如果需要更新安裝程式時指定 noUpdateInstaller 並且使用安靜模式，安裝程式將會執行失敗且返回非零結束代碼。
--path <name>=<path> 選擇性：用來指定安裝的自定義安裝路徑。 支援的路徑名稱是共用、快取和安裝。
--path cache=<path> 選擇性：使用您指定的位置來下載安裝檔案。 此位置只能在第一次安裝 Visual Studio 時設定。 範例：--path cache="C:\VS\cache"
--path shared=<path> 選擇性：包含並存 Visual Studio 安裝的共享檔案。 某些工具和 SDK 會安裝到此磁碟驅動器上的位置，有些則可能會覆寫此設定並安裝至另一個磁碟驅動器。 範例：--path shared="C:\VS\shared"

重要：這隻能在第一次安裝Visual Studio時設定一次。
--path install=<path> 選擇性：相當於 –-installPath。 具體來說，--installPath "C:\VS" 和 --path install="C:\VS" 是相等的。 一次只能使用其中一個命令。

ModifySettings 命令和命令行參數

您可以使用用戶端電腦上的安裝程式或啟動載入器，並傳入modifySettings命令和所需的更新通道，以程式設計方式修改更新設定，並透過程式設計方式設定指定Visual Studio實例的更新來源位置。

命令 描述
modifySettings 動詞用來修改特定 Visual Studio 實例的更新設定。
modifySettings 參數 描述
--installPath <dir> 建議使用 來指定要操作的 Visual Studio 實例。
--newChannelUri 必要：通道宣告檔的 URI。 此值指定下一個更新 的 來源位置。 如需可能的值，請參閱 --channelUri 的 語法範例。 如果不想更新，--channelUri 可以指向不存在的檔案（例如 --channelUri C：\doesntExist.chman）。
--channelUri 舊頻道清單的 URI。 如果不知道 --installPath，可以使用 。 必須與 productID 搭配使用，以識別要採取行動的正確實例。
--productId <id> 如果已指定 --channelUri，且用來識別要採取行動的正確實例，則必須使用 。 productID 類似 「Microsoft.VisualStudio.Product.Enterprise」。。
--includeRecommended 選擇性：在 modifySettings 命令期間，此參數（必須立即跟在其後有 true 或 false 字樣）會告訴 Visual Studio 安裝程式停用 [更新設定] 對話方塊中的 [在更新時為已安裝工作負載新增建議元件] 功能。
--quiet 選擇性：此參數可防止執行命令時顯示任何使用者介面。 標準使用者無法以程式設計方式使用。
--removeOos true 選擇性：在modifySettings命令期間，此參數（在命令之後必須有 true 或 false 這個字）會告訴Visual Studio 安裝程式 持續 移除（或不要移除）所有已轉換為支援不足狀態的已安裝元件。 有助於保護計算機安全。

語法範例：

C:\>"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modifySettings --installPath "C:\Program Files\Microsoft Visual Studio\18\Enterprise" --newChannelUri https://aka.ms/vs/stable.18.0/channel --removeOos true

 C:\>"C:\Program Files\Microsoft\Visual Studio\2022\Enterprise\vs_enterprise.exe" modifySettings --channelUri https://aka.ms/vs/stable.18.0/channel --productID Microsoft.VisualStudio.Product.Enterprise --newChannelUri \\layoutserver\share\path\channelmanifest.json --removeOos true --quiet

語法範例：

C:\>"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modifySettings --installPath "C:\Program Files\Microsoft\Visual Studio\2022\Enterprise" --newChannelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --removeOos true

 C:\>"C:\Program Files\Microsoft\Visual Studio\2022\Enterprise\vs_enterprise.exe" modifySettings --channelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --productID Microsoft.VisualStudio.Product.Enterprise --newChannelUri \\layoutserver\share\path\channelmanifest.json --removeOos true --quiet

復原命令和命令行參數

從 Visual Studio 2022 開始，您可以使用用戶端電腦上的安裝程式，並連同安裝路徑實例一起傳入 rollback 命令，以程式設計方式 復原更新。

命令 描述
rollback 將 Visual Studio 的特定實例復原至先前安裝的更新的命令。 如果啟用 DisableRollback，此命令將無法運作。
回滾參數 描述
--installPath <dir> 建議使用 來指定要操作的 Visual Studio 實例。

語法範例：

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" rollback -–installPath "C:\Program Files\Microsoft Visual Studio\18\Enterprise"

語法範例：

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" rollback -–installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise"

系統管理員更新命令和命令行參數

您可以從 Microsoft 更新類別目錄 下載 系統管理員更新，並使用它來更新用戶端安裝或版面配置。

更新布局

如果您要將版面配置更新為特定版本的 Visual Studio，只要將系統管理員更新下載到裝載配置的電腦，在該電腦上開啟命令提示字元，然後執行如下的命令：

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

更新用戶端

在用戶端上，如果您將系統管理員更新下載到用戶端電腦上的安裝目錄，您可以按兩下檔案以套用更新。 您也可以開啟命令視窗，並傳遞下列部分參數來變更預設行為。

在 SCCM 中設定系統管理員更新

如果您要透過 Microsoft 端點管理員 （SCCM） 部署系統管理員更新，您可以使用下列參數來修改套件來調整行為。 您也可以透過用戶端電腦上的組態檔來控制參數。 如需詳細資訊，請參閱 方法來設定系統管理員更新

請注意，除非指定佈局動詞，否則所有管理員更新參數都會在『更新』語境中默認執行。

系統管理員更新參數 描述
--installerUpdateArgs [optional parameters] 此參數可作為「通過陣列」，傳遞與系統管理員更新情境相關的特定參數。 針對此用途啟用的選擇性參數為：

--quiet：這是系統管理員更新的默認體驗，並列在這裡以取得完整性。
--passive參數會覆蓋 --quiet 參數。 它會導致UI以非互動式方式顯示。
--norestart：此參數必須與 --quiet 或 --passive 搭配使用，並導致任何必要的重新啟動延遲。
--noWeb：此參數會防止Visual Studio在因特網上檢查產品的更新。
--force：此參數會強制關閉Visual Studio，即使Visual Studio正在使用中也一樣。 請謹慎使用此參數，因為它可能會導致工作遺失。 只有當系統管理員更新是在用戶內容中執行時，才必須使用此參數;如果在系統內容中執行系統管理員更新，則會忽略它。
--installWhileDownloading：此參數可讓Visual Studio平行下載並安裝產品。 這是系統管理員更新的默認體驗，並列在這裡以取得完整性。
--keepWindowsUpdateOn：此參數可防止安裝程式關閉用戶端上的 Windows Update 代理程式。 如果您要將系統管理員更新從目錄匯入 SCCM，則應該使用此參數。 您可能也需要將 SCCM 套件逾時設定為超過預設 10 分鐘的時間。 將 SCCM 部署類型變更為 [必要] 會使此參數不必要。
--downloadThenInstall：此參數會強制Visual Studio先下載所有檔案，再進行安裝。 它與 --installWhileDownloading 參數互斥。
--checkPendingReboot 如果電腦上有尚未完成的重新啟動，無論是由哪個應用程式引發，都會中止更新。 預設值為不要檢查等待重新啟動。

將參數傳遞至系統管理員更新的語法範例：

visualstudioupdate-16.9.0to16.9.4.exe --installerUpdateArgs "--force --noWeb --keepWindowsUpdateOn" --checkPendingReboot

如果您遇到錯誤 87（The parameter is incorrect），請確認 --installerUpdateArgs 值已加上引號，且該值中的參數開關之間以空格分隔。

拿掉通道命令和命令行參數

可供更新的管道會在用戶端上進行快取，隨著時間推移，它們可能會導致混亂。 手動移除 更新通道 方法是開啟 Visual Studio 安裝程式，切換至 [可用] 索引標籤，然後點擊產品卡右上角的 X。 您可以使用 removeChannel 命令，以程式方式移除通道（例如較舊的版面配置位置）。 您可以在用戶端電腦上以程式設計方式執行 vswhere，以判斷用戶端電腦上快取的通道。

命令 描述
removeChannel 執行從用戶端電腦移除通道的命令。
"removeChannel" 參數 描述
--channelUri 需要 舊訊息通道清單的 URI。
--quiet 選擇性 此參數可防止執行命令時顯示任何使用者介面。
--passive 選擇性 此參數會覆寫 --quiet 參數。 它會導致UI以非互動式方式顯示。

語法範例：

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" removeChannel --channelUri "\\\\server\\share\\layoutdirectory\\ChannelManifest.json"

使用 winget 安裝或修改 Visual Studio

您可以使用 Windows 套件管理員 “winget” 工具，以程式設計方式在您的電腦上安裝、修改或更新 Visual Studio，以及其他由 winget 管理的套件。

根據預設，winget 只會安裝 Visual Studio 核心工作負載。

winget install --id Microsoft.VisualStudio.Community

不過，如果您想要自定義安裝，並指定要在初始安裝期間取得的其他工作負載和元件，您可以使用 winget 的 --override 參數與 winget 的 install 命令並傳入 導出的 vsconfig 檔案，其中包含要新增的工作負載和元件：

winget install --id Microsoft.VisualStudio.Community --override "--passive --config c:\my.vsconfig"

當然，您也可以在初始安裝期間就直接包含元件，如下所示：

 winget install --id Microsoft.VisualStudio.Community --override "--quiet --add Microsoft.Visualstudio.Workload.Azure"

根據預設，winget 只會安裝 Visual Studio 核心工作負載。

winget install --id Microsoft.VisualStudio.2022.Community

不過，如果您想要自定義安裝，並指定要在初始安裝期間取得的其他工作負載和元件，您可以使用 winget 的 --override 參數與 winget 的 install 命令並傳入 導出的 vsconfig 檔案，其中包含要新增的工作負載和元件：

winget install --id Microsoft.VisualStudio.2022.Community --override "--passive --config c:\my.vsconfig"

當然，您也可以在初始安裝期間就直接包含元件，如下所示：

 winget install --id Microsoft.VisualStudio.2022.Community --override "--quiet --add Microsoft.Visualstudio.Workload.Azure"

如果您已在計算機上安裝 Visual Studio，則可以使用 winget 的 configure 命令 以及 Visual Studio PowerShell DSC 提供者、yaml 檔案和 .vsconfig 檔案，將 元件新增至現有的 Visual Studio 安裝。 Winget 的 configure 命令基本上可作為 Visual Studio 的「修改」作業。 請參閱 如何撰寫 WinGet 組態檔，以瞭解如何建立 winget 組態。

您無法使用 winget 的 --override 命令與 upgrade 開關或 Visual Studio DSC 提供程式一起執行，因為 upgrade 基本上僅作為 Visual Studio 的“更新”作業，並安裝您已選擇的元件的最新版本。 您無法透過更新/升級來新增元件。 您必須使用 winget 的 configure 來新增元件。

請注意，Visual Studio 安裝程式作業目前需要系統管理員許可權，因此 winget 會提示您視需要提高許可權來完成命令。 此外，目前無法使用 winget 在用戶端電腦上同時安裝多個版本（也就是不同的 SKU）或相同 SKU 的多個實例。 最後，如果您要設定或修改Visual Studio以新增元件，或將它升級至最新版本，則必須關閉Visual Studio。

工作負載標識碼和元件標識碼的清單

如需依 Visual Studio 產品排序的工作負載和元件標識碼清單，請參閱 Visual Studio 工作負載和元件標識碼 頁面。

語言區域清單

語言地區設定 語言
Cs-cz 捷克語
De-de 德語
En-us 英語
Es-es 西班牙文
Fr-fr 法語
It-it 義大利語
Ja-jp 日語
Ko-kr 朝鮮語
Pl-pl 波蘭語
Pt-br 葡萄牙文 - 巴西
Ru-ru 俄語
Tr-tr 土耳其文
Zh-cn 中文 - 簡體
Zh-tw 中文 - 繁體中文

錯誤碼

根據作業的結果，%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)		 發生失敗狀況 - 檢查記錄以取得詳細資訊

每個作業都會在 %TEMP% 目錄中產生數個記錄檔，指出安裝進度。 依日期排序資料夾，並尋找以啟動載入器、安裝程式應用程式和安裝引擎開頭為 dd_bootstrapper、dd_client和 dd_setup 的檔案。

支援或疑難解答

有時候，事情可能會出錯。 如果您的 Visual Studio 安裝失敗，請參閱 針對 Visual Studio 安裝和升級問題進行疑難解答， 以取得逐步指引。

以下是一些更多支援選項：

相關內容

  • Last updated on