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

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

• 使用預先選取的特定選項和行為，在用戶端上開始安裝。
• 自動執行安裝或更新程序。
• 針對用於安裝或更新用戶端電腦的產品檔案，建立或維護其網路配置。

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

• 安裝引導程式，它是啟動下載過程和初始安裝的小檔案（~1 MB）（例如 vs_enterprise.exe）。
• 可能已安裝在電腦上且位於資料夾 C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe 中的 Visual Studio 安裝程式。 您必須以程式設計方式從安裝程式所在的不同目錄啟動安裝程式。 安裝程式通常用於更新或修改命令。
• 與使用 winget --override 參數的 winget 命令搭配使用。
• 與系統管理員更新程式封裝搭配使用，此套件可從 Microsoft Update Catalog 加以下載，以供您透過程式設計方式更新網路配置。 更多資訊可以在更新或修改佈局一文中找到。

並非所有命令或參數都適用於所有這些情況，並且記錄了所有特殊警告或例外。 此外，在某些情況下，您可能無法存取前述所有可執行檔。 例如，如果 Visual Studio 是透過配置加以安裝的，則用戶端電腦只能有可供以程式設計方式執行的安裝程式。

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

版本(Edition)	啟動載入器
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 中開啟 [檔案總管]，以滑鼠右鍵按一下啟動載入器檔案，選擇 [屬性]，然後選擇 [詳細資料] 索引標籤。[產品版本] 欄位會描述啟動載入器將會安裝的通道和版本。 版本號碼一律應解讀為「所指定項目的最新服務版本」，且除非明確指定，否則通道為「目前」。 因此，產品版本為 LTSC 17.0 的啟動載入器會安裝可在 17.0 LTSC 通道上取得的最新 17.0.x 服務版本。 產品版本標示為 Visual Studio 2022 的啟動載入器會安裝目前通道上的最新版 Visual Studio 2022。

安裝、更新、修改、修復、解除安裝和匯出命令與命令列參數

以程式設計方式叫用 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 一起使用的產品執行個體 ID。 productID 是類似於「Microsoft.VisualStudio.Product.Enterprise」的項目。
--channelUri	可選：在更新指令期間，您可以傳入新的 --channelUri 來變更更新設定位置。 建議與 --installPath 參數配對，以便明確要設定的 Visual Studio 執行個體。 請參閱 --channelUri 的語法範例
--channelId <id>	通道 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 參數類似，且與其互補。
此頁面上的 (#list-of-language-locales) 區段。
--removeProductLang <language-locale>	選擇性：在安裝或修改命令執行期間，這個可重複參數會決定應該從產品中移除的 UI 語言套件。 此參數的行為與 --addProductLang 參數類似，且與其互補。
--in <path>	選擇性：可包含組態設定的回應檔的 URI 或路徑。
--quiet	選擇性：與任何命令搭配使用時，此參數可防止系統在執行命令時顯示任何使用者介面。 無論 AllowStandardUserControl 原則如何設定，標準使用者都無法以程式設計方式使用。
--passive, -p	選擇性：此參數會導致使用者介面以非互動式方式顯示。 此參數與 --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	選擇性：在使用 --config 檔案在 --passive 或 --quiet 內容中執行的安裝或修改作業期間，如果在組態檔中指定了延伸模組，則需要此參數才能載入沒有數位簽章的延伸模組。
--installerOnly	可選：在安裝或更新作業期間，此參數告訴 Visual Studio 安裝程式僅安裝其本身 (安裝程式)，而不安裝 Visual Studio 產品。 其功能相當於--update參數，但更直觀。 目標在準備和預先配置客戶端電腦時使用。
--help, --?, -h, -?	顯示此頁面的離線版本。

配置命令和命令列參數

所有配置管理作業 (例如建立或更新配置) 都會使用啟動載入器 exe 來加以執行，並假定該命令為預設安裝 (空白)。 所有配置管理作業都應該從必要的 --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 下載任何套件。 如果使用者嘗試安裝不在佈局中的元件，安裝將會失敗。 如果您嘗試部署託管在內部網路網站上的佈局，請勿使用此參數。 如需詳細資訊，請參閱在沒有網際網路存取權的用戶端上進行安裝。 重要：如果--noWeb用戶端配置為查看 Microsoft 託管伺服器以取得更新，則此參數不會阻止連接網路的使用者端電腦上的 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>	選擇性：已安裝之執行個體的產品識別碼。 在一般安裝情況中會預先填入此參數。 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>	選擇性：用來指定安裝的自訂安裝路徑。 支援的路徑名稱為 shared、cache 和 install。
--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\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\2022\Enterprise"

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

您可以從 Microsoft Update Catalog 下載系統管理員更新，並用它來更新您的用戶端安裝或配置。

更新配置

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

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

更新用戶端

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

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

如果您要透過 Microsoft Endpoint Manager (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 代理程式。 如果您要將系統管理員更新從 Catalog 匯入到 SCCM，則請使用此參數。 您可能也需要將 SCCM 套件的逾時值設定為超過 10 分鐘 (預設值)。 將 SCCM 部署類型變更為 [必要] 會讓此參數變得沒有必要性。 --downloadThenInstall：此參數會強制 Visual Studio 先下載所有檔案再進行安裝。 此參數與 --installWhileDownloading 參數互斥。
--checkPendingReboot	如果電腦上有擱置的重新開機，則無論可能是哪個應用程式造成的，系統都會中止更新。 預設值是不要檢查擱置的重新開機。

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

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

移除通道命令和命令列參數

系統會在用戶端上快取可供從中進行更新的通道，隨著時間推移，這些項目會堆積成山。 您可以開啟 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.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 的 upgrade 命令使用 --override 參數或 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 安裝和升級問題進行疑難排解，以取得逐步指導方針。

以下是一些支援選項：

• 我們也提供安裝聊天 (僅限英文) 支援選項，可回答安裝的相關問題。
• 您可以透過 Visual Studio 安裝程式及 Visual Studio IDE 中的回報問題工具回報產品的問題。 如果您是 IT 系統管理員且未安裝 Visual Studio，您可以在這裡提交 IT 系統管理員意見反應。
• 在 Visual Studio 開發人員社群 \(英文\) 中建議功能、追蹤產品問題和尋找解答。

相關內容

• Visual Studio 安裝的命令列參數範例
• 建立 Visual Studio 的離線安裝
• 使用回應檔自動安裝 Visual Studio
• Visual Studio 工作負載與元件識別碼