Verwenden von Befehlszeilenparametern zum Installieren von SQL Server Management Studio

Gilt für:SQL Server Azure SQL-Datenbank Verwaltete Azure SQL-Instanz Azure Synapse Analytics

SQL Server Management Studio 22 ist ein leistungsstarkes Tool zum Verwalten von SQL Server-Instanzen, Azure SQL-Datenbanken und von Azure SQL verwalteten Instanzen. Dieser Artikel enthält ausführliche Anweisungen zum Verwenden von Befehlszeilenparametern zum Installieren von SQL Server Management Studio 22, wodurch ein angepasster und automatisierter Installationsprozess ermöglicht wird. Unabhängig davon, ob Sie SQL Server Management Studio 22 zum ersten Mal installieren oder eine vorhandene Installation aktualisieren, stellen diese Anweisungen die erforderlichen Schritte bereit, 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 kontrollieren oder anzupassen, um die folgenden Aktionen auszuführen:

Starten Sie die Installation auf dem Client mit bestimmten Optionen und Verhaltensweisen, die vorab ausgewählt wurden.
Automatisieren Sie den Installations- oder Aktualisierungsprozess.
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:

Der Setup-Bootstrapper, bei dem es sich um die kleine Datei (z. B. ca. 5 MB) handelt, vs_SSMS.exedie 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.exe befindet. Sie müssen das Installationsprogramm programmgesteuert aus einem anderen Verzeichnis initiieren als dem, 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 Szenarien möglicherweise keinen Zugriff auf alle zuvor beschriebenen ausführbaren Dateien. Zum Beispiel könnten Client-Computer den Installer nur für die programmgesteuerte Ausführung verfügbar haben, wenn SSMS über ein Layout installiert wurde.

Um die neuesten Bootstrapper für SQL Server Management Studio 22 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 22 im Versionsverlauf für SQL Server Management Studio. Dieser Artikel enthält Verknüpfungen zu den korrigierten Version-Bootstraps für jede Wartungsversion.

Kanal	Version	Bootstrapper
Freigabe	22.1.0	SQL Server Management Studio

Tipp

Wenn Sie zuvor eine Bootstrapper-Datei heruntergeladen haben, können Sie die Version überprüfen, bevor Sie versuchen, die Installation zu installieren. Öffnen Sie den Datei-Explorer, klicken Sie mit der rechten Maustaste auf die Bootstrapperdatei, wählen Sie "Eigenschaften" aus, und wählen Sie dann die Registerkarte " Details " aus. Das Feld "Produktversion " beschreibt den Kanal und die Version , die der Bootstrapper installiert. Die Version sollte immer als "neueste Wartungsversion des spezifizierten Elements" gelesen werden, und der Kanal ist "Release", sofern nicht explizit angegeben. Ein Bootstrapper mit der Produktversion mit der Angabe SQL Server Management Studio 22 installiert die neueste Version von SQL Server Management Studio 22 aus dem Releasekanal.

Installieren, aktualisieren, ändern, reparieren, deinstallieren und exportieren von Befehlen und Befehlszeilenparametern

Wenn der SSMS-Bootstrapper oder der Installer programmgesteuert aufgerufen wird, um das Produkt zu installieren oder ein Layout zu pflegen:

Der erste Parameter ist der Befehl (das Verb), der den auszuführenden Vorgang beschreibt.
Die nachfolgenden optionalen Befehlszeilenparameter, alle mit zwei Gedankenstrichen („--“) versehen, definieren weiter, wie diese Operation ablaufen soll.

Alle SSMS-Befehlszeilenparameter sind nicht Groß-/Kleinschreibung beachten.

Syntaxbeispiel: vs_SSMS.exe [command] <optional parameters>...

Befehl	Beschreibung
(leer)	Der Standardbefehl installiert sowohl das Produkt als auch wird er für alle Layout-Wartungsoperationen verwendet.
`modify`	Ändert ein installiertes Produkt.
`update`	Aktualisiert ein installiertes Produkt.
`updateall`	Aktualisiert alle installierten Produkte in sequenzieller Reihenfolge. Funktioniert mit `--quiet`- und `--passive`-Parametern.
`repair`	Repariert ein installiertes Produkt.
`uninstall`	Deinstalliert ein installiertes Produkt.
`export`	Exportiert die Installationskonfiguration in eine `*.vsconfig` Datei.

Von Bedeutung

Wenn Sie mehrere unterschiedliche Arbeitsauslastungen, Komponenten oder Sprachen angeben, müssen Sie den --add- oder --remove-Befehlszeilen-Switch für jedes Element wiederholen.

Parameter	Beschreibung
`--installPath <dir>`	Für den Standardinstallationsbefehl ist dieser Parameter Optional und beschreibt, wo die Instanz auf dem Clientcomputer installiert ist. Bei anderen Befehlen wie Aktualisieren oder Ändern ist dieser Parameter Erforderlich und gibt das Installationsverzeichnis an, auf das die Instanz reagieren soll.
`--productId <id>`	Optional: Die Produkt-ID der Instanz, die geändert wird und mit „`--channelId`“ verwendet wird. `productId` ist `Microsoft.VisualStudio.Product.SSMS`.
`--channelUri`	Optional: Während eines Aktualisierungsbefehls können Sie ein neues „`--channelUri`“ übergeben, um den Speicherort der Aktualisierungseinstellungen zu ändern. Empfehlen Sie, mit dem „`--installPath`“-Parameter zu koppeln, damit klar ist, welche Instanz von SSMS Sie konfigurieren. Siehe Syntaxbeispiele für `--channelUri`
`--channelId <id>`	Die ID des Kanals, z. B. `SSMS.22.SSMS.Release`. `channelId` ist für Änderungsvorgänge neben `--productId` oder `--installPath`erforderlich.
`--add <one or more workload or component IDs>`	Optional: Während eines Installations- oder Änderungsbefehls gibt dieser wiederholbare Parameter eine oder mehrere Arbeitsauslastungs- oder Komponenten-IDs an, die hinzugefügt werden sollen. Die erforderlichen Komponenten des Artefakts werden installiert, aber nicht die empfohlenen oder optionalen Komponenten. Sie können andere Komponenten global mit `--includeRecommended` und/oder `--includeOptional` Parametern steuern. Um mehrere Arbeitslasten oder Komponenten einzuschließen, wiederholen Sie den befehl `--add` (z. B. `--add Workload1 --add Workload2`). Bei feinerer Steuerung können Sie `;includeRecommended` oder `;includeOptional` an die ID anfügen (z. B. `--add Workload1;includeRecommended` oder `--add Workload2;includeRecommended;includeOptional`).
`--all`	Optionaler: Während eines Installations- oder Änderungsbefehls bewirkt dieser Parameter, dass alle Arbeitslasten und Komponenten für das Produkt installiert werden.
`--allWorkloads`	Optional: Während eines Installations- oder Änderungsbefehls installiert dieser Parameter alle Workloads und Komponenten, aber keine empfohlenen oder optionalen Komponenten.
`--includeRecommended`	Optionaler: Während eines Installations- oder Änderungsbefehls enthält dieser Parameter die empfohlenen Komponenten für alle installierten Workloads. Sie enthält nicht die optionalen Komponenten. Die Workloads werden entweder mit `--allWorkloads` oder `--add`angegeben. Durch die Verwendung des `--includeRecommended`-Parameters aktivieren Sie Ihr Update-Einstellungen-Dialogfeld, um „empfohlene Komponenten für installierte Arbeitsauslastungen beim Aktualisieren hinzuzufügen“. Informationen zum Ändern dieser Einstellungen finden Sie unter Anpassen der Updateeinstellungen.
`--includeOptional`	Optionaler: Während eines Installations- oder Änderungsbefehls 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>`	Optionaler: Während eines Installations- oder Änderungsbefehls gibt dieser wiederholbare Parameter die Benutzeroberflächen-Sprachpakete an, die mit dem Produkt installiert werden sollen. Wenn sie nicht vorhanden ist, verwendet die Installation das Sprachpaket, das dem Gebietsschema des Computers entspricht. Weitere Informationen finden Sie in der [Liste der Sprachregionen]
`--remove <one or more workload or component IDs>`	Optional: Während eines Änderungsbefehls gibt dieser wiederholbare Parameter eine oder mehrere Arbeitsauslastungs- oder Komponenten-IDs an, die entfernt werden sollen. Sie ergänzt und verhält sich ähnlich wie der `--add` Parameter.
`--addProductLang <language-locale>`	Optionaler: Während eines Installations- oder Änderungsbefehls gibt dieser wiederholbare Parameter die Benutzeroberflächen-Sprachpakete an, die mit dem Produkt installiert werden sollen. Wenn sie nicht vorhanden ist, verwendet die Installation das Sprachpaket, das dem Gebietsschema des Computers entspricht. Für weitere Informationen siehe den Abschnitt Liste der Sprachgebietsschemata in diesem Artikel.
`--removeProductLang <language-locale>`	Optionaler: Während eines Installations- oder Änderungsbefehls bestimmt dieser wiederholbare Parameter die Benutzeroberflächen-Sprachpakete, die aus dem Produkt entfernt werden sollen. Sie ergänzt und verhält sich ähnlich wie der `--addProductLang` Parameter.
`--in <path>`	Optional: Der URI oder Pfad zu einer Antwortdatei, die Konfigurationseinstellungen enthalten kann.
`--quiet`	Optional: Durch die Verwendung dieses Parameters mit einem beliebigen Befehl wird verhindert, dass während der Ausführung des Befehls eine Benutzeroberfläche angezeigt wird. Nicht programmatisch für Standardbenutzer verfügbar, unabhängig davon, wie die Richtlinie AllowStandardUserControl festgelegt wird.
`--passive, -p`	Optionaler: Dieser Parameter bewirkt, dass die Benutzeroberfläche nicht interaktiv angezeigt wird. Dieser Parameter ist mit dem `--quiet`-Parameter unvereinbar und überschreibt diesen tatsächlich. Unabhängig davon, wie die AllowStandardUserControl-Richtlinie festgelegt ist, steht diese Funktion auch Standardbenutzern nicht zur programmgesteuerten Nutzung zur Verfügung.
`--norestart`	Optionaler: Dieser Parameter muss entweder mit den Parametern `--passive` oder `--quiet` gekoppelt werden. Bei einer Installation, Aktualisierung oder Änderung des Befehls verzögert das Hinzufügen des `--norestart` Parameters alle erforderlichen Neustarts.
`--force`	Optional: Dieser Parameter erzwingt das Schließen von SSMS, selbst wenn ein SSMS-Prozess in Nutzung ist. Das Erzwingen des Schließens von SSMS kann zu einem Verlust von Arbeit führen, daher verwenden Sie es mit Vorsicht.
`--installWhileDownloading`	Optional: Während einer Installation, Aktualisierung oder Änderung des Befehls. Dieser Parameter ermöglicht es SSMS, das Produkt parallel herunterzuladen und zu installieren. Dies ist das Standarderlebnis.
`--downloadThenInstall`	Optional: Während eines Installations-, Aktualisierungs- oder Änderungsbefehls erzwingt dieser Parameter, dass SSMS alle Dateien herunterlädt, bevor sie installiert werden. Es besteht ein gegenseitiger Ausschluss vom `--installWhileDownloading` Parameter.
`--nickname <name>`	Optionaler: Während eines Installationsbefehls definiert dieser Parameter den Spitznamen, der einem installierten Produkt zugewiesen werden soll. Der Spitzname darf maximal 10 Zeichen lang sein.
`--removeOos true`	Optionaler: Während eines Installations-, Update- oder Änderungsbefehls weist dieser Parameter, gefolgt von `true` oder `false`, dem Visual Studio-Installer an, ob alle installierten Komponenten entfernt werden sollen, die in einen Nicht-Support-Zustand übergegangen sind. Dieses Verhalten gilt für ein einzelnes Ereignis. Wenn Sie dieses Verhalten persistent machen möchten, wenden Sie diesen Parameter auf den `modifySettings`-Befehl an, der später beschrieben wird, oder konfigurieren Sie die `removeOOS` globale Richtlinie. Nützlich, um die Sicherheit des Computers zu gewährleisten.
`--config <path to *.vsconfig file>`	Optional: Während einer Installations- oder Änderungsoperation können Sie eine Konfigurationsdatei mithilfe des „`--config`“-Parameters übergeben, um die Arbeitsauslastungen, Komponenten oder Erweiterungen hinzuzufügen, basierend auf einer zuvor gespeicherten Installationskonfigurationsdatei. Dieser Vorgang ist nur additiv; sie entfernt nichts, das in der Datei nicht angegeben ist. Außerdem werden elemente, die in der Konfigurationsdatei angegeben sind, die nicht für das Produkt gelten, nicht hinzugefügt. Es wird dringend empfohlen, den vollqualifizierten Pfad zur Konfigurationsdatei anzugeben. Während eines Exportvorgangs bestimmt dieser Parameter den Speicherort zum Speichern der Installationskonfigurationsdatei.
`--allowUnsignedExtensions`	Optionaler: Wenn Erweiterungen in der Konfigurationsdatei angegeben sind und ein Installations- oder Änderungsvorgang in einem `--passive`- oder `--quiet`-Kontext mit einer `--config`-Datei ausgeführt wird, ist dieser Parameter erforderlich, um Erweiterungen ohne digitale Signatur zu laden.
`--installerOnly`	Optional: Während einer Installations- oder Aktualisierungsoperation weist dieser Parameter den Visual Studio-Installer an, nur sich selbst (den Installer) zu installieren und nicht das SSMS-Produkt. Seine Funktionalität entspricht dem `--update` Parameter, aber intuitiver. Gedacht zur Nutzung beim Vorbereiten und Konfigurieren von Clientcomputern.
`--help, --?, -h, -?`	Zeigt eine Offlineversion dieses Artikels an.

Layoutbefehl und Befehlszeilenparameter

Alle Layoutverwaltungsvorgänge, z. B. das Erstellen oder Aktualisieren eines Layouts, werden mit der Bootstrapper-Exe ausgeführt und gehen davon aus, dass der Befehl die Standardinstallation ist (leer). Alle Layoutverwaltungsvorgänge sollten mit dem erforderlichen --layout anfänglichen Parameter 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 zum Erstellen oder Aktualisieren eines Offlineinstallationscaches an.
`--lang <one or more language-locales>`	Optional: Verwendet mit `--layout`, um einen Offline-Installationscache mit Ressourcenpaketen mit der angegebenen oder mehreren angegebenen Sprachen vorzubereiten. Für weitere Informationen siehe den Abschnitt Liste der Sprachgebietsschemata in diesem Artikel.
`--add <one or more workload or component IDs>`	Optional: Eine oder mehrere Workload- oder Komponenten-IDs, die hinzugefügt werden sollen. Die erforderlichen Komponenten des Artefakts werden installiert, aber nicht die empfohlenen oder optionalen Komponenten. Sie können mehr Komponenten global steuern, indem Sie `--includeRecommended` und/oder `--includeOptional`verwenden. Bei feinerer Steuerung können Sie `;includeRecommended` oder `;includeOptional` an die ID anfügen (z. B. `--add Workload1;includeRecommended` oder `--add Workload2;includeOptional`). Hinweis: Wenn `--add` verwendet wird, werden nur die angegebenen Workloads und Komponenten und deren Abhängigkeiten heruntergeladen. Wenn `--add` nicht angegeben ist, werden alle Workloads und Komponenten in das Layout heruntergeladen.
`--includeRecommended`	Optionaler: Enthält die empfohlenen Komponenten für alle installierten Workloads, aber nicht die optionalen Komponenten. Die Workloads werden entweder mit `--allWorkloads` oder `--add`angegeben.
`--includeOptional`	Optional: Enthält die empfohlenen -Komponenten und die optionalen-Komponenten für alle Arbeitslasten, die im Layout enthalten sind. Die Workloads werden mit `--add`angegeben.
`--wait`	Optionaler: Der Vorgang wartet, bis die Installation abgeschlossen ist, bevor ein Ausgangscode zurückgegeben wird. `wait` ist nützlich bei der Automatisierung von Installationen, bei denen man darauf warten muss, dass die Installation abgeschlossen ist, um den Rückgabecode zu verarbeiten. Der parameter `--wait` kann nur an den Bootstrapper übergeben werden; das Installationsprogramm (setup.exe) unterstützt es nicht. Es ist nützlich beim Aktualisieren von Layouts.
`--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 Layout-Verzeichnis, um SSMS zu installieren, und lädt keine Pakete aus dem Web herunter. Wenn ein Benutzer versucht, Komponenten zu installieren, die sich nicht im Layout befinden, schlägt das Setup fehl. Verwenden Sie diesen Parameter nicht, wenn Sie versuchen, ein layout bereitzustellen, das auf einer internen Intranetwebsite gehostet wird. Wichtig: Der parameter `--noWeb` verhindert nicht, dass der Visual Studio Installer auf einem mit dem Internet verbundenen Clientcomputer nach Updates sucht, wenn der Client so konfiguriert ist, dass er auf von Microsoft gehosteten Servern nach Updates sucht. In diesem Fall verhindert `--noWeb` einfach, dass der Client die Produktpakete herunter lädt.
`--verify`	Optional: Überprüfen Sie die Inhalte eines Layouts. Alle beschädigten oder fehlenden Dateien werden aufgelistet.
`--fix`	Optional: Überprüfen Sie die Inhalte eines Layouts. Wenn Dateien beschädigt oder fehlen, werden sie erneut heruntergeladen. Internetzugriff ist erforderlich, um ein Layout zu beheben.
`--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 zu installierende Instanz, dargestellt wie `SSMS.22.SSMS.Release`. `channelId` ist erforderlich für den Befehl installieren und wird für andere Befehle ignoriert, wenn `--installPath` angegeben ist. Weitere Informationen finden Sie unter Syntaxbeispiele von `--channelId`.
`--channelUri <uri>`	Optional: Die URI des Kanal-Manifests. Dieser Wert bestimmt den Speicherort der Updates und der anfängliche Wert wird in der Layout`response.json`-Datei konfiguriert. Wenn Updates nicht gewünscht sind, kann `--channelUri` auf eine nicht existierende Datei verweisen (zum Beispiel `--channelUri C:\doesntExist.chman`). Dieser Parameter kann für den Installationsbefehl verwendet werden; Andere Befehle ignorieren sie.
`--installChannelUri <uri>`	Optional: Die URI des Kanalmanifests zur Nutzung für die Installation. Der durch `--channelUri` angegebene URI (der anzugeben ist, wenn `--installChannelUri` angegeben wird) dient dazu, Updates zu erkennen. Dieser Parameter kann für den Installationsbefehl verwendet werden; Andere Befehle ignorieren sie.
`--installCatalogUri <uri>`	Optional: Die URI des Katalog-Manifests zur Nutzung für die Installation. Wenn angegeben, versucht der Kanal-Manager, das Katalogmanifest aus diesem URI herunterzuladen, bevor der URI im Installationskanalmanifest verwendet wird. Dieser Parameter wird verwendet, um die Offlineinstallation zu unterstützen, bei der der Layoutcache mit dem bereits heruntergeladenen Produktkatalog erstellt wird. Dieser Parameter kann für den Installationsbefehl verwendet werden; Andere Befehle ignorieren sie.
`--productId <id>`	Optional: Die Produkt-ID der Instanz, die installiert ist. Dieser Parameter wird unter normalen Installationsbedingungen voraufgefüllt. `productId` ist `Microsoft.VisualStudio.Product.SSMS`.
`--keepLayoutVersion`	Optional: Änderungen auf das Layout anwenden, ohne die Produktversion des Layouts zu aktualisieren.
`--locale <language-locale>`	Optional: Ändern Sie die Sprache der Benutzeroberfläche für den Installer selbst. Die Einstellung wird beibehalten. Für weitere Informationen siehe den Abschnitt Liste der Sprachgebietsschemata in diesem Artikel.
`--cache`	Optional: Wenn vorhanden, werden Pakete nach der Installation für nachfolgende Reparaturen behalten. Dies überschreibt die globale Richtlinieneinstellung für nachfolgende Installationen, Reparaturen und Änderungen. Die Standardrichtlinie besteht darin, Pakete zwischenzuspeichern. Diese Richtlinie wird für den Deinstallationsbefehl ignoriert.
`--nocache`	Optional:: Wenn vorhanden, werden Pakete nach der Installation oder Reparatur gelöscht. Sie werden nur bei Bedarf erneut heruntergeladen und nach der Verwendung erneut gelöscht. Dies überschreibt die globale Richtlinieneinstellung für nachfolgende Installationen, Reparaturen und Änderungen. Die Standardrichtlinie besteht darin, Pakete zwischenzuspeichern. Diese Richtlinie wird für den Deinstallationsbefehl ignoriert.
`--noUpdateInstaller`	Optional: Wenn vorhanden, verhindert es, dass der Installer sich selbst aktualisiert, wenn „`quiet`“ angegeben ist. Das Installationsprogramm schlägt fehl und gibt einen nicht-null Beendigungscode zurück, wenn `--noUpdateInstaller` zusammen mit `quiet` angegeben wird, sofern ein Installationsprogramm-Update erforderlich ist.
`--path <name>=<path>`	Optional: Wird verwendet, um benutzerdefinierte Installationspfade für die Installation anzugeben. Unterstützte Pfadnamen lauten: „shared“, „cache“ und „install“.
`--path cache=<path>`	Optional: Verwendet den von Ihnen angegebenen Speicherort, um Installationsdateien herunterzuladen. Dieser Speicherort kann nur beim ersten Mal festgelegt werden, wenn SSMS installiert wird. Beispiel: `--path cache="C:\SSMS\cache"`
`--path shared=<path>`	Optional: Enthält freigegebene Dateien für nebeneinander SSMS und Visual Studio Installationen. Einige Tools und SDKs werden an einem Speicherort auf diesem Laufwerk installiert, während andere diese Einstellung überschreiben und auf einem anderen Laufwerk installieren können. Beispiel: `--path shared="C:\VS\shared"` Wichtig: Dieser Pfad kann nur einmal und beim ersten Installieren von SSMS oder Visual Studio festgelegt werden.
`--path install=<path>`	Optionaler: Entspricht `–-installPath`. Insbesondere sind `--installPath "C:\SSMS"` und `--path install="C:\SSMS"` 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. Diese Änderung kann mithilfe des Installers oder des Bootstrappers auf dem Clientcomputer vorgenommen werden, indem der Befehl modifySettings und der gewünschte Updatekanal übergeben werden.

Befehl	Beschreibung
`modifySettings`	Verb zur Änderung der Einstellungen für das Aktualisieren einer bestimmten Instanz von SSMS.

Parameter für Einstellungen ändern	Beschreibung
`--installPath <dir>`	Empfohlen zur Nutzung, um anzugeben, auf welche Instanz von SSMS zugegriffen werden soll.
`--newChannelUri`	Pflichtfeld: Die URI des Kanal-Manifests. Dieser Wert gibt an, wo sich der nächste Quellspeicherort von Updates befindet. Wenn Updates nicht gewünscht sind, kann `--channelUri` auf eine nicht existierende Datei verweisen (zum Beispiel `--channelUri C:\doesNotExist.chman`).
`--channelUri`	Der URI des alten Kanalmanifests. Kann verwendet werden, wenn der `--installPath` unbekannt ist. Muss mit `--productId` verwendet werden, um die richtige Instanz zu identifizieren, auf die eingewirkt werden soll.
`--productId <id>`	Muss verwendet werden, wenn `--channelUri` angegeben ist und zur Identifikation der richtigen Instanz, auf die reagiert werden soll, dient. `productId` ist `Microsoft.VisualStudio.Product.SSMS`.
`--includeRecommended`	Optional: Während eines modifySettings-Befehls gibt dieser Parameter (der unmittelbar danach das Wort true oder false haben muss) dem SSMS-Installer an, die Funktionalität „empfohlene Komponenten für installierte Arbeitsauslastungen beim Update hinzufügen“ im Dialogfeld Update-Einstellung zu deaktivieren.
`--quiet`	Optionaler: Dieser Parameter verhindert, dass eine Benutzeroberfläche angezeigt wird, während der Befehl ausgeführt wird. Nicht für die programmgesteuerte Verwendung durch Standardbenutzer*innen verfügbar.
`--removeOos true`	Optional: Während eines ModifySettings-Befehls weist dieser Parameter dem SSMS-Installationsprogramm an, alle installierten Komponenten, die in einen Außer-Support-Zustand umgestellt wurden, dauerhaft zu entfernen oder nicht zu entfernen. Diese Einstellung muss das Wort "true" oder "false" unmittelbar danach haben. Diese Einstellung trägt dazu bei, 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 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

Entfernen Sie Kanalbefehls- und Befehlszeilenparameter

Kanäle, die verfügbar sind, um vom Cacheclient aktualisiert zu werden, werden auf dem Client zwischengespeichert, und im Laufe der Zeit können sie Clutter erzeugen. Sie können Updatekanäle manuell entfernen, indem Sie den Visual Studio-Installer aufrufen, zur Registerkarte "Verfügbar " wechseln und in der oberen rechten Ecke der Produktkarte das X auswählen. Sie können Kanäle programmgesteuert entfernen (z. B. ältere Layoutpositionen), indem Sie den Befehl removeChannel verwenden. Sie können das vswhere programmgesteuert auf dem Client-Computer ausführen, um festzustellen, welche Kanäle auf dem Client-Computer zwischengespeichert sind.

Befehl	Beschreibung
`removeChannel`	Befehl zum Entfernen eines Kanals vom Clientcomputer.

entfernenKanal Parameter	Beschreibung
`--channelUri`	Erforderlich Die URI des alten Kanal-Manifests.
`--quiet`	Optional Dieser Parameter verhindert, dass eine Benutzeroberfläche angezeigt wird, während der Befehl ausgeführt wird.
`--passive`	Optional Dieser Parameter überschreibt den `--quiet`-Parameter. Dadurch wird die Benutzeroberfläche nicht interaktiv angezeigt.

Syntaxbeispiel:

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

Verwenden von Winget zum Installieren oder Ändern von SSMS

Sie können das Windows Package Manager (Winget)-Tool verwenden, um SSMS programmgesteuert auf Ihrem Computer zusammen mit anderen paketen zu installieren, zu ändern oder zu aktualisieren, die von winget verwaltet werden.

Winget installiert standardmäßig nur die SSMS-Kernarbeitsauslastung.

Syntaxbeispiel:

winget install Microsoft.SQLServerManagementStudio.22

Visual Studio Installer-Vorgänge erfordern derzeit Administratorrechte. Daher fordert Winget Sie auf, Ihre Berechtigungen bei Bedarf zu erhöhen, um den Befehl abzuschließen. Außerdem muss SSMS geschlossen werden, wenn Sie es auf die neueste Version aktualisieren möchten.

Liste der Workload-IDs und Komponenten-IDs

Eine Liste der Arbeitsauslastungs- und Komponenten-IDs, die nach SSMS-Produkt sortiert sind, finden Sie unter Workload- und Komponenten-IDs für SQL Server Management Studio.

Liste der Sprachregionen

Die folgende Tabelle listet die Sprachgebietsschemata auf, 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

Abhängig vom Ergebnis des Vorgangs wird die %ERRORLEVEL% Umgebungsvariable auf einen der folgenden Werte festgelegt:

value	Ergebnis
0	Der Vorgang wurde erfolgreich abgeschlossen.
740	Erhöhung erforderlich
1001	Der Visual Studio-Installationsprozess wird ausgeführt.
1003	SSMS wird verwendet
1602	Der Vorgang wurde abgebrochen.
1618	Ein weiterer Installationsvorgang läuft
1641	Der Vorgang wurde erfolgreich abgeschlossen, und der Neustart wurde initiiert.
3010	Der Vorgang wurde erfolgreich abgeschlossen, die Installation erfordert jedoch einen Neustart, bevor er verwendet werden kann.
5003	Bootstrapper konnte das Installationsprogramm nicht herunterladen.
5004	Der Vorgang wurde abgebrochen.
5005	Bootstrapper-Befehlszeilenanalysefehler
5007	Operation wurde blockiert - der Computer erfüllt die 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	Laufende SSMS-Prozesse
8010	Das Betriebssystem wird nicht unterstützt. Beziehen Sie sich auf die Systemanforderungen.
-1073720687	Konnektivitätsfehler
-1073741510	Microsoft Visual Studio Installer wurde beendet (vom Benutzer oder externen Prozess)
Andere (Beispiel: -1, 1, 1603	Ein Fehlerzustand ist aufgetreten – Überprüfen Sie die Protokolle für weitere Informationen.

Jeder Vorgang generiert mehrere Protokolldateien im %TEMP% Verzeichnis, die den Fortschritt der Installation angeben. Sortieren Sie den Ordner nach Datum, und suchen Sie nach Dateien, die mit ssms_bootstrapper, ssms_clientund ssms_setup für den Bootstrapper, die Installationsprogramm-App bzw. das Setupmodul beginnen.

Support und Problembehandlung

Manchmal gehen die Dinge schief. Wenn ihre SSMS-Installation fehlschlägt, finden Sie unter "Behandeln von Installations- und Upgradeproblemen" für SQL Server Management Studio schrittweise Anleitungen.

Sie können auf die SSMS Developer Community--Website für andere bekannte Probleme verweisen (filtern Sie nach Tooling unter Gruppen) und um Feedback an das Produktteam zu senden.

Feedback

War diese Seite hilfreich?

Last updated on 2025-11-11