Instalowanie programu SQL Server Management Studio przy użyciu parametrów wiersza polecenia

Dotyczy:sql ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

SQL Server Management Studio 22 to zaawansowane narzędzie do zarządzania wystąpieniami programu SQL Server, bazami danych Azure SQL Database i wystąpieniami zarządzanymi usługi Azure SQL. Ten artykuł zawiera szczegółowe instrukcje dotyczące używania parametrów wiersza polecenia do instalowania programu SQL Server Management Studio 22, co pozwala na bardziej dostosowany i zautomatyzowany proces instalacji. Niezależnie od tego, czy instalujesz program SQL Server Management Studio 22 po raz pierwszy, czy aktualizujesz istniejącą instalację, te instrukcje zawierają niezbędne kroki, aby osiągnąć cele.

Parametry wiersza polecenia

Podczas instalowania programu SQL Server Management Studio (SSMS) lub z poziomu wiersza polecenia można użyć różnych parametrów wiersza polecenia, aby kontrolować lub dostosowywać instalację do wykonywania następujących akcji:

• Uruchom instalację na kliencie z wybranymi wstępnie opcjami i zachowaniami.
• Automatyzowanie procesu instalacji lub aktualizacji.
• Utwórz lub zachowaj układ sieciowy plików produktu na potrzeby instalowania lub aktualizowania maszyn klienckich.

Użyj następujących zleceń i parametrów wiersza polecenia z następującymi plikami wykonywalnymi lub programami:

• Program rozruchowy, który jest małym plikiem (około 5 MB) (na przykład vs_SSMS.exe), inicjuje proces pobierania i początkowy proces instalacji.
• Instalator programu Visual Studio, który może być już zainstalowany na maszynie i znajduje się w folderze C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe. Instalator należy zainicjować programowo z innego katalogu, w którym znajduje się instalator. Instalator jest zwykle używany do aktualizowania lub modyfikowania poleceń.

Nie wszystkie polecenia lub parametry działają w każdej z tych sytuacji, a wszelkie specjalne zastrzeżenia lub wyjątki są udokumentowane. Ponadto w niektórych scenariuszach być może nie masz dostępu do wszystkich opisanych wcześniej plików wykonywalnych. Na przykład maszyny klienckie mogą mieć dostępny instalator tylko do wykonania w sposób programowy, jeśli SSMS został zainstalowany za pośrednictwem konfiguracji instalacyjnej.

Aby uzyskać najnowsze programy inicjujące dla programu SQL Server Management Studio 22, które zawsze instalują najnowszą wersję wybranego kanału, pobierz jeden z plików w poniższej tabeli. Alternatywnie, aby zainstalować określoną wersję lub określony kanał programu SQL Server Management Studio 22, zobacz Historia wydania programu SQL Server Management Studio. Ten artykuł zawiera linki do ustalonej wersji programu inicjującego dla każdej wydanej wersji serwisowej.

Kanał	Wersja	Program rozruchowy
Uwolnij	22.3.0	SQL Server Management Studio

Wskazówka

Jeśli wcześniej pobrano plik programu inicjjącego, możesz sprawdzić wersję przed próbą zainstalowania. Otwórz Eksploratora plików, kliknij prawym przyciskiem myszy plik programu inicjjącego, wybierz pozycję Właściwości, a następnie wybierz kartę Szczegóły . W polu Wersja produktu opisano kanał i wersję instalowaną przez program inicjujący. Numer wersji zawsze reprezentuje najnowszą wersję obsługi określonej wersji, a kanał ma wartość Wydanie, chyba że określono inaczej. Program inicjujący z wersją produktu o nazwie SQL Server Management Studio 22 instaluje najnowszą wersję SQL Server Management Studio 22 z kanału wydania.

Instalowanie, aktualizowanie, modyfikowanie, naprawianie, odinstalowywanie i eksportowanie poleceń oraz parametrów wiersza polecenia

