共用方式為

使用命令行參數安裝 SQL Server Management Studio 21 Preview

  • 發行項

適用於：SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics

SQL Server Management Studio 21 Preview 是一個功能強大的工具，可用來管理 SQL Server 實例、Azure SQL 資料庫和 Azure SQL 受控實例。 本文提供如何使用命令行參數來安裝 SQL Server Management Studio 21 Preview 的詳細指示，以允許更自定義和自動化的安裝程式。 無論您是第一次安裝 SQL Server Management Studio 21 Preview 或更新現有的安裝，這些指示都會提供達成目標的必要步驟。

命令列參數

當您以程式設計方式或從命令提示字元安裝 SQL Server Management Studio （SSMS）時，您可以使用各種命令行參數來控制或自定義安裝，以執行下列動作：

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

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

  • 安裝程式啟動載入器，這是起始下載程式和初始安裝的小型 （~1 MB） 檔案（例如，vs_ssms.exe）。
  • 可能已安裝在電腦上且位於資料夾中 C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe的Visual Studio安裝程式。 您必須以程式設計方式從安裝程式所在的不同目錄啟動安裝程式。 安裝程式通常用於更新或修改命令。

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

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

通道 版本 啟動載入器
預覽​​ 21.0 SQL Server Management Studio 21 Preview

正式推出 SQL Server Management Studio 21 時，將會提供發行通道。

提示

如果您先前已下載啟動載入器檔案，並想要確認其安裝的版本，以下是其安裝方式。 在 Windows 中，開啟 檔案總管，以滑鼠右鍵按鍵按鍵開機檔案，選擇 [屬性]，然後選擇 [詳細數據] 索引卷標。[產品版本] 欄位描述啟動載入器安裝的通道和版本。 版本號碼應一律讀取為「指定專案的最新服務版本」，除非明確指定，否則通道為 Release。 具有產品版本的啟動載入器，指出 SQL Server Management Studio 21 Preview 會在預覽通道上安裝最新版的 SQL Server Management Studio 21 Preview。

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

以程式設計方式叫用 SSMS 啟動載入器或安裝程式時，安裝產品或維護版面設定：

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

所有 SSMS 命令行參數不區分大小寫。

語法範例：vs_ssms.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.SSMS。
--channelUri 可選：在更新指令期間，您可以傳入新的 --channelUri 來變更更新設定位置。 建議與 參數配對 --installPath ，以便明確您要設定的 SSMS 實例。 請參閱 --channelUri 的語法範例
--channelId <id> 通道 ID，例如 SSMS.21.SSMS.Preview。 修改作業需要 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 參數類似，且與其互補。
--addProductLang <language-locale> 選擇性：在安裝或修改命令執行期間，這個可重複參數會指定應該隨產品一起安裝的 UI 語言套件。 如果沒有這個參數，安裝時會使用對應至電腦地區設定的語言套件。 如需詳細資訊，請參閱此頁面上的語言地區設定清單一節。
--removeProductLang <language-locale> 選擇性：在安裝或修改命令執行期間，這個可重複參數會決定應該從產品中移除的 UI 語言套件。 此參數的行為與 --addProductLang 參數類似，且與其互補。
--in <path> 選擇性：回應檔的 URI 或路徑，可包含組態設定。
--quiet 選擇性：與任何命令搭配使用時，此參數可防止系統在執行命令時顯示任何使用者介面。 無論 AllowStandardUserControl 原則如何設定，標準使用者都無法以程式設計方式使用。
--passive, -p 選擇性：此參數會導致使用者介面以非互動式方式顯示。 此參數與 --quiet 參數互斥 (事實上會將其覆寫)。 無論 AllowStandardUserControl 原則如何設定，標準使用者也無法以程式設計方式使用。
--norestart 選擇性：此參數必須與 --passive 或 --quiet 參數成對使用。 在安裝、更新或修改命令期間，--norestart新增參數會延遲任何必要的重新啟動。
--force 選擇性：此參數會強制關閉 SSMS，即使有任何 SSMS 進程正在使用中也一樣。 強制 SSMS 關閉可能會導致工作遺失，因此請謹慎使用。
--installWhileDownloading 選擇性：在安裝、更新或修改命令期間，此參數可讓SSMS同時下載並安裝產品。 這是預設體驗。
--downloadThenInstall 選擇性：在安裝、更新或修改命令期間，此參數會強制SSMS先下載所有檔案，再進行安裝。 它與參數互斥 --installWhileDownloading 。
--nickname <name> 選擇性：在安裝命令執行期間，此參數會定義要指派給所安裝產品的昵稱。 暱稱的長度不能大於 10 個字元。
--removeOos true 選擇性：在安裝、更新或修改命令期間，此參數後面接著 true 或 false，告知 Visual Studio 安裝程式是否刪除所有已轉換至不受支援狀態的已安裝元件。 此行為適用於單一事件。 如果您想要讓此行為持續執行，請將此參數套用至 modifySettings 命令、稍後描述或設定 removeOOS 全域原則。 有助於讓電腦保持安全。
--config <path to *.vsconfig file> 選擇性：在安裝或修改作業期間，您可以使用 --config 參數傳入組態檔，以根據先前儲存的安裝組態檔指定要新增的工作負載、元件或延伸模組。 此作業僅是相加的；它不會刪除檔案中未指定的任何內容。 此外，如果組態檔中指定的項目不適用於產品，則不會新增。 強烈建議指定組態檔的完全限定路徑。 在匯出作業期間，此參數會決定安裝組態檔的儲存位置。
--allowUnsignedExtensions 選擇性：在使用 --config 檔案在 --passive 或 --quiet 內容中執行的安裝或修改作業期間，如果在組態檔中指定了延伸模組，則需要此參數才能載入沒有數位簽章的延伸模組。
--installerOnly 選擇性：在安裝或更新作業期間，此參數會告知 Visual Studio 安裝程式 只安裝本身（安裝程式），而不是 SSMS 產品。 其功能相當於--update參數，但更直觀。 在準備和預先設定用戶端計算機時使用。
--help, --?, -h, -? 顯示此頁面的離線版本。

配置命令和命令列參數

所有配置管理作業 (例如建立或更新配置) 都會使用啟動載入器 exe 來加以執行，並假定該命令為預設安裝 (空白)。 所有配置管理作業都應該從必要的 --layout 初始參數開始。 下表描述可使用命令列用來建立或更新配置的其他參數。

配置參數 描述
--layout <dir> 指定一個目錄以建立或更新離線安裝快取。
--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) 不支援此參數。 更新版面配置時很有用。
--config <path to *.vsconfig file> 選擇性：如果有，SSMS 會使用組態檔的內容來設定配置。 確保指定設定檔的完全限定路徑。
--noWeb 選擇性：如果有，SSMS 安裝程式會使用配置目錄中的檔案來安裝SSMS，而且不會從Web下載任何套件。 如果使用者嘗試安裝不在佈局中的元件，安裝將會失敗。 如果您嘗試部署託管在內部網路網站上的佈局，請勿使用此參數。

重要：如果--noWeb用戶端配置為查看 Microsoft 託管伺服器以取得更新，則此參數不會阻止連接網路的使用者端電腦上的 Visual Studio 安裝程式檢查更新。 在此情況下，--noWeb 只會防止用戶端下載產品套件。
--verify 選擇性：驗證配置的內容。 會列出任何損毀或遺失的檔案。
--fix 選擇性：驗證配置的內容。 如果有任何檔案損毀或遺失，系統會加以重新下載。 必須有網際網路存取權才可修正配置。
--clean <one or more paths to catalogs> 選擇性：從更新為較新版本的版面配置中移除舊版的元件。
進階的配置參數 說明
--channelId <id> 選擇性：所要安裝執行個體的通道識別碼，表示如下：SSMS.21.SSMS.Preview。 channelId 是安裝命令的必要專案，如果 --installPath 已指定，則會忽略其他命令。 如需詳細資訊，請參閱 的--channelId語法範例。
--channelUri <uri> 選擇性︰通道資訊清單的 URI。 此值會 控管更新 的來源位置，以及配置檔案中 response.json 已設定初始值。 如果不想更新， --channelUri 可以指向不存在的檔案（例如 ， --channelUri C:\doesntExist.chman）。 此參數可用於安裝命令；其他命令忽略它。
--installChannelUri <uri> 選擇性︰要用於安裝之通道資訊清單的 URI。 --channelUri 指定的 URI (指定 --installChannelUri 時必須指定) 會用來偵測更新。 此參數可用於安裝命令；其他命令忽略它。
--installCatalogUri <uri> 選擇性︰要用於安裝之目錄資訊清單的 URI。 如有指定，通道管理員會嘗試從此 URI 下載目錄資訊清單，再於安裝通道資訊清單中使用此 URI。 此參數可用來支援離線安裝，在此安裝中會使用已下載的產品目錄來建立配置快取。 此參數可用於安裝命令；其他命令忽略它。
--productId <id> 選擇性：已安裝之執行個體的產品識別碼。 此參數會在一般安裝條件下預先填入。 productId 是 Microsoft.VisualStudio.Product.SSMS。
--keepLayoutVersion 選擇性：將變更套用至配置，而不更新配置中所包含的產品版本。
--locale <language-locale> 選擇性︰變更安裝程式本身的使用者介面顯示語言。 此設定會保存。 如需詳細資訊，請參閱此頁面上的語言地區設定清單一節。
--cache 選擇性︰如果存在，套件將會在安裝之後加以保留，以利後續修復。 這會覆寫要用於後續安裝、修復或修改的全域原則設定。 預設原則是快取套件。 若是解除安裝命令，則會略過此項。
--nocache 選擇性︰如果存在，則會在安裝或修復後刪除套件。 只有在需要時才會再次下載套件，但會在使用後再次加以刪除。 這會覆寫要用於後續安裝、修復或修改的全域原則設定。 預設原則是快取套件。 若是解除安裝命令，則會略過此項。
--noUpdateInstaller 選擇性：如果有，則防止安裝程式在指定時 quiet 自行更新。 安裝程式會失敗命令，並在需要安裝程式更新時，使用 --noUpdateInstaller quiet 指定時傳回非零結束代碼。
--path <name>=<path> 選擇性：用來指定安裝的自訂安裝路徑。 支援的路徑名稱為 shared、cache 和 install。
--path cache=<path> 選擇性：使用您指定用於下載安裝檔案的位置。 此位置只能在第一次安裝 SSMS 時設定。 範例: --path cache="C:\SSMS\cache"
--path shared=<path> 選擇性：包含並存 SSMS 和 Visual Studio 安裝的共用檔案。 某些工具和 SDK 會安裝到此磁碟機上的位置，而其他一些項目則可能會覆寫此設定並安裝到其他磁碟機。 範例: --path shared="C:\VS\shared"

重要事項：這隻能在第一次安裝 SSMS 或 Visual Studio 時設定一次。
--path install=<path> 選擇性：相當於 –-installPath。 特別是 --installPath "C:\SSMS" 與 --path install="C:\SSMS" 相等。 一次只能使用其中一個命令。

ModifySettings 命令和命令列參數

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

命令 說明
modifySettings 動詞用來修改特定SS實例的更新設定。
modifySettings 參數 說明
--installPath <dir> 建議 使用 來指定要採取行動的 SSMS 實例。
--newChannelUri 必要︰通道資訊清單的 URI。 這個值會指定下一個更新來源位置。 如果不想更新， --channelUri 可以指向不存在的檔案（例如 ， --channelUri C:\doesNotExist.chman）。
--channelUri 舊通道資訊清單的 URI。 如果未知， --installPath 可以使用 。 必須使用 搭配 --productId 來識別要採取行動的正確實例。
--productId <id> 如果 --channelUri 已指定 ，且用來識別要採取行動的正確實例，則必須使用 。 productId 是 Microsoft.VisualStudio.Product.SSMS。
--includeRecommended 選擇性：在modifySettings命令期間，此參數（必須在它之後立即有 true 或 false 一字）告訴 SSMS 安裝程式，在 [更新設定] 對話框中停用 [為已安裝的工作負載新增建議元件] 功能。
--quiet 選擇性：此參數可防止系統在執行命令時顯示任何使用者介面。 無法供標準使用者以程式設計方式使用。
--removeOos true 選擇性：在modifySettings命令期間，此參數（必須緊接在它之後的 true 或 false 一詞）會指示SS安裝程式 持續 移除所有已轉換為不支持狀態的已安裝元件。 有助於讓電腦保持安全。

語法範例：

C:\>"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modifySettings --installPath "C:\Program Files\Microsoft SQL Server Management Studio 21\Preview" --newChannelUri https://aka.ms/ssms/21/preview/channel --removeOos true

 C:\>"C:\Program Files\Microsoft SQL Server Management Studio 21\Preview\vs_ssms.exe" modifySettings --channelUri https://aka.ms/ssms/21/preview/channel --productId Microsoft.SSMS.Product.Community --newChannelUri \\layoutserver\share\path\channelmanifest.json --removeOos true --quiet

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

可供更新的通道會在用戶端上快取，而且經過一段時間后，它們會產生雜亂。 您可以開啟 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"

語言地區設定清單

下表列出可與 和 --removeProductLang 參數搭配--addProductLang使用的語言地區設定。

語言地區設定 語言
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% 目錄中產生幾個記錄檔，顯示安裝進度。 依日期將資料夾排序，然後分別針對啟動載入器、安裝程式應用程式和安裝程式引擎尋找開頭為 ssms_bootstrapper、ssms_client 和 ssms_setup 的檔案。

支援或疑難排解

有時可能會發生一些問題。 如果您的 SSMS 安裝失敗，請參閱 針對 SQL Server Management Studio 21 Preview 的安裝和升級問題進行疑難解答，以取得逐步指引。

針對其他已知問題，您可參考 SQL Server 使用者意見反應（在群組下進行的工具篩選）並為產品小組提供意見反應。

相關內容