Udostępnij przez


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.

Następujące czasowniki i parametry wiersza polecenia mogą być używane z następującymi plikami wykonywalnymi lub programami:

  • Program rozruchowy instalacji, który jest małym plikiem (ok. 5 MB, na przykład vs_SSMS.exe), inicjuje proces pobierania i początkową instalację.
  • 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.1.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 powinien być zawsze odczytywany jako "najnowsza wersja serwisowa tego, co jest określone", a kanał ma wartość Release, chyba że określono jawnie. 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

Gdy uruchamiacz SSMS lub instalator jest uruchamiany programowo, aby zainstalować produkt lub utrzymać układ:

  • Pierwszy parametr to polecenie (zlecenie), które opisuje operację do wykonania.
  • Kolejne opcjonalne parametry wiersza polecenia, wszystkie poprzedzone dwoma kreskami (--), dodatkowo określają, w jaki sposób ta operacja ma się odbywać.

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 zarówno produkt, jak 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. Zaleca się parowanie z parametrem --installPath, aby jednoznacznie wskazać, które wystąpienie programu SSMS konfigurujesz. Zobacz przykłady składni dla , --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/lub --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 za pomocą --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, sprawdź [Listę ustawień 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. Nie są dostępne do użycia programowego przez użytkowników standardowych, niezależnie od ustawień 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. Nie jest również dostępny do programowego użytku dla użytkowników standardowych, bez względu na to, jak ustawiono politykę 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. Przydatne 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 elementy określone w pliku konfiguracji, które nie mają zastosowania do produktu, nie są dodawane. Zdecydowanie zaleca się określenie w pełni kwalifikowanej ścieżki 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 bootstrappera exe i zakładają, że domyślnym poleceniem jest Instalacja (domyślnie puste). Wszystkie operacje zarządzania układem powinny rozpoczynać się od wymaganego --layout parametru początkowego. 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> opcjonalne: używane z --layout do przygotowania pamięci instalacyjnej w trybie offline z pakietami zasobów dla jednego lub więcej określonych języków. 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 --includeRecommended i/lub --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 jest używana --add, pobierane są tylko określone obciążenia i składniki oraz ich zależności. Jeśli --add nie jest określony, wszystkie zadania i składniki są pobierane 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 aktualizacje nie są pożądane, --channelUri może wskazywać nieistniejących plików (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ć po określeniu --installChannelUri) 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 służy do obsługi instalacji w trybie offline, w której cache układu jest tworzony z wykazem produktów już pobranym. 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 opcjonalne: Jeśli występują, pakiety będą przechowywane po zainstalowaniu do późniejszych napraw. Spowoduje to zastąpienie globalnego ustawienia 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 Opcjonalne: Jeśli są obecne, pakiety zostaną usunięte po zainstalowaniu lub naprawie. Zostaną one ponownie pobrane tylko w razie potrzeby i usunięte ponownie po użyciu. Spowoduje to zastąpienie globalnego ustawienia 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 i 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. Jednocześnie można używać tylko jednego z tych poleceń.

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 zmienić przy użyciu instalatora lub programu inicjatora na komputerze klienckim, a następnie przekazać polecenie modifySettings 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 aktualizacje nie są pożądane, --channelUri może wskazywać nieistniejących plików (na przykład --channelUri C:\doesNotExist.chman).
--channelUri Identyfikator URI starego manifestu kanału. Można go użyć, jeśli --installPath nie jest znany. Należy używać z --productId, aby zidentyfikować odpowiednie wystąpienie do działania.
--productId <id> Należy użyć, jeśli --channelUri jest zdefiniowany i służy do identyfikowania odpowiedniego wystąpienia, na którym należy podjąć działanie. 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

Kanały, które są dostępne do aktualizacji, są buforowane na kliencie i w czasie mogą generować bałagan. Możesz ręcznie usunąć kanały aktualizacji , wyświetlają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 wykonywania 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

Narzędzie Menedżer pakietów systemu Windows (winget) umożliwia programowe instalowanie, modyfikowanie lub aktualizowanie programu SSMS na maszynie wraz z innymi pakietami zarządzanymi przez pakiet winget.

Domyślnie winget po prostu instaluje 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 program SSMS musi zostać zamknięty, 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 lokalizacje 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.