Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für:
SQL ServerAzure SQL-DatenbankVerwaltete Azure SQL-InstanzAzure 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.
Verwenden Sie die folgenden Befehlszeilenverben und Parameter mit den folgenden ausführbaren Dateien oder Programmen:
- Der Setup-Bootstrapper, der die kleine (etwa 5 MB) Datei
vs_SSMS.exedarstellt, 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 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.3.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 Versionsnummer stellt immer die neueste Wartungsversion der angegebenen Version dar, 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 Sie den SSMS-Bootstrapper oder den Installer programmgesteuert aufrufen, 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, die alle durch zwei Gedankenstriche (
--) präfixiert werden, definieren weiter, wie dieser Vorgang geschieht.
Alle SSMS-Befehlszeilenparameter sind nicht Groß-/Kleinschreibung beachten.
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 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. Koppeln Sie ihn mit dem --installPath Parameter, damit die Instanz von SSMS, die Sie konfigurieren, explizit ist. 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 --installPatherforderlich. |
--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 steuern, indem Sie die Parameter --includeRecommended und --includeOptional verwenden. 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 mit --add spezifiziert. 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 --addangegeben. |
--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 Sprachvarianten]. |
--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. Standardbenutzer können diesen Parameter nicht programmgesteuert verwenden, unabhängig davon, wie die AllowStandardUserControl-Richtlinie 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. Standardbenutzer können diesen Parameter nicht programmgesteuert verwenden, unabhängig davon, wie die AllowStandardUserControl-Richtlinie festgelegt wird. |
--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. Dieser Parameter ist 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 fügt das Installationsprogramm keine Elemente hinzu, die in der Konfigurationsdatei angegeben sind, die nicht für das Produkt gelten. Geben Sie den vollqualifizierten Pfad zur Konfigurationsdatei an. 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, wie das Erstellen oder Aktualisieren eines Layouts, werden mit dem Bootstrapper-Programm ausgeführt. Bei diesen Vorgängen wird davon ausgegangen, dass der Befehl die Standardinstallation ist (leer). Sie sollten alle Layoutverwaltungsvorgänge mit dem erforderlichen --layout Anfangsparameter starten. 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 zusammen mit --layout verwendet, um einen Offlineinstallationscache mit Ressourcenpaketen in einer 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 mit --includeRecommended und --includeOptional. Bei feinerer Steuerung können Sie ;includeRecommended oder ;includeOptional an die ID anfügen (z. B. --add Workload1;includeRecommended oder --add Workload2;includeOptional).Hinweis: Bei Verwendung --addwerden nur die angegebenen Workloads und Komponenten und deren Abhängigkeiten heruntergeladen. Wenn Sie nicht angeben --add, 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 --addangegeben. |
--includeOptional |
Optional: Enthält die empfohlenen -Komponenten und die optionalen-Komponenten für alle Arbeitslasten, die im Layout enthalten sind. Die Workloads werden mit --addangegeben. |
--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 Layoutresponse.json-Datei konfiguriert. Wenn Sie keine Aktualisierungen wünschen, 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: Die URI des Kanalmanifests zur Nutzung für die Installation. Der durch --channelUri angegebene URI, den Sie angeben müssen, wenn --installChannelUri angegeben ist, wird verwendet, um 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 unterstützt die Offlineinstallation, 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 aufbewahrt. Diese Einstellung setzt die globale Richtlinieneinstellung außer Kraft, die für nachfolgende Installationen, Reparaturen oder Änderungen verwendet werden soll. 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. Diese Einstellung setzt die globale Richtlinieneinstellung außer Kraft, die für nachfolgende Installationen, Reparaturen oder Änderungen verwendet werden soll. 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. Sie können diesen Speicherort nur bei der ersten Installation von SSMS festlegen. 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: Sie können diesen Pfad nur einmal festlegen, wenn SSMS oder Visual Studio zum ersten Mal installiert ist. |
--path install=<path> |
Optionaler: Entspricht --installPath. Insbesondere sind --installPath "C:\SSMS" und --path install="C:\SSMS" gleichwertig. Verwenden Sie jeweils nur einen dieser Befehle. |
"ModifySettings"-Befehl und Befehlszeilenparameter
Sie können die Updateeinstellungen ändern und den Quellspeicherort von Updates für eine bestimmte Instanz von SSMS programmgesteuert konfigurieren. Sie können diese Änderung vornehmen, indem Sie das Installationsprogramm oder den Bootstrapper auf dem Clientcomputer verwenden. Übergeben Sie den modifySettings Befehl und den gewünschten Updatekanal.
| 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 Sie keine Aktualisierungen wünschen, kann --channelUri auf eine nicht vorhandene Datei verweisen (z. B. --channelUri C:\doesNotExist.chman). |
--channelUri |
Der URI des alten Kanalmanifests. Verwenden Sie es, wenn Sie --installPath nicht kennen. Muss mit --productId verwendet werden, um die richtige Instanz zu identifizieren, auf die eingewirkt werden soll. |
--productId <id> |
Verwenden Sie diesen Parameter, wenn Sie angeben --channelUri. Sie identifiziert die richtige Instanz, auf die sie reagieren soll.
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
Der Client speichert Kanäle, aus denen Sie aktualisieren können, und im Laufe der Zeit können sie Unordnung erzeugen. Sie können Updatekanäle manuell entfernen, indem Sie Visual Studio Installer öffnen, 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
Verwenden Sie das Winget-Tool (Windows Package Manager), um SSMS programmgesteuert auf Ihrem Computer zusammen mit anderen Paketen zu installieren, zu ändern oder zu aktualisieren, die winget verwaltet.
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 müssen Sie SSMS schließen, 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
In der folgenden Tabelle sind die Sprachgebietsschemas aufgeführt, die Sie mit den Parametern --addProductLang und --removeProductLang verwenden 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.