Verwenden von Befehlszeilenparametern zum Installieren von SQL Server Management Studio 21 Preview
Gilt für: 
SQL Server Azure SQL-Datenbank Azure SQL Managed Instance Azure Synapse Analytics
SQL Server Management Studio 21 Preview ist ein leistungsstarkes Tool zum Verwalten von SQL Server-Instanzen, Azure SQL-Datenbank und Azure SQL Managed Instance. Dieser Artikel enthält ausführliche Anweisungen zum Verwenden von Befehlszeilenparametern zum Installieren von SQL Server Management Studio 21 Preview, um einen angepassten und automatisierten Installationsprozess zu ermöglichen. Unabhängig davon, ob Sie SQL Server Management Studio 21 Preview zum ersten Mal installieren oder eine vorhandene Installation aktualisieren, enthalten diese Anweisungen die erforderlichen Schritte, um Ihre Ziele zu erreichen.
Befehlszeilenparameter
Wenn Sie SQL Server Management Studio (SSMS) programmgesteuert oder über eine Eingabeaufforderung installieren, können Sie verschiedene Befehlszeilenparameter verwenden, um die Installation zu steuern oder anzupassen und die folgenden Aktionen auszuführen:
- Starten der Installation auf dem Client mit bestimmten, vorab ausgewählten Optionen und Verhaltensweisen
- Automatisieren des Installations- oder Updateprozesses.
- Erstellen oder Verwalten eines Netzwerklayouts der Produktdateien zum Installieren oder Aktualisieren von Clientcomputern
Die folgenden Befehlszeilenverben und -parameter können mit den folgenden ausführbaren Dateien oder Programmen verwendet werden:
- Das Setup-Bootstrapladeprogramm, bei dem es sich um eine kleine Datei (ca. 1 MB) handelt (z. B. vs_ssms.exe), die den Downloadvorgang und die Erstinstallation initiiert
- Der Visual Studio-Installer, der möglicherweise bereits auf dem Computer installiert ist und sich im Ordner
C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exebefindet Sie müssen das Installationsprogramm programmgesteuert aus einem anderen Verzeichnis initiieren, in dem sich das Installationsprogramm befindet. Das Installationsprogramm wird in der Regel für Aktualisierungs- oder Änderungsbefehle verwendet.
Nicht alle Befehle oder Parameter funktionieren in jeder dieser Situationen, und alle speziellen Einschränkungen oder Ausnahmen werden dokumentiert. Darüber hinaus haben Sie in einigen Szenarios möglicherweise keinen Zugriff auf alle diese ausführbaren Dateien, die zuvor genannt wurden. Beispielsweise verfügen Clientcomputer möglicherweise nur über den Installer für die programmgesteuerte Ausführung, wenn SSMS über ein Layout installiert wurde.
Um die neuesten Bootstrapladeprogramme für SQL Server Management Studio 21 Preview zu erhalten, die immer die neueste Version des ausgewählten Kanals installieren, laden Sie eine der Dateien in der folgenden Tabelle herunter. Alternativ finden Sie informationen zum Installieren einer bestimmten Version oder eines bestimmten Kanals von SQL Server Management Studio 21 Preview unter Versionsgeschichte für SQL Server Management Studio. Diese Seite enthält Links zu den Bootstrappern der festen Versionen für jede Wartungsversion.
| Kanal | Version | Bootstrapper |
|---|---|---|
| Vorschau | 21.0 | SQL Server Management Studio 21 Preview |
Der Releasekanal steht zur Verfügung, wenn SQL Server Management Studio 21 allgemein verfügbar ist (General Availability, GA).
Tipp
Wenn Sie zuvor eine Bootstrapladeprogramm-Datei heruntergeladen haben und nun überprüfen möchten, welche Version installiert wird, gehen Sie folgendermaßen vor. Öffnen Sie in Windows den Datei-Explorer, klicken Sie mit der rechten Maustaste auf die Bootstrapladeprogramm-Datei, wählen Sie Eigenschaften aus, und wählen Sie dann die Registerkarte Details aus. Das Feld Produktversion beschreibt den Kanal und die Version, die das Bootstrapladeprogramm installiert. Die Versionsnummer sollte immer als „neueste Wartungsversion des angegebenen Werts“ gelesen werden, und der Kanal ist „Release“, sofern nicht explizit angegeben. Ein Bootstrapladeprogramm mit einer Produktversion, die SQL Server Management Studio 21 Preview besagt, installiert die neueste Version von SQL Server Management Studio 21 Preview im Kanal „Vorschau“.
Installieren, Aktualisieren, Ändern, Reparieren, Deinstallieren und Exportieren von Befehlen und Befehlszeilenparametern
Wenn das SSMS-Bootstrapladeprogramm oder das Installationsprogramm programmgesteuert aufgerufen wird, um das Produkt zu installieren oder ein Layout zu verwalten:
- Der erste Parameter ist der Befehl (das Verb), der den auszuführenden Vorgang beschreibt.
- Die nachfolgenden optionalen Befehlszeilenparameter, denen jeweils zwei Gedankenstriche (
--) vorangestellt werden, definieren näher, wie dieser Vorgang erfolgen soll.
Die Groß-/Kleinschreibung wird bei sämtlichen SSMS-Befehlszeilenparametern nicht beachtet.
Syntaxbeispiel: vs_ssms.exe [command] <optional parameters>...
| Befehl | Beschreibung |
|---|---|
| (leer) | Der Standardbefehl installiert das Produkt und wird für alle Layoutwartungsvorgänge verwendet. |
modify |
Ändert ein installiertes Produkt. |
update |
Aktualisiert ein installiertes Produkt. |
updateall |
Aktualisiert der Reihe nach alle installierten Produkte. Funktioniert mit den Parametern --quiet und --passive. |
repair |
Repariert ein installiertes Produkt. |
uninstall |
Deinstalliert ein installiertes Produkt. |
export |
Exportiert die Installationskonfiguration in eine Datei *.vsconfig. |
Wichtig
Wenn Sie mehrere unterschiedliche Workloads, Komponenten oder Sprachen angeben, müssen Sie den --add- oder --remove-Befehlszeilenparameter für jedes Element wiederholen.
| Parameter | Beschreibung |
|---|---|
--installPath <dir> |
Für den Standard-Installationsbefehl lautet dieser Parameter Optional und beschreibt, wo die Instanz auf dem Client-Rechner installiert wird. Für andere Befehle wie „update“ oder „modify“ ist dieser Parameter erforderlich. Er gibt das Installationsverzeichnis für die Instanz an, für die der Befehl ausgeführt wird. |
--productId <id> |
Optional: Die ID der Produktinstanz, die geändert wird, und die mit --channelId verwendet wird. productId ist Microsoft.VisualStudio.Product.SSMS. |
--channelUri |
Optional: Während eines Aktualisierungsbefehls können Sie eine neue --channelUri eingeben, um den Speicherort der Aktualisierungseinstellungen zu ändern. Die Kopplung mit dem Parameter --installPath wird empfohlen, damit explizit ist, welche Instanz von SSMS Sie konfigurieren. Siehe Syntaxbeispiele für --channelUri |
--channelId <id> |
Die ID des Kanals, z. B. SSMS.21.SSMS.Preview. channelId ist für Änderungsvorgänge erforderlich, zusammen mit --productId oder --installPath. |
--add <one or more workload or component IDs> |
Optional: Während eines install- oder modify-Befehls gibt dieser wiederholbare Parameter eine oder mehrere Workload- oder Komponenten-IDs an, die hinzugefügt werden sollen. Die erforderlichen Komponenten des Artefakts werden installiert, die empfohlenen oder optionalen Komponenten jedoch nicht. Mit den Parametern --includeRecommended und/oder --includeOptional können Sie andere Komponenten global steuern. Wiederholen Sie den --add-Befehl, um mehrere Workloads oder Komponenten einzuschließen (z.B. --add Workload1 --add Workload2). Für eine umfassendere Steuerung können Sie ;includeRecommended oder ;includeOptional an die ID anfügen (z. B. --add Workload1;includeRecommended oder --add Workload2;includeRecommended;includeOptional). |
--all |
Optional: Während eines install- oder modify-Befehls installiert dieser Parameter alle Workloads und Komponenten für das Produkt. |
--allWorkloads |
Optional: Während eines install- oder modify-Befehls installiert dieser Parameter alle Workloads und Komponenten. Dies gilt jedoch nicht für empfohlene oder optionale Komponenten. |
--includeRecommended |
Optional: Während eines Installations- oder Änderungsbefehls enthält dieser Parameter die empfohlenen Komponenten für alle Workloads, die installiert werden. Die optionalen Komponenten sind darin nicht enthalten. Die Workloads werden entweder mit --allWorkloads oder --add angegeben. Mithilfe des --includeRecommended-Parameters ermöglichen Sie es, im Dialogfeld Updateeinstellungen die „empfohlenen Komponenten für installierte Workloads beim Update hinzuzufügen“. Informationen zum Ändern dieser Einstellung finden Sie unter Anpassen der Update-Einstellungen. |
--includeOptional |
Optional: Bei einem Installations- oder Änderungsbefehl enthält dieser Parameter die optionalen Komponenten für alle installierten Workloads. Es enthält nicht die empfohlenen Komponenten. Die Workloads werden entweder mit --allWorkloads oder --add angegeben. |
--addProductLang <language-locale> |
Optional: Während eines install- oder modify-Befehls gibt dieser wiederholbare Parameter die Sprachpakete für die Benutzeroberfläche an, die mit dem Produkt installiert werden sollen. Wird der Parameter nicht angegeben, wird bei der Installation das Sprachpaket verwendet, das dem Gebietsschema des Computers entspricht. Weitere Informationen finden Sie in der [Liste der Sprachumgebungen] |
--remove <one or more workload or component IDs> |
Optional: Während eines modify-Befehls gibt dieser wiederholbare Parameter eine oder mehrere Workload- oder Komponenten-IDs an, die entfernt werden sollen. Er ergänzt den Parameter --add und verhält sich ähnlich wie dieser. |
--addProductLang <language-locale> |
Optional: Während eines install- oder modify-Befehls gibt dieser wiederholbare Parameter die Sprachpakete für die Benutzeroberfläche an, die mit dem Produkt installiert werden sollen. Wird der Parameter nicht angegeben, wird bei der Installation das Sprachpaket verwendet, das dem Gebietsschema des Computers entspricht. Weitere Informationen finden Sie im Abschnitt Liste der Gebietsschemas dieser Seite. |
--removeProductLang <language-locale> |
Optional: Während eines install- oder modify-Befehls gibt dieser wiederholbare Parameter die Sprachpakete für die Benutzeroberfläche an, die aus dem Produkt entfernt werden sollen. Er ergänzt den Parameter --addProductLang und verhält sich ähnlich wie dieser. |
--in <path> |
Optional: Der URI oder Pfad zu einer Antwortdatei, die Konfigurationseinstellungen enthalten kann |
--quiet |
Optional: Dieser Parameter bewirkt bei jedem Befehl, dass während der Ausführung des Befehls keine Benutzeroberfläche angezeigt wird. Nicht verfügbar für die programmatische Verwendung durch Standardbenutzer, unabhängig davon, wie die Richtlinie AllowStandardUserControl eingestellt ist. |
--passive, -p |
Optional: Dieser Parameter bewirkt, dass die Benutzeroberfläche nicht interaktiv angezeigt wird. Dieser Parameter und der Parameter --quiet schließen sich gegenseitig aus (der Parameter „--quiet“ wird vom Parameter „--passive“ sogar überschreiben). Auch nicht für die programmatische Verwendung durch Standardbenutzer verfügbar, unabhängig davon, wie die Richtlinie AllowStandardUserControl eingestellt ist. |
--norestart |
Optional: Dieser Parameter muss mit dem Parameter --passive oder --quiet gekoppelt werden. Während eines install-, update- oder modify-Befehls verzögert das Hinzufügen des Parameters --norestart alle erforderlichen Neustarts. |
--force |
Optional: Dieser Parameter erzwingt, dass SSMS geschlossen wird, auch wenn ein SSMS-Prozess verwendet wird. Das Schließen von SSMS zu erzwingen kann zu Arbeitsverlusten führen. Verwenden Sie ihn daher mit Vorsicht. |
--installWhileDownloading |
Optional: Während eines Installations-, Update- oder Änderungsbefehls ermöglicht dieser Parameter SSMS, das Produkt parallel herunterzuladen und zu installieren. Dies ist der Standardwert. |
--downloadThenInstall |
Optional: Während eines Installations-, Update- oder Änderungsbefehls zwingt dieser Parameter SSMS, alle Dateien herunterzuladen, bevor sie installiert werden. Dieser Parameter und --installWhileDownloading schließen sich gegenseitig aus. |
--nickname <name> |
Optional: Während eines install-Befehls definiert dieser Parameter den Spitznamen, der einem installierten Produkt zugewiesen werden soll. Der Spitzname darf nicht länger als 10 Zeichen sein. |
--removeOos true |
Optional: Während eines Installations-, Aktualisierungs- oder Änderungsbefehls teilt dieser Parameter, gefolgt von true oder false, dem Visual Studio Installer mit, ob alle installierten Komponenten entfernt werden sollen, die in einen nicht mehr unterstützten Status übergegangen sind. Dieses Verhalten gilt für ein einzelnes Ereignis. Wenn Sie dieses Verhalten dauerhaft festlegen möchten, wenden Sie diesen Parameter auf den Befehl modifySettings an, der später beschrieben wird, oder konfigurieren Sie die globale Richtlinie removeOOS. Nützlich, um die Sicherheit des Computers zu gewährleisten. |
--config <path to *.vsconfig file> |
Optional: Während eines Installations- oder Änderungsvorgangs können Sie mit dem Parameter --config eine Konfigurationsdatei übergeben, um die hinzuzufügenden Workloads, Komponenten oder Erweiterungen auf der Grundlage einer zuvor gespeicherten Installationskonfigurationsdatei anzugeben. Dieser Vorgang ist nur additiv; es wird nichts entfernt, was nicht in der Datei angegeben ist. Außerdem werden in der Konfigurationsdatei angegebene Elemente, die nicht auf das Produkt zutreffen, nicht hinzugefügt. Es wird dringend empfohlen, den vollständig qualifizierten Pfad zur Konfigurationsdatei anzugeben. Bei einem Exportvorgang bestimmt dieser Parameter den Speicherort der Installationskonfigurationsdatei. |
--allowUnsignedExtensions |
Optional: Wenn bei einem Installations- oder Änderungsvorgang in einem --passive- oder --quiet-Kontext unter Verwendung einer --config-Datei Erweiterungen in der Konfigurationsdatei angegeben sind, ist dieser Parameter erforderlich, um Erweiterungen ohne digitale Signatur zu laden. |
--installerOnly |
Optional: Während eines Installations- oder Updatevorgangs weist dieser Parameter den Visual Studio-Installer an, nur sich selbst (den Installer) und nicht das SSMS-Produkt zu installieren. Seine Funktionalität entspricht dem --update Parameter, aber intuitiver. Diese Option dient zum Vorbereiten und Vorkonfigurieren von Clientcomputern. |
--help, --?, -h, -? |
Es wird eine Offlineversion dieser Seite angezeigt. |
Layoutbefehle und Befehlszeilenparameter
Alle Layout-Verwaltungsvorgänge, wie z. B. das Erstellen oder Aktualisieren eines Layouts, werden mit der Bootstrapper-Exe ausgeführt, wobei davon ausgegangen wird, dass es sich bei dem Befehl um den Standardbefehl Install (blank) handelt. Alle Vorgänge der Layout-Verwaltung sollten mit dem erforderlichen Startparameter --layout beginnen. In der folgenden Tabelle werden die anderen Parameter beschrieben, die Sie verwenden können, um ein Layout über die Befehlszeile zu erstellen oder zu aktualisieren.
| Layoutparameter | Beschreibung |
|---|---|
--layout <dir> |
Gibt ein Verzeichnis an, in dem ein Offlineinstallationscache erstellt oder aktualisiert werden soll. |
--lang <one or more language-locales> |
Optional: Wird zusammen mit --layout verwendet, um einen Offline-Installationscache mit Ressourcenpaketen mit der angegebenen Sprache oder mehreren angegebenen Sprachen vorzubereiten. Weitere Informationen finden Sie im Abschnitt Liste der Gebietsschemas dieser Seite. |
--add <one or more workload or component IDs> |
Optional: Eine oder mehrere hinzuzufügende Arbeitsauslastungs- oder Komponenten-IDs. Die erforderlichen Komponenten des Artefakts werden installiert, die empfohlenen oder optionalen Komponenten jedoch nicht. Mit --includeRecommended und/oder --includeOptional können Sie weitere Komponenten global steuern. Für eine umfassendere Steuerung können Sie ;includeRecommended oder ;includeOptional an die ID anfügen (z. B. --add Workload1;includeRecommended oder --add Workload2;includeOptional).Hinweis: Bei Verwenden von --add werden nur die angegebenen Workloads und Komponenten sowie deren Abhängigkeiten heruntergeladen. Wenn --add nicht angegeben ist, werden alle Workloads und Komponenten in das Layout heruntergeladen. |
--includeRecommended |
Optional: Enthält die empfohlenen Komponenten für alle zu installierenden Arbeitsauslastungen, aber keine optionalen Komponenten. Die Workloads werden entweder mit --allWorkloads oder --add angegeben. |
--includeOptional |
Optional: Schließt die empfohlenen und optionalen Komponenten für alle Workloads in das Layout ein. Die Workloads werden mit --add angegeben. |
--wait |
Optional: Der Prozess wartet, bis die Installation abgeschlossen ist, bevor er einen Exitcode zurückgibt. wait ist nützlich bei der Automatisierung von Installationen, bei denen man warten muss, bis die Installation beendet ist, um den Rückgabewert der Installation zu verarbeiten. Der Parameter --wait kann nur an den Bootstrapper übergeben werden; das Installationsprogramm (setup.exe) unterstützt ihn nicht. Sie ist nützlich, wenn Layouts aktualisiert werden. |
--config <path to *.vsconfig file> |
Optional: Wenn vorhanden, verwendet SSMS den Inhalt der Konfigurationsdatei, um Ihr Layout zu konfigurieren. Stellen Sie sicher, dass Sie den vollqualifizierten Pfad zur Konfigurationsdatei angeben. |
--noWeb |
Optional: Wenn vorhanden, verwendet das SSMS-Setup die Dateien in Ihrem Layoutverzeichnis, um SSMS zu installieren, und es werden keine Pakete aus dem Web heruntergeladen. Wenn ein Benutzer versucht, Komponenten zu installieren, die nicht im Layout enthalten sind, wird das Setup nicht abgeschlossen. Verwenden Sie diesen Parameter nicht, wenn Sie ein Layout bereitstellen möchten, das auf einer internen Intranetwebsite gehostet wird. Wichtig: Der Parameter --noWeb hält der Visual Studio-Installer auf einem mit dem Internet verbundenen Clientcomputer nicht davon ab, nach Updates zu suchen, wenn der Client dazu konfiguriert wurde, auf von Microsoft gehosteten Servern nach Updates zu suchen. In diesem Fall wird von --noWeb einfach verhindert, dass der Client die Produktpakete herunterlädt. |
--verify |
Optional: Überprüft den Inhalt eines Layouts. Beschädigte oder fehlende Dateien werden aufgelistet. |
--fix |
Optional: Überprüft den Inhalt eines Layouts. Wenn Dateien beschädigt sein oder fehlen sollten, werden sie erneut heruntergeladen. Für die Korrektur eines Layout ist ein Internetzugriff erforderlich. |
--clean <one or more paths to catalogs> |
Optional: Entfernt alte Versionen von Komponenten aus einem Layout, das auf eine neuere Version aktualisiert wird. |
| Erweiterte Layoutparameter | Beschreibung |
|---|---|
--channelId <id> |
Optional: Die ID des Kanals für die Instanz, die installiert wird. Dargestellt wie SSMS.21.SSMS.Preview. channelId ist für den Installationsbefehl erforderlich und wird für andere Befehle ignoriert, wenn --installPath angegeben ist. Weitere Informationen finden Sie unter Syntaxbeispiele für --channelId. |
--channelUri <uri> |
Optional: Der URI des Kanalmanifests. Dieser Wert steuert den Quellspeicherort von Updates, und der Ausgangswert wird in der response.json-Datei des Layouts konfiguriert. Wenn keine Updates erwünscht sind, kann --channelUri auf eine nicht vorhandene Datei verweisen (z. B. --channelUri C:\doesntExist.chman). Dieser Parameter kann für den Installationsbefehl verwendet werden; andere Befehle ignorieren ihn. |
--installChannelUri <uri> |
Optional: Der URI des Kanalmanifests, der für die Installation verwendet werden soll. Der mit --channelUri festgelegte URI (der angegeben werden muss, wenn --installChannelUri angegeben ist) dient zum Ermitteln von Updates. Dieser Parameter kann für den Installationsbefehl verwendet werden; andere Befehle ignorieren ihn. |
--installCatalogUri <uri> |
Optional: Der URI des Katalogmanifests, der für die Installation verwendet werden soll. Wird diese Option angegeben, versucht der Kanal-Manager, das Katalogmanifest von diesem URI herunterzuladen, bevor der URI im Installationskanalmanifest verwendet wird. Dieser Parameter wird zur Unterstützung der Offline-Installation verwendet, bei der der Layout-Cache mit dem bereits heruntergeladenen Produktkatalog erstellt wird. Dieser Parameter kann für den Installationsbefehl verwendet werden; andere Befehle ignorieren ihn. |
--productId <id> |
Optional: Die ID des Produkts für die zu installierende Instanz. Dieser Parameter wird unter normalen Installationsbedingungen vorab aufgefüllt. productId ist Microsoft.VisualStudio.Product.SSMS. |
--keepLayoutVersion |
Optional: Wenden Sie Änderungen auf das Layout an, ohne die darin enthaltene Produktversion zu aktualisieren. |
--locale <language-locale> |
Optional: Ändert die Anzeigesprache der Benutzeroberfläche für den Installer selbst. Die Einstellung wird beibehalten. Weitere Informationen finden Sie im Abschnitt Liste der Gebietsschemas dieser Seite. |
--cache |
Optional: Vorhandene Pakete werden ggf. nach ihrer Installation für nachfolgende Reparaturen gespeichert. Dies überschreibt die globale Richtlinieneinstellung für nachfolgende Installationen, Reparaturen und Änderungen. Die Standardrichtlinie sieht das Zwischenspeichern von Paketen im Cache vor. Dies wird für den Deinstallationsbefehl ignoriert. |
--nocache |
Optional: Vorhandene Pakete werden ggf. nach ihrer Installation oder Reparatur gelöscht. Sie werden nur bei Bedarf erneut heruntergeladen und nach ihrer Verwendung wieder gelöscht. Dies überschreibt die globale Richtlinieneinstellung für nachfolgende Installationen, Reparaturen und Änderungen. Die Standardrichtlinie sieht das Zwischenspeichern von Paketen im Cache vor. Dies wird für den Deinstallationsbefehl ignoriert. |
--noUpdateInstaller |
Optional: Wenn vorhanden, wird verhindert, dass der Installer sich selbst aktualisiert, wenn quiet angegeben wird. Der Installer führt den Befehl mit einem Fehler aus und gibt einen Nicht-Null-Exitcode zurück, wenn --noUpdateInstaller mit quiet angegeben wird, wenn ein Installerupdate erforderlich ist. |
--path <name>=<path> |
Optional: Wird zur Angabe der Standardinstallationspfade für die Installation verwendet. Unterstützte Pfadnamen lauten: „shared“, „cache“ und „install“. |
--path cache=<path> |
Optional: Verwendet den Speicherort, den Sie beim Herunterladen der Installationsdateien angeben. Dieser Speicherort kann nur bei der Erstinstallation von SSMS festgelegt werden. Beispiel: --path cache="C:\SSMS\cache" |
--path shared=<path> |
Optionaler: Enthält freigegebene Dateien für parallele SSMS- und Visual Studio-Installationen. Einige Tools und SDKs werden an einen Speicherort auf diesem Datenträger installiert. Andere überschreiben möglicherweise diese Einstellung und werden auf einen anderen Datenträger installiert. Beispiel: --path shared="C:\VS\shared"Wichtig: Dies kann nur einmal und nur bei der Erstinstallation von SSMS oder Visual Studio festgelegt werden. |
--path install=<path> |
Optional: Entspricht –-installPath. Besonders --installPath "C:\SSMS" und --path install="C:\SSMS" sind gleichwertig. Es kann jeweils nur einer dieser Befehle verwendet werden. |
ModifySettings-Befehl und Befehlszeilenparameter
Sie können die Updateeinstellungen ändern und den Quellspeicherort von Updates für eine bestimmte Instanz von SSMS programmgesteuert konfigurieren, indem Sie entweder den Installer oder das Bootstrapladeprogramm auf dem Clientcomputer verwenden und den Befehl „modifySettings“ und den gewünschten Updatekanal übergeben.
| Befehl | Beschreibung |
|---|---|
modifySettings |
Verb, das zum Ändern der Updateeinstellungen einer bestimmten Instanz von SSMS verwendet wird |
| modifySettings-Parameter | Beschreibung |
|---|---|
--installPath <dir> |
Empfohlen, um anzugeben, für welche Instanz von SSMS eine Aktion erfolgt |
--newChannelUri |
Erforderlich: Der URI des Kanalmanifests. Dieser Wert gibt an, wo sich der nächste Quellspeicherort von Updates befindet. Wenn keine Updates erwünscht sind, kann --channelUri auf eine nicht vorhandene Datei verweisen (z. B. --channelUri C:\doesNotExist.chman). |
--channelUri |
Der URI des alten Kanalmanifests. Kann verwendet werden, wenn --installPath nicht bekannt ist. Muss mit --productId verwendet werden, um die richtige Instanz zu identifizieren, für die eine Aktion erfolgt. |
--productId <id> |
Muss verwendet werden, wenn --channelUri angegeben ist und verwendet wird, um die richtige Instanz zu identifizieren, für die eine Aktion erfolgt. productId ist Microsoft.VisualStudio.Product.SSMS. |
--includeRecommended |
Optional: Während eines modifySettings-Befehls weist dieser Parameter (dem unmittelbar das Wort „true“ oder „false“ folgen muss) den SSMS-Installer an, die Funktionalität „Empfohlene Komponenten für installierte Workloads beim Update hinzufügen“ im Dialogfeld „Updateeinstellung“ zu deaktivieren. |
--quiet |
Optional: Dieser Parameter verhindert, dass während der Ausführung des Befehls eine Benutzeroberfläche angezeigt wird. Nicht für die programmgesteuerte Verwendung durch Standardbenutzer*innen verfügbar. |
--removeOos true |
Optional: Während eines modifySettings-Befehls weist dieser Parameter (dem unmittelbar das Wort „true“ oder „false“ folgen muss) den SSMS-Installer an, alle installierten Komponenten, die nicht mehr unterstützt werden, dauerhaft zu entfernen oder nicht zu entfernen. Nützlich, um die Sicherheit des Computers zu gewährleisten. |
Syntaxbeispiele:
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
Befehl zum Entfernen von Kanälen und Befehlszeilenparameter
Verfügbare Updatekanäle werden auf dem Client zwischengespeichert, und im Laufe der Zeit kann es unübersichtlich werden. Sie können Updatekanäle manuell entfernen, indem Sie den Visual Studio-Installer starten, zur Registerkarte Verfügbar wechseln und in der oberen rechten Ecke der Produktkarte das X auswählen. Sie können Kanäle (z. B. ältere Layoutspeicherorte) programmgesteuert mit dem Befehl removeChannel entfernen. Sie können vswhere programmgesteuert auf dem Clientcomputer ausführen, um zu bestimmen, welche Kanäle auf dem Clientcomputer zwischengespeichert werden.
| Befehl | Beschreibung |
|---|---|
removeChannel |
Befehl zum Entfernen eines Kanals vom Clientcomputer. |
| removeChannel-Parameter | Beschreibung |
|---|---|
--channelUri |
Erforderlich: Der URI des alten Kanalmanifests. |
--quiet |
Optional: Dieser Parameter verhindert, dass während der Ausführung des Befehls eine Benutzeroberfläche angezeigt wird. |
--passive |
Optional Dieser Parameter setzt den Parameter --quiet außer Kraft. Bewirkt, dass die Benutzeroberfläche nicht interaktiv angezeigt wird. |
Syntaxbeispiel:
"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" removeChannel --channelUri "\\\\server\\share\\layoutdirectory\\ChannelManifest.json"
Liste der Gebietsschemas
In der folgenden Tabelle sind die Sprachgebietsschemas aufgeführt, die mit den Parametern --addProductLang und --removeProductLang verwendet werden können.
| Gebietsschema | Sprache |
|---|---|
cs-cz |
Tschechisch |
de-de |
Deutsch |
en-us |
Englisch |
es-es |
Spanisch |
fr-fr |
Französisch |
it-it |
Italienisch |
ja-jp |
Japanisch |
ko-kr |
Koreanisch |
pl-pl |
Polnisch |
pt-br |
Portugiesisch (Brasilien) |
ru-ru |
Russisch |
tr-tr |
Türkisch |
zh-cn |
Chinesisch (vereinfacht) |
zh-tw |
Chinesisch (traditionell) |
Fehlercodes
Je nach Ergebnis des Vorgangs wird die Umgebungsvariable %ERRORLEVEL% auf einen der folgenden Werte festgelegt:
| Wert | Ergebnis |
|---|---|
| 0 | Der Vorgang wurde erfolgreich abgeschlossen. |
| 740 | Rechteerweiterung erforderlich |
| 1001 | Visual Studio-Installer wird ausgeführt. |
| 1003 | Visual Studio wird verwendet. |
| 1602 | Der Vorgang wurde abgebrochen. |
| 1618 | Eine andere Installation wird ausgeführt. |
| 1641 | Der Vorgang wurde erfolgreich abgeschlossen und ein Neustart wurde eingeleitet. |
| 3010 | Der Vorgang wurde erfolgreich abgeschlossen, für die Installation ist jedoch ein Neustart erforderlich, bevor sie verwendet werden kann. |
| 5003 | Fehler bei Bootstrapper beim Herunterladen des Installers |
| 5004 | Der Vorgang wurde abgebrochen. |
| 5005 | Bootstrapper-Befehlszeilen-Analysefehler |
| 5007 | Vorgang blockiert – Computer erfüllt Anforderungen nicht |
| 8001 | Fehler bei ARM-Computerüberprüfung |
| 8002 | Fehler bei Vorabprüfung des Hintergrunddownloads |
| 8003 | Fehler wegen nicht mehr unterstützter Auswahl |
| 8004 | Zielverzeichnisfehler |
| 8005 | Fehler beim Überprüfen der Quellnutzlasten |
| 8006 | Visual Studio-Prozesse werden ausgeführt |
| 8010 | Das Betriebssystem wird nicht unterstützt. Weitere Informationen finden Sie unter Systemanforderungen. |
| -1073720687 | Konnektivitätsfehler |
| -1073741510 | Microsoft Visual Studio-Installer wurde beendet (durch den Benutzer oder einen externen Prozess) |
| Sonstiges (Beispiel: -1, 1, 1603) |
Es ist ein Fehler aufgetreten – Überprüfen Sie die Protokolle für weitere Informationen |
Jeder Vorgang generiert mehrere Protokolldateien im %TEMP%-Verzeichnis, die den Status der Installation angeben. Sortieren Sie die Ordner nach Datum, und suchen Sie Dateien für jeweils den Bootstrapper, die Installer-App und die Setup-Engine, die mit ssms_bootstrapper, ssms_client und ssms_setup beginnen.
Support oder Problembehandlung
Manchmal kann etwas schiefgehen. Bei einem Fehler während der SSMS-Installation finden Sie unter Behandeln von Installations- und Upgradeproblemen für SQL Server Management Studio 21 Preview einen ausführlichen Leitfaden.
Bei anderen Problemen (Filter auf Tools unter Gruppen) können Sie auf SQL Server-Benutzerfeedback verweisen. Außerdem können Sie so Feedback an das Produktteam übermitteln.