共用方式為


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

適用於:SQL ServerAzure SQL DatabaseAzure 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),負責啟動下載程序和初始安裝。
  • 可能已安裝在電腦上的 Visual Studio 安裝程式,且位於資料夾 C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe。 您必須以程式設計方式從安裝程式所在的 不同 目錄起始安裝程式。 安裝程式通常用於更新或修改命令。

並非所有命令或參數都適用於上述每個情況,而且會記錄任何特殊注意事項或例外狀況。 此外,在某些情況下,您可能無法存取先前所述的所有可執行檔。 例如,如果 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 達到一般可用(GA)狀態時,將會提供發行版本頻道。

提示

如果您先前已下載啟動載入器檔案,並想要確認其安裝的版本,以下是其安裝方式。 在 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搭配使用。 productIdMicrosoft.VisualStudio.Product.SSMS
--channelUri 選擇性:執行更新命令時,您可以傳入新的 --channelUri 來變更更新設置的位址。 建議與 --installPath 參數配對,以便明確您要設定的 SSMS 實例。 請參閱 語法範例 --channelUri
--channelId <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 參數互斥(事實上會覆寫 --quiet 參數)。 不論 AllowStandardUserControl 原則 如何設定,標準使用者也無法以程式的方式使用。
--norestart 選擇性:此參數必須與 --passive--quiet 參數配對。 在安裝、更新或修改命令期間,新增 --norestart 參數會延遲任何必要的重新啟動。
--force 選擇性:此參數會強制使 SSMS 關閉,即便有任何 SSMS 程序正在使用中。 強制 SSMS 關閉可能會導致工作遺失,因此請謹慎使用。
--installWhileDownloading 選擇性:在安裝、更新或修改命令期間,此參數可讓 SSMS 同時下載並安裝產品。 這是預設體驗。
--downloadThenInstall 選擇性:在安裝、更新或修改命令期間,此參數會強制 SSMS 先下載所有檔案,再進行安裝。 它與 --installWhileDownloading 參數互斥。
--nickname <name> 選擇性:在安裝命令期間,此參數會定義要指派給已安裝產品的昵稱。 昵稱不能超過 10 個字元。
--removeOos true 選擇性:在安裝、更新或修改命令期間,此參數後面接著 truefalse,告訴 Visual Studio 安裝程式是否要移除所有已移轉至不支持狀態的已安裝元件。 此行為適用於單一事件。 如果您想要讓此行為持續執行,請將此參數套用至 modifySettings 命令、稍後所述,或設定 removeOOS 全域原則。 有助於保護計算機安全。
--config <path to *.vsconfig file> 選擇性:在安裝或修改作業期間,您可以使用 --config 參數傳入組態檔,以根據先前儲存的安裝組態檔來指定要新增的工作負載、元件或延伸模組。 此操作僅限於添加內容;它不會移除檔案中未指定的內容。 此外,組態檔中指定但不適用於產品的項目將不會被新增。 強烈建議您指定組態檔的完整路徑。 在匯出作業期間,此參數會決定儲存安裝組態檔的位置。
--allowUnsignedExtensions 選擇性:在安裝或修改操作期間,若在 --passive--quiet 環境中使用 --config 文件執行,且配置文件中指定了擴充功能,此參數必須用於載入無數位簽章的擴充功能。
--installerOnly 選擇性:在安裝或更新作業期間,此參數會指示 Visual Studio 安裝程式只安裝本身(安裝程式),而不安裝 SSMS 產品。 其功能相當於 --update 參數,但更直覺。 在準備和預先設定用戶端計算機時使用。
--help, --?, -h, -? 顯示此頁面的離線版本。

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

所有版面配置管理作業,例如建立或更新版面配置,都是使用啟動載入器 exe 來執行,並假設命令是預設的 Install (空白)。 所有版面配置管理作業都應該從必要的 --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 下載任何套件。 如果使用者嘗試安裝不在版面配置中的元件,安裝程式會失敗。 如果您嘗試部署裝載於內部內部網路網站上的版面配置,請勿使用此參數。

重要:如果用戶端設定為查看由 Microsoft 托管的伺服器檢查更新,--noWeb 參數不會阻止連接到網際網路的客戶端電腦上的 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> 可選的:所安裝產品實例的識別碼。 此參數會在一般安裝條件下預先填入。 productIdMicrosoft.VisualStudio.Product.SSMS
--keepLayoutVersion 選擇性:將變更套用至版面配置,而不更新版面配置中包含的產品版本。
--locale <language-locale> 選擇性:變更安裝程式本身使用者介面的顯示語言。 此設定會保存。 如需詳細資訊,請參閱此頁面上的 語言地區設定清單 一節。
--cache 選擇性:如果存在,安裝後將保留套件以便用於後續修復。 這會覆寫全域政策設定,以用於後續的安裝、修復或修改。 預設政策是快取套件。 卸載命令會忽略這一項。
--nocache 可選的:如果存在,在安裝或修復後,將會刪除套件。 只有當需要時,才會再次下載它們,並在使用後再刪除一次。 此設定將覆寫用於後續安裝、修復或修改的全域原則設定。 預設政策是快取套件。 卸載命令會忽略此項。
--noUpdateInstaller 選擇性:如果存在,則會在指定 quiet 時防止安裝程式自行更新。 當需要安裝程式更新時,如果同時指定了 --noUpdateInstallerquiet,則安裝程式的命令會失敗並返回非零結束代碼。
--path <name>=<path> 選擇性:用來指定安裝的自定義安裝路徑。 支援的路徑名稱包括共享、快取和安裝。
--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 動詞用來修改特定 SQL Server Management Studio 實例的更新設置。
修改設定參數 描述
--installPath <dir> 建議 用來指定要操作的 SSMS 實例。
--newChannelUri 必要:頻道清單的 URI。 此數值指定更新 的下一个 來源位置。 如果不想更新,--channelUri 可以指向不存在的檔案(例如,--channelUri C:\doesNotExist.chman)。
--channelUri 舊頻道清單的 URI。 如果不知道 --installPath,可以使用。 必須與 --productId 搭配使用,用於識別應採取行動的正確實例。
--productId <id> 如果已指定 --channelUri,並且用來識別要採取行動的正確實例,則必須使用 。 productIdMicrosoft.VisualStudio.Product.SSMS
--includeRecommended 選擇性:在modifySettings命令期間,此參數(在更新設定對話框中必須有 true 或 false 這個字)會告訴 SSMS 安裝程式停用 [更新設定] 對話框中的 [新增已安裝工作負載的建議元件] 功能。
--quiet 選擇性:此參數可防止執行命令時顯示任何使用者介面。 標準使用者無法透過程式設計方式使用。
--removeOos true 選擇性:在執行 modifySettings 命令期間,此參數(必須在後面立即有 true 或 false 這個字)會告訴 SSMS 安裝程式 持久地 移除(或不移除)所有已轉換為不再受支援狀態的已安裝元件。 有助於保護計算機安全。

語法範例:

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"

語言區域清單

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

語言-區域 語言
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_bootstrapperssms_clientssms_setup 的檔案。

支援或疑難解答

有時候,事情可能會出錯。 如果您的 SSMS 安裝失敗,請參閱 SQL Server Management Studio 21 Preview 的疑難排解安裝和升級問題,獲取逐步指導。

您可以參考 SSMS 開發人員社群 網站以取得其他已知問題(篩選 群組下的 工具],並提供意見反應給產品小組。