Podczas programatycznego wywoływania inicjatora SSMS lub instalatora w celu zainstalowania produktu lub utrzymania układu:

• Pierwszy parametr to polecenie (zlecenie), które opisuje operację do wykonania.
• Kolejne opcjonalne parametry wiersza polecenia, wszystkie poprzedzone dwoma kreskami (--), dodatkowo definiują sposób wykonywania tej operacji.

Wszystkie parametry wiersza polecenia programu SSMS nie rozróżniają wielkości liter.

Przykład składni: vs_SSMS.exe [command] <optional parameters>...

Polecenie	Opis
(puste)	Domyślne polecenie instaluje produkt i jest używane dla wszystkich operacji konserwacji układu.
modify	Modyfikuje zainstalowany produkt.
update	Aktualizuje zainstalowany produkt.
updateall	Aktualizuje wszystkie zainstalowane produkty w kolejności sekwencyjnej. Współpracuje z parametrami --quiet i --passive.
repair	Naprawia zainstalowany produkt.
uninstall	Odinstalowuje zainstalowany produkt.
export	Eksportuje konfigurację instalacji do pliku *.vsconfig.

Ważne

Podczas określania wielu odrębnych obciążeń, składników lub języków należy powtórzyć przełącznik wiersza polecenia --add lub --remove dla każdej z tych pozycji.

Parametry	Opis
--installPath <dir>	Dla domyślnego polecenia instalacji ten parametr jest opcjonalny i opisuje, gdzie instancja jest zainstalowana na maszynie klienckiej. W przypadku innych poleceń, takich jak aktualizacja lub modyfikowanie, ten parametr jest wymagany i określa katalog instalacyjny dla wystąpienia, które ma być użyte.
--productId <id>	Opcjonalne: identyfikator wystąpienia produktu, który jest modyfikowany i używany z --channelId. Wartość productId to Microsoft.VisualStudio.Product.SSMS.
--channelUri	Opcjonalne: w trakcie polecenia aktualizacji można przekazać nowy --channelUri, aby zmienić lokalizację ustawień aktualizacji. Połącz go z parametrem --installPath, aby wystąpienie programu SSMS, który konfigurujesz, było jawne. Zobacz przykłady składni --channelUri.
--channelId <id>	Identyfikator kanału, na przykład SSMS.22.SSMS.Release. channelId jest wymagany w przypadku operacji modyfikowania, a także --productId lub --installPath.
--add <one or more workload or component IDs>	Opcjonalne: W trakcie wykonywania polecenia instalacji lub modyfikacji, ten powtarzalny parametr określa jeden lub więcej identyfikatorów obciążenia lub składnika do dodania. Wymagane składniki artefaktu są zainstalowane, ale nie są to zalecane lub opcjonalne składniki. Inne składniki można kontrolować globalnie przy użyciu parametrów --includeRecommended i --includeOptional . Aby uwzględnić wiele obciążeń lub składników, powtórz polecenie --add (na przykład --add Workload1 --add Workload2). W przypadku bardziej szczegółowej kontrolki można dołączyć ;includeRecommended lub ;includeOptional do identyfikatora (na przykład --add Workload1;includeRecommended lub --add Workload2;includeRecommended;includeOptional).
--all	opcjonalne: podczas instalacji lub modyfikowania polecenia ten parametr powoduje zainstalowanie wszystkich obciążeń i składników produktu.
--allWorkloads	opcjonalne: podczas instalacji lub modyfikowania polecenia ten parametr instaluje wszystkie obciążenia i składniki, ale nie są to zalecane ani opcjonalne składniki.
--includeRecommended	opcjonalne: podczas instalacji lub modyfikowania polecenia ten parametr zawiera zalecane składniki dla wszystkich zainstalowanych obciążeń. Nie zawiera składników opcjonalnych. Obciążenia są określane przy użyciu polecenia --allWorkloads lub --add. Za pomocą parametru --includeRecommended włącz okno dialogowe Ustawienia aktualizacji , aby "dodać zalecane składniki dla zainstalowanych obciążeń podczas aktualizacji". Aby zmienić te ustawienia, zobacz Dostosowywanie ustawień aktualizacji.
--includeOptional	opcjonalne: podczas instalacji lub modyfikowania polecenia ten parametr zawiera opcjonalne składniki dla wszystkich zainstalowanych obciążeń. Nie zawiera zalecanych składników. Obciążenia są określane za pomocą --allWorkloads lub --add.
--addProductLang <language-locale>	Opcjonalne: podczas polecenia instalacji lub modyfikacji ten powtarzalny parametr określa pakiety językowe interfejsu użytkownika, które należy zainstalować z produktem. Jeśli nie istnieje, instalacja używa pakietu językowego odpowiadającego ustawień regionalnych maszyny. Aby uzyskać więcej informacji, zobacz [Lista lokalizacji językowych].
--remove <one or more workload or component IDs>	opcjonalne: Podczas modyfikowania polecenia parametr ten, który można powtórzyć, określa jeden lub więcej identyfikatorów obciążenia albo składnika do usunięcia. Uzupełnia i zachowuje się podobnie do parametru --add.
--addProductLang <language-locale>	Opcjonalne: podczas polecenia instalacji lub modyfikacji ten powtarzalny parametr określa pakiety językowe interfejsu użytkownika, które należy zainstalować z produktem. Jeśli nie istnieje, instalacja używa pakietu językowego odpowiadającego ustawień regionalnych maszyny. Aby uzyskać więcej informacji, zobacz sekcję Lista ustawień regionalnych języka w tym artykule.
--removeProductLang <language-locale>	Opcjonalne: Podczas instalacji lub modyfikacji polecenia ten powtarzalny parametr określa, które pakiety językowe interfejsu użytkownika należy usunąć z produktu. Uzupełnia i zachowuje się podobnie do parametru --addProductLang.
--in <path>	Opcjonalnie: identyfikator URI lub ścieżka do pliku odpowiedzi, który może zawierać ustawienia konfiguracji.
--quiet	Opcjonalnie: ten parametr, w przypadku użycia z dowolnym poleceniem, uniemożliwia wyświetlanie dowolnego interfejsu użytkownika podczas wykonywania polecenia. Użytkownicy standardowi nie mogą używać tego parametru programowo, niezależnie od tego, jak ustawiono zasady AllowStandardUserControl .
--passive, -p	opcjonalne: ten parametr powoduje wyświetlanie interfejsu użytkownika w sposób nieinterakcyjny. Ten parametr jest wzajemnie wykluczający się z (i w rzeczywistości zastępuje) parametrem --quiet. Użytkownicy standardowi nie mogą używać tego parametru programowo, niezależnie od tego, jak ustawiono zasady AllowStandardUserControl .
--norestart	opcjonalne: ten parametr musi być sparowany z parametrami --passive lub --quiet. Podczas instalowania, aktualizowania lub modyfikowania polecenia dodanie parametru --norestart opóźnia wszelkie niezbędne ponowne uruchomienie.
--force	Opcjonalnie: ten parametr wymusza zamknięcie programu SSMS nawet wtedy, gdy jest używany jakikolwiek proces SSMS. Wymuszanie zamknięcia programu SSMS może spowodować utratę pracy, dlatego należy użyć go ostrożnie.
--installWhileDownloading	Opcjonalnie: podczas instalacji, aktualizacji lub modyfikowania polecenia. Ten parametr umożliwia programowi SSMS pobranie i zainstalowanie produktu równolegle. Jest to środowisko domyślne.
--downloadThenInstall	Opcjonalnie: Podczas instalacji, aktualizacji lub modyfikowania polecenia ten parametr wymusza programowi SSMS pobranie wszystkich plików przed ich zainstalowaniem. Jest wzajemnie wykluczający się z parametrem --installWhileDownloading.
--nickname <name>	opcjonalne: podczas polecenia instalacji ten parametr definiuje pseudonim do przypisania do zainstalowanego produktu. Pseudonim nie może być dłuższy niż 10 znaków.
--removeOos true	Parametr opcjonalny: Podczas wykonywania polecenia instalacji, aktualizacji lub modyfikacji, ten parametr, a następnie true lub false, określa, czy Instalator programu Visual Studio ma usunąć wszystkie zainstalowane składniki, które przeszły w stan braku wsparcia. To zachowanie ma zastosowanie w przypadku pojedynczego zdarzenia. Jeśli chcesz, aby to zachowanie było trwałe, zastosuj ten parametr do modifySettings polecenia opisanego później lub skonfiguruj removeOOS zasady globalne. Ten parametr jest przydatny do zapewnienia bezpieczeństwa maszyny.
--config <path to *.vsconfig file>	Opcjonalne: Podczas operacji instalacji lub modyfikacji można przekazać plik konfiguracji za pomocą parametru --config, aby określić obciążenia, komponenty lub rozszerzenia do dodania na podstawie wcześniej zapisanego pliku konfiguracji instalacji. Ta operacja jest tylko addytywne; nie usuwa żadnych elementów, które nie zostały określone w pliku. Ponadto instalator nie dodaje elementów określonych w pliku konfiguracji, które nie mają zastosowania do produktu. Określ w pełni kwalifikowaną ścieżkę do pliku konfiguracji. Podczas operacji eksportowania ten parametr określa lokalizację zapisywania pliku konfiguracji instalacji.
--allowUnsignedExtensions	Opcjonalne: podczas operacji instalacji lub modyfikowania w kontekście --passive lub --quiet przy użyciu pliku --config, jeśli rozszerzenia są określone w pliku konfiguracyjnym, ten parametr jest niezbędny do ładowania rozszerzeń bez podpisu cyfrowego.
--installerOnly	Opcjonalnie: Podczas operacji instalacji lub aktualizacji ten parametr nakazuje Instalatorowi programu Visual Studio zainstalowanie samego siebie (instalatora), a nie produktu SSMS. Jego funkcjonalność odpowiada parametrowi --update, ale bardziej intuicyjnemu. Przeznaczone do użycia podczas wstępnego tworzenia i wstępnego konfigurowania maszyn klienckich.
--help, --?, -h, -?	Wyświetla wersję tego artykułu w trybie offline.

Polecenie dotyczące układu i parametry wiersza polecenia

Wszystkie operacje zarządzania układem, takie jak tworzenie lub aktualizowanie układu, są uruchamiane przy użyciu programu rozruchowego. Te operacje zakładają, że polecenie jest domyślną instalacją (pustą). Należy uruchomić wszystkie operacje zarządzania układem z wymaganym --layout parametrem początkowym. W poniższej tabeli opisano inne parametry, których można użyć do utworzenia lub zaktualizowania układu przy użyciu wiersza polecenia.

parametry układu	Opis
--layout <dir>	Określa katalog, aby utworzyć lub zaktualizować pamięć podręczną instalacji offline.
--lang <one or more language-locales>	Opcjonalnie: Używana z --layout do przygotowania pamięci podręcznej instalacji offline z pakietami zasobów w jednym lub kilku określonych językach. Aby uzyskać więcej informacji, zobacz sekcję Lista ustawień regionalnych języka w tym artykule.
--add <one or more workload or component IDs>	Opcjonalne: Jeden lub więcej identyfikatorów zadań lub składników do dodania. Wymagane składniki artefaktu są zainstalowane, ale nie są to zalecane lub opcjonalne składniki. Więcej składników można kontrolować globalnie przy użyciu systemów --includeRecommended i --includeOptional. W przypadku bardziej szczegółowej kontrolki można dołączyć ;includeRecommended lub ;includeOptional do identyfikatora (na przykład --add Workload1;includeRecommended lub --add Workload2;includeOptional). Uwaga: jeśli używasz programu --add, pobierane są tylko określone obciążenia i składniki oraz ich zależności. Jeśli nie określisz --add, wszystkie obciążenia i składniki zostaną pobrane do układu.
--includeRecommended	OPCJONALNE: Zawiera zalecane składniki dla jakichkolwiek zainstalowanych obciążeń, ale nie składników opcjonalnych. Obciążenia są określane za pomocą --allWorkloads lub --add.
--includeOptional	Opcjonalne: zawiera zalecane i opcjonalne składniki do dowolnych obciążeń uwzględnianych w układzie. Obciążenia są określane za pomocą --add.
--wait	Opcjonalne: Proces czeka na zakończenie instalacji przed zwróceniem kodu wyjścia. wait jest przydatna podczas automatyzowania instalacji, w których należy poczekać na zakończenie instalacji, aby obsłużyć kod powrotny z tej instalacji. Parametr --wait można przekazać tylko do programu inicjującego; instalator (setup.exe) nie obsługuje go. Jest to przydatne podczas aktualizowania układów.
--config <path to *.vsconfig file>	Opcjonalnie: Jeśli istnieje, program SSMS używa zawartości pliku konfiguracji do skonfigurowania układu. Upewnij się, że określono w pełni kwalifikowaną ścieżkę do pliku konfiguracji.
--noWeb	Opcjonalnie: Jeśli jest obecny, instalator programu SSMS używa plików w katalogu layout do zainstalowania programu SSMS i nie pobiera żadnych pakietów z sieci Web. Jeśli użytkownik spróbuje zainstalować składniki, które nie są w układzie, instalacja zakończy się niepowodzeniem. Nie używaj tego parametru, jeśli próbujesz wdrożyć układ hostowany w wewnętrznej witrynie internetowej intranetu. Ważne: parametr --noWeb nie zatrzymuje Instalatora programu Visual Studio na komputerze klienckim połączonym z Internetem przed sprawdzeniem aktualizacji, jeśli klient jest skonfigurowany do wyszukiwania serwerów hostowanych przez firmę Microsoft pod kątem aktualizacji. W takim przypadku --noWeb po prostu uniemożliwia klientowi pobieranie pakietów produktów.
--verify	Opcjonalne: Sprawdź zawartość układu. Zostaną wyświetlone wszystkie uszkodzone lub brakujące pliki.
--fix	Opcjonalne: Sprawdź zawartość układu. Jeśli jakiekolwiek pliki są uszkodzone lub brakuje, zostaną one pobrane ponownie. Aby naprawić układ, wymagany jest dostęp do Internetu.
--clean <one or more paths to catalogs>	Opcjonalnie: usuwa stare wersje składników z układu zaktualizowanego do nowszej wersji.

zaawansowane parametry układu	Opis
--channelId <id>	opcjonalne: identyfikator kanału dla instancji, która ma być zainstalowana, reprezentowany jako SSMS.22.SSMS.Release. channelId jest wymagany dla polecenia instalacji i ignorowany dla innych poleceń, jeśli --installPath jest określony. Aby uzyskać więcej informacji, zobacz przykłady składni programu --channelId.
--channelUri <uri>	Opcjonalne: identyfikator URI manifestu kanału. Ta wartość określa lokalizację źródłową aktualizacji , a początkowa wartość jest skonfigurowana w pliku układu response.json . Jeśli nie chcesz aktualizacji, --channelUri może wskazywać na nieistniejący plik (na przykład --channelUri C:\doesntExist.chman). Tego parametru można użyć dla polecenia instalacji. Inne polecenia ignorują je.
--installChannelUri <uri>	Opcjonalny: Identyfikator URI manifestu kanału do użycia na potrzeby instalacji. Identyfikator URI określony przez --channelUri (który należy określić, kiedy --installChannelUri jest określony) jest używany do wykrywania aktualizacji. Tego parametru można użyć dla polecenia instalacji. Inne polecenia ignorują je.
--installCatalogUri <uri>	opcjonalne: identyfikator URI manifestu katalogu do użycia na potrzeby instalacji. Jeśli zostanie określone, menedżer kanału próbuje pobrać manifest katalogu z tego identyfikatora URI, zanim użyje go w manifeście kanału instalacji. Ten parametr obsługuje instalację w trybie offline, w której pamięć podręczna układu jest tworzona z już pobranym wykazem produktów. Tego parametru można użyć dla polecenia instalacji. Inne polecenia ignorują je.
--productId <id>	opcjonalne: Identyfikator produktu dla wystąpienia, które jest zainstalowane. Ten parametr jest automatycznie wypełniany w zwykłych warunkach instalacji. Wartość productId to Microsoft.VisualStudio.Product.SSMS.
--keepLayoutVersion	Opcjonalnie: Zastosuj zmiany w układzie bez aktualizowania wersji produktu układu.
--locale <language-locale>	opcjonalne: zmień język wyświetlania interfejsu użytkownika dla samego instalatora. To ustawienie jest utrwalane. Aby uzyskać więcej informacji, zobacz sekcję Lista ustawień regionalnych języka w tym artykule.
--cache	Opcjonalnie: jeśli są obecne, pakiety są przechowywane po zainstalowaniu w celu późniejszej naprawy. To ustawienie zastępuje globalne ustawienie zasad, które ma być używane do kolejnych instalacji, napraw lub modyfikacji. Domyślne zasady to buforowanie pakietów. Te zasady są ignorowane dla polecenia odinstalowania.
--nocache	Opcjonalnie: w przypadku obecności pakiety są usuwane po zainstalowaniu lub naprawie. Są one pobierane ponownie tylko w razie potrzeby i usuwane ponownie po użyciu. To ustawienie zastępuje globalne ustawienie zasad, które ma być używane do kolejnych instalacji, napraw lub modyfikacji. Domyślne zasady to buforowanie pakietów. Te zasady są ignorowane dla polecenia odinstalowania.
--noUpdateInstaller	Opcjonalnie: jeśli jest podany, uniemożliwia instalatorowi aktualizowanie się, gdy określono quiet. Instalator nie wykonuje polecenia i zwraca kod zakończenia niezerowy, jeśli --noUpdateInstaller jest określony wraz z quiet, gdy wymagana jest aktualizacja instalatora.
--path <name>=<path>	Opcjonalne: służy do określania niestandardowych ścieżek instalacji. Obsługiwane nazwy ścieżek są współużytkowane, buforowane i instalowane.
--path cache=<path>	Opcjonalne: Używa określonej lokalizacji do pobrania plików instalacyjnych. Tę lokalizację można ustawić tylko przy pierwszym zainstalowaniu programu SSMS. Przykład: --path cache="C:\SSMS\cache"
--path shared=<path>	Opcjonalnie: zawiera pliki udostępnione dla równoległych instalacji SSMS i Visual Studio. Niektóre narzędzia i zestawy SDK są instalowane w lokalizacji na tym dysku, podczas gdy inne mogą zmienić to ustawienie i zainstalować się na innym dysku. Przykład: --path shared="C:\VS\shared" Ważne: tę ścieżkę można ustawić tylko raz, przy pierwszym zainstalowaniu programu SSMS lub Visual Studio.
--path install=<path>	opcjonalne: odpowiednik --installPath. W szczególności --installPath "C:\SSMS" i --path install="C:\SSMS" są równoważne. Użyj tylko jednego z tych poleceń jednocześnie.

Polecenie ModifySettings i parametry wiersza polecenia

Możesz zmodyfikować ustawienia aktualizacji i programowo skonfigurować lokalizację źródłową aktualizacji dla danego wystąpienia programu SSMS. Tę zmianę można wprowadzić przy użyciu instalatora lub programu inicjatora na komputerze klienckim. modifySettings Przekaż polecenie i żądany kanał aktualizacji.

Polecenie	Opis
modifySettings	Czasownik używany do modyfikowania ustawień aktualizacji określonego wystąpienia programu SSMS.

zmieńUstawienia parametry	Opis
--installPath <dir>	Zalecane jest użycie do określenia, na której instancji programu SSMS należy działać.
--newChannelUri	Wymagany: identyfikator URI manifestu kanału. Ta wartość określa, gdzie będzie znajdować się następna lokalizacja źródłowa aktualizacji. Jeśli nie chcesz aktualizacji, --channelUri może wskazywać na nieistniejący plik (na przykład --channelUri C:\doesNotExist.chman).
--channelUri	Identyfikator URI starego manifestu kanału. Użyj tego, jeśli nie znasz --installPath. Należy używać z --productId, aby zidentyfikować odpowiednie wystąpienie do działania.
--productId <id>	Użyj tego parametru, jeśli określisz wartość --channelUri. Identyfikuje właściwe wystąpienie do podjęcia działań. Wartość productId to Microsoft.VisualStudio.Product.SSMS.
--includeRecommended	Opcjonalnie: Podczas polecenia modifySettings ten parametr (który musi mieć słowo true lub false natychmiast po nim) informuje instalatora programu SSMS o wyłączeniu funkcji "dodaj zalecane składniki dla zainstalowanych obciążeń podczas aktualizacji" w oknie dialogowym Ustawienie aktualizacji.
--quiet	opcjonalne: ten parametr uniemożliwia wyświetlanie dowolnego interfejsu użytkownika podczas wykonywania polecenia. Nie jest dostępny programowo przez użytkowników standardowych .
--removeOos true	Opcjonalnie: Podczas polecenia modifySettings ten parametr nakazuje instalatorowi programu SSMS trwale usunąć, albo nie usuwać, wszystkich zainstalowanych składników, które stały się niewspierane. To ustawienie musi mieć słowo true lub false zaraz po nim. To ustawienie pomaga zapewnić bezpieczeństwo maszyny.

Przykłady składni:

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

 C:\>"C:\Program Files\Microsoft SQL Server Management Studio 22\Release\vs_SSMS.exe" modifySettings --channelUri https://aka.ms/ssms/22/release/channel --productId Microsoft.VisualStudio.Product.Ssms --newChannelUri \\layoutserver\share\path\channelmanifest.json --removeOos true --quiet

Usuwanie poleceń kanału i parametrów wiersza polecenia

Klient buforuje kanały, z których można się aktualizować, a z upływem czasu mogą one generować nieporządek. Możesz ręcznie usunąć kanały aktualizacji , otwierając Instalator programu Visual Studio, przełączając się na kartę Dostępne i wybierając znak X w prawym górnym rogu karty produktu. Za pomocą polecenia removeChannel można programowo usuwać kanały (na przykład starsze lokalizacje układu). Można uruchomić vswhere programowo na komputerze klienckim, aby określić, które kanały są buforowane na komputerze klienckim.

Polecenie	Opis
removeChannel	Polecenie usunięcia kanału z komputera klienckiego.

parametrów removeChannel	Opis
--channelUri	** Wymagane URI starego manifestu kanału.
--quiet	Opcjonalne Ten parametr uniemożliwia wyświetlanie dowolnego interfejsu użytkownika podczas działania polecenia.
--passive	Opcjonalne Ten parametr zastępuje parametr --quiet. Powoduje to, że interfejs użytkownika pojawia się w sposób nieinterakcyjny.

Przykład składni:

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

Instalowanie lub modyfikowanie programu SSMS za pomocą zestawu winget

Za pomocą narzędzia Menedżer pakietów systemu Windows (winget) do programowego instalowania, modyfikowania lub aktualizowania programu SSMS na swoim komputerze wraz z innymi pakietami zarządzanymi przez winget.

Domyślnie zestaw winget instaluje tylko podstawowe obciążenie programu SSMS.

Przykład składni:

winget install Microsoft.SQLServerManagementStudio.22

Operacje Instalatora programu Visual Studio wymagają obecnie uprawnień administratora, dlatego winget monituje o podniesienie uprawnień, jeśli jest to konieczne, aby ukończyć polecenie. Ponadto należy zamknąć program SSMS, jeśli zamierzasz uaktualnić go do najnowszej wersji.

Lista identyfikatorów obciążeń i identyfikatorów składników

Aby uzyskać listę identyfikatorów obciążeń i składników posortowanych według produktu SSMS, zobacz Identyfikatory obciążeń i składników dla programu SQL Server Management Studio.

Lista wersji językowych

W poniższej tabeli wymieniono wersje językowe, których można używać z parametrami --addProductLang i --removeProductLang.

Locale językowe	Język
cs-cz	Czeski
de-de	Niemiecki
en-us	angielski
es-es	Hiszpański
fr-fr	Francuski
it-it	Włoski
ja-jp	Japoński
ko-kr	Koreański
pl-pl	Polski
pt-br	Portugalski (brazylijski)
ru-ru	Rosyjski
tr-tr	Turecki
zh-cn	Chiński — uproszczony
zh-tw	Chiński — tradycyjny

Kody błędów

W zależności od wyniku operacji zmienna środowiskowa %ERRORLEVEL% jest ustawiona na jedną z następujących wartości:

Wartość	Wynik
0	Operacja została ukończona pomyślnie
740	Wymagane podniesienie
1001	Proces instalatora programu Visual Studio jest uruchomiony
1003	Program SSMS jest używany
1602	Operacja została anulowana
1618	Inna instalacja uruchomiona
1641	Operacja została ukończona pomyślnie, a zainicjowano ponowny rozruch
3010	Operacja została ukończona pomyślnie, ale instalacja wymaga ponownego uruchomienia, zanim będzie można go użyć
5003	Bootstrapper nie mógł pobrać instalatora
5004	Operacja została anulowana
5005	Błąd analizy wiersza polecenia programu inicjatora
5007	Operacja została zablokowana — komputer nie spełnia wymagań
8001	Niepowodzenie kontroli maszyny ARM
8002	Nieudana wstępna weryfikacja pobierania w tle
8003	Awaria z powodu braku dostępnego wsparcia
8004	Błąd katalogu docelowego
8005	Niepowodzenie weryfikacji ładunków źródłowych
8006	Uruchomione procesy programu SSMS
8010	System operacyjny nie jest obsługiwany. Zapoznaj się z wymaganiami systemowym.
-1073720687	Błąd łączności
-1073741510	Instalator programu Microsoft Visual Studio został zakończony (przez użytkownika lub proces zewnętrzny)
Pozostałe (na przykład: -1, 1, 1603	Wystąpiła usterka — sprawdź dzienniki, aby uzyskać więcej informacji

Każda operacja generuje kilka plików dziennika w katalogu %TEMP%, które wskazują postęp instalacji. Posortuj folder według daty i poszukaj plików zaczynających się na ssms_bootstrapper, ssms_clienti ssms_setup, odpowiednio dla bootstrappera, aplikacji instalacyjnej i silnika konfiguracji.

Pomoc techniczna i rozwiązywanie problemów

Czasami coś pójdzie źle. Jeśli instalacja programu SSMS nie powiedzie się, zobacz Rozwiązywanie problemów z instalacją i uaktualnianiem programu SQL Server Management Studio , aby uzyskać szczegółowe wskazówki.

Możesz odwiedzić stronę społeczności deweloperów programu SSMS w celu zapoznania się z innymi znanymi problemami (filtruj, wybierając Tooling w sekcji Grup) oraz aby przekazać swoje uwagi zespołowi odpowiedzialnemu za produkt.

Powiązana zawartość

• Tworzenie instalacji programu SQL Server Management Studio w trybie offline
• Identyfikatory obciążeń i składników dla programu SQL Server Management Studio