Verwenden von Befehlszeilenparametern zum Installieren von SQL Server Management Studio

2025-05-21

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

SQL Server Management Studio 21 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 21, sodass ein angepasster und automatisierter Installationsprozess möglich ist. Unabhängig davon, ob Sie SQL Server Management Studio 21 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 steuern oder anzupassen und 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. 1 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 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 Bootstrapper für SQL Server Management Studio 21 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 im Versionsverlauf für SQL Server Management Studio. Diese Seite enthält Links zur unveränderbaren Version der Bootstrapper für jedes Wartungsrelease.

Kanal	Version	Bootstrapper
Freigabe	21.0.0	SQL Server Management Studio

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 Bootstrapper mit einer Produktversion, die angibt, dass SQL Server Management Studio 21 die neueste Version von SQL Server Management Studio 21 aus dem Release-Kanal installiert.

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 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 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 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 ID der Produktinstanz, die geändert und mit `--channelId` verwendet wird `productId` ist `Microsoft.VisualStudio.Product.SSMS`.
`--channelUri`	Optional: Während eines Aktualisierungsbefehls können Sie eine neue `--channelUri` übergeben, um den Speicherort der Updateeinstellungen 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 neben `--productId` oder `--installPath`erforderlich.
`--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, 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. 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 von 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 modify-Befehls gibt dieser wiederholbare Parameter eine oder mehrere Workload- 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. Weitere Informationen finden Sie im Abschnitt Liste der Sprachregionalcodes auf dieser Seite.
`--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`	Optionaler: Wird mit einem beliebigen Befehl verwendet, verhindert dieser Parameter, dass eine Benutzeroberfläche angezeigt wird, während der Befehl ausgeführt 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, 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 das Standarderlebnis.
`--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>`	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 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 eine Konfigurationsdatei mithilfe des Parameters `--config` übergeben, um die Workloads, Komponenten oder Erweiterungen anzugeben, die basierend auf einer zuvor gespeicherten Installationskonfigurationsdatei hinzugefügt werden sollen. 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 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, -?`	Zeigt eine Offlineversion dieser Seite 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: Wird mit `--layout` verwendet, um einen Offlineinstallationscache mit Ressourcenpaketen für eine oder mehrere der angegebenen Sprachen vorzubereiten. Weitere Informationen finden Sie im Abschnitt Liste der Sprachregionalcodes auf dieser Seite.
`--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. 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 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 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 sie.
`--installChannelUri <uri>`	Optional: Der URI des Kanalmanifests, der für die Installation verwendet werden soll. 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: Der URI des Katalogmanifests, der für die Installation verwendet werden soll. 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>`	Optionaler: Die ID des Produkts für die installierte Instanz Dieser Parameter wird unter normalen Installationsbedingungen vorab aufgefüllt. `productId` ist `Microsoft.VisualStudio.Product.SSMS`.
`--keepLayoutVersion`	Optionaler: Änderungen auf das Layout anwenden, ohne die im Layout 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 Sprachregionalcodes auf 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 besteht darin, Pakete zwischenzuspeichern. Dies 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. 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 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: Dies kann nur einmal und nur bei der Erstinstallation 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, 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`	Optionaler: Dieser Parameter verhindert, dass eine Benutzeroberfläche angezeigt wird, während der Befehl ausgeführt wird. Nicht für die programmgesteuerte Verwendung durch Standardbenutzende 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\Release" --newChannelUri https://aka.ms/ssms/21/release/channel --removeOos true

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

Entfernen Sie Kanalbefehls- 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 programmgesteuert entfernen (z. B. ältere Layoutpositionen), indem Sie den Befehl removeChannel verwenden. 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 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"

Liste der Sprachregionen

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

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

Wert	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	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	Laufende SSMS-Prozesse
8010	Das Betriebssystem wird nicht unterstützt. Weitere Informationen finden Sie unter 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 oder Problembehandlung

Manchmal kann es zu einem Fehler kommen. 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.

Erstellen einer Offlineinstallation von SQL Server Management Studio

Freigeben über