Verwenden von Befehlszeilenparametern zum Installieren, Aktualisieren und Verwalten von Visual Studio

Gilt für:Visual Studio Visual Studio für MacVisual Studio Code

Wenn Sie Visual Studio programmgesteuert oder über eine Eingabeaufforderung installieren, können Sie mithilfe verschiedener Befehlszeilenparametern die Installation für folgende Aktionen steuern und anpassen:

• 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 unten beschriebenen Befehlszeilenverben und -parameter sind für die Verwendung mit den folgenden ausführbaren Dateien bzw. Programmen konzipiert:

• Mit dem Setup-Bootstrapper, einer kleinen Datei (ca. 1 MB), die den Downloadvorgang initiiert (z. B. vs_enterprise.exe).
• Mit dem Visual Studio-Installationsprogramm, das möglicherweise bereits auf dem Computer installiert ist und sich im Ordner C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exebefindet. Beachten Sie, dass Sie das Installationsprogramm nicht programmgesteuert aus demselben Verzeichnis initiieren können, in dem es gespeichert ist.
• Mit einem winget-Befehl, der den winget-Switch „--override“ verwendet.
• Mit einem Administratorupdatepaket, das aus dem Microsoft Update-Katalog heruntergeladen werden kann, um Ihr Netzwerklayout programmgesteuert zu aktualisieren. Weitere Informationen hierzu finden Sie im Artikel Aktualisieren oder Ändern Ihres Layouts.

Nicht alle Befehle oder Parameter funktionieren in jeder dieser Situationen. Die Ausnahmen haben wir im Folgenden dokumentiert. Darüber hinaus ist in einigen Szenarien der Zugriff auf alle diese ausführbaren Dateien ggf. nicht möglich. Beispielsweise ist auf Clientcomputern möglicherweise nur das Installationsprogramm für programmgesteuerte Ausführung verfügbar, wenn Visual Studio über ein Layout installiert wurde.

Um die neuesten Bootstrapper für Visual Studio 2022 zu erhalten, die immer die neueste Version des aktuellen Kanals installieren, laden Sie eine der folgenden Dateien herunter. Wenn Sie eine bestimmte Version oder einen bestimmten Kanal von Visual Studio 2022 installieren möchten, wechseln Sie alternativ zur Seite mit dem Releaseverlauf von Visual Studio 2022, die Links zu den Bootstrappern mit fester Version für die einzelnen Wartungsreleases enthält.

Edition	Bootstrapper
Visual Studio 2022 Enterprise	vs_enterprise.exe
Visual Studio 2022 Professional	vs_professional.exe
Visual Studio 2022 Community	vs_community.exe
Visual Studio Build Tools 2022	vs_buildtools.exe

Tipp

Wenn Sie zuvor eine Bootstrapper-Datei heruntergeladen haben und nun überprüfen möchten, welche Version heruntergeladen wird, erfahren Sie es hier. Öffnen Sie in Windows den Datei-Explorer, klicken Sie mit der rechten Maustaste auf die Bootstrapper-Datei, wählen Sie Eigenschaften aus, um dann auf der Registerkarte Details auszuwählen. Das Feld Produktversion beschreibt Kanal und Version, welche der Bootstrapper installieren wird. Die Versionsnummer sollte immer als „neueste Wartungsversion des angegebenen Werts“ gelesen werden, und der Kanal ist Aktuell, sofern nicht explizit angegeben. Daher installiert ein Bootstrapper mit der Produktversion LTSC 17.0 die neueste 17.0.x-Wartungsversion, die im LTSC-Kanal 17.0 verfügbar ist. Ein Bootstrapper mit einer Produktversion, die einfach Visual Studio 2022 besagt, installiert die neueste Version von Visual Studio 2022 auf dem aktuellen Kanal.

Befehle und Befehlszeilenparameter zum Installieren, Aktualisieren, Ändern, Reparieren, Deinstallieren und Exportieren

Wenn Sie den Visual Studio-Bootstrapper oder den -Installer programmgesteuert zur Installation des Produkts oder zur Verwaltung eines Layouts aufrufen, stellt der erste Parameter den Befehl (das Verb) dar, mit dem der gewünschte Vorgang beschrieben wird. Mit den nachfolgenden optionalen Befehlszeilenparametern, denen immer zwei Bindestriche (--) vorangestellt werden, wird zusätzlich definiert, wie dieser Vorgang ausgeführt werden soll. Bei allen Visual Studio-Befehlszeilenparametern wird die Groß-/Kleinschreibung nicht beachtet. Weitere Beispiele finden Sie auf der Seite Beispiele für Befehlszeilenparameter für die Installation von Visual Studio.

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

Befehl	Beschreibung
(leer)	Der Standardbefehl installiert das Produkt und wird für alle Vorgänge zur Layoutverwaltung 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	Exportieren einer Installationsauswahl in eine Installationskonfigurationsdatei

Wichtig

Wenn Sie mehrere Workloads, Komponenten oder Sprachen angeben möchten, müssen Sie den Befehlszeilenswitch --add oder --remove für jedes Element wiederholen.

Parameter	Beschreibung
--installPath <dir>	Für den Standardbefehl „install“ ist dieser Parameter optional. Er beschreibt, wo die Instanz auf dem Clientcomputer 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.
--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. Sie können mit den Parametern --includeRecommended und/oder --includeOptional zusätzliche 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). Weitere Informationen finden Sie auf der Seite Workload and component IDs (Arbeitsauslastungs- und Komponenten-IDs).
--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 möglicherweise Konfigurationseinstellungen enthält.
--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 install- oder modify-Befehls schließt dieser Parameter die empfohlenen Komponenten für alle installierten Workloads ein, jedoch nicht die optionalen Komponenten. Die Workloads werden entweder mit --allWorkloads oder --add angegeben.
--includeOptional	Optional: Während eines install- oder modify-Befehls schließt dieser Parameter die optionalen Komponenten für alle installierten Workloads ein, jedoch nicht die empfohlenen Komponenten. Die Workloads werden entweder mit --allWorkloads oder --add angegeben.
--quiet, -q	Optional: Dieser Parameter bewirkt bei jedem Befehl, dass während der Ausführung des Befehls keine Benutzeroberfläche angezeigt wird. Nicht für die programmgesteuerte Verwendung durch Standardbenutzer*innen verfügbar.
--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). Ebenfalls nicht für die programmgesteuerte Verwendung durch Standardbenutzer*innen verfügbar.
--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: Mit diesem Parameter wird das Schließen von Visual Studio erzwungen. Dies gilt selbst dann, wenn Visual Studio-Prozesse noch verwendet werden. Wenn Sie das Schließen von Visual Studio erzwingen, kann es zum Verlust von Arbeit kommen. Verwenden Sie diese Möglichkeit also mit Vorsicht.
--installWhileDownloading	Optional: Während eines install-, update- oder modify-Befehls ermöglicht dieser Parameter, dass das Produkt von Visual Studio gleichzeitig heruntergeladen und installiert wird. Dies ist der Standardwert.
--downloadThenInstall	Optional: Während eines install-, update- oder modify-Befehls erzwingt dieser Parameter, dass Visual Studio alle Dateien vor der Installation herunterlädt. Dieser Parameter und der Parameter --installWhileDownloading schließen sich gegenseitig aus.
--channelUri	Optional: Während eines Updatebefehls können Sie einen neuen channelUri übergeben, um den Speicherort der Updateeinstellungen zu ändern. Es wird empfohlen, dies mit dem Parameter „--installPath“ zu kombinieren, um ganz deutlich zu machen, welche Instanz von Visual Studio Sie derzeit konfigurieren. Weitere Informationen finden Sie unter Syntaxbeispiele für --channelUri.
--channelId <id>	Die ID des Kanals, dargestellt wie VisualStudio.17.Release. Weitere Informationen finden Sie unter Syntaxbeispiele für --channelId. Dies ist für modify-Vorgänge erforderlich, zusammen mit --productID oder --installPath.
--productId <id>	Optional: Die ID des Produkts für die Instanz, die geändert und in Verbindung mit --channelId verwendet wird. Die productID könnte beispielsweise „Microsoft.VisualStudio.Product.Enterprise“ lauten.
--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.
--productKey	Optional: Während eines install-Befehls definiert dieser Parameter den Product Key, der für ein installiertes Produkt verwendet werden soll. Er besteht aus 25 alphanumerischen Zeichen im Format xxxxxxxxxxxxxxxxxxxxxxxxx.
--removeOos true	Optional: Im Rahmen eines Installations-, Update- oder Änderungsbefehls weist dieser Parameter (der unmittelbar danach das Wort true oder false aufweisen muss) das Visual Studio-Installationsprogramm an, alle installierten Komponenten zu entfernen (oder nicht zu entfernen), die in einen Zustand nach dem Supportende übergehen. Dieses Verhalten gilt für ein einzelnes Ereignis. Wenn Sie dieses Verhalten als dauerhaft festlegen möchten, wenden Sie diesen Parameter auf den Befehl modifySettings an, der unten beschrieben wird, oder konfigurieren Sie die globale removeOOS-Richtlinie. Nützlich, um die Sicherheit des Computers zu gewährleisten.
--config <path>	Optional: Während eines install- oder modify-Vorgangs werden basierend auf einer zuvor gespeicherten Installationskonfigurationsdatei die Workloads und Komponenten ermittelt, die hinzugefügt werden sollen. Dieser Vorgang ist optional und entfernt keine Workloads oder Komponenten, wenn diese nicht in der Datei vorhanden sind. Außerdem werden Elemente, die nicht für das Produkt gelten, nicht hinzugefügt. Während eines Exportvorgangs wird der Speicherort bestimmt, an dem die Installationskonfigurationsdatei gespeichert wird.
--help, --?, -h, -?	Es wird eine Offlineversion dieser Seite angezeigt.

Layoutbefehle und Befehlszeilenparameter

Alle Layoutverwaltungsvorgänge werden mit der ausführbaren Bootstrapper-Datei ausgeführt, und es wird davon ausgegangen, dass es sich bei dem Befehl um die Standardeinstellung zum Installieren (leer) handelt, unabhängig davon, ob Sie ein Layout erstellen oder aktualisieren. Daher sollten alle Layoutverwaltungsvorgänge mit dem ersten erforderlichen Parameter --layout beginnen. In der folgenden Tabelle werden die anderen Parameter beschrieben, die Sie zum Erstellen oder Aktualisieren eines Layouts über die Befehlszeile verwenden können.

Layoutparameter	Beschreibung
--layout <dir>	Gibt ein Verzeichnis an, in dem ein Offlineinstallationscache erstellt oder aktualisiert werden soll. Weitere Informationen finden Sie unter Erstellen einer Netzwerkinstallation von Visual Studio 2017.
--lang <one or more language-locales>	Optional: Wird mit --layout zur Vorbereitung eines Offlineinstallationscaches mit Ressourcenpaketen mit angegebenen Sprachen verwendet. 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. Sie können mit --includeRecommended und/oder --includeOptional zusätzliche 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). Weitere Informationen finden Sie auf der Seite Workload and component IDs (Arbeitsauslastungs- und Komponenten-IDs). 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. Dies ist nützlich beim Automatisieren von Installationen, bei denen auf das Beenden von „install“ gewartet werden muss, um den Rückgabecode von „install“ zu verwenden. Der Parameter --wait kann nur an den Bootstrapper übergeben werden. Er wird vom Installationsprogramm (setup.exe) nicht unterstützt. Er ist besonders beim Aktualisieren von Layouts nützlich. Weitere Beispiele finden Sie hier.
--useLatestInstaller	Optional: Legacyfunktionen, die nur für Visual Studio-Bootstrapper gelten, die älter als April 2023 sind. Alle Bootstrapper, die nach April 2023 ausgeliefert wurden, verwenden standardmäßig das neueste Installationsprogramm. Wenn dieser Parameter vorhanden ist, ist die aktuellste Version des Visual Studio-Installers in Ihrem Layout enthalten, auch wenn sie zu einer neueren Hauptversion des Produkts gehört. Dies kann nützlich sein, wenn Sie neue Features oder Fehlerkorrekturen nutzen möchten, die im aktuellsten Installationsprogramm verfügbar sind. Weitere Informationen finden Sie in der Dokumentation zum Konfigurieren des Layouts zur stetigen Verwendung des neuesten Installationsprogramms.
--config <*.vsconfig>	Optional: Falls vorhanden, verwendet Visual Studio den Inhalt der Konfigurationsdatei, um das Layout zu konfigurieren.
--noWeb	Optional: Das Visual Studio-Setup verwendet ggf. die Dateien in Ihrem Layoutverzeichnis, um Visual Studio zu installieren, und es werden keine Pakete aus dem Web heruntergeladen. Wenn ein*e Benutzer*in versucht, Komponenten zu installieren, die nicht im Layout enthalten sind, ist das Setup nicht erfolgreich. Verwenden Sie diesen Parameter nicht, wenn Sie ein Layout bereitstellen möchten, das auf einer internen Intranetwebsite gehostet wird. Weitere Informationen finden Sie unter Installation auf einem Client ohne Internetzugriff. 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 wurde.

Erweiterte Layoutparameter	Beschreibung
--channelId <id>	Optional: Die ID des Kanals für die Instanz, die installiert wird. Dargestellt wie VisualStudio.17.Release. Diese Option ist für den Befehl „install“ erforderlich und kann für andere Befehle ignoriert werden, 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 der Updates und der Anfangswert wird in der response.json-Datei des Layouts konfiguriert. Mögliche Werte finden Sie in den Syntaxbeispielen zu --channelUri. Wenn keine Updates erwünscht sind, kann --channelUri auf eine nicht vorhandene Datei zeigen (z. B. --channelUri C:\doesntExist.chman). Kann für den Befehl „install“ verwendet werden und wird für andere Befehle ignoriert.
--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. Kann für den Befehl „install“ verwendet werden und wird für andere Befehle ignoriert.
--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 Offlineinstallation verwendet, wobei der Layoutcache mit dem bereits heruntergeladenen Produktkatalog erstellt wird. Kann für den Befehl „install“ verwendet werden und wird für andere Befehle ignoriert.
--productId <id>	Optional: Die Produkt-ID für die Instanz, die installiert wird. Diese ist bei normalen Installationsbedingungen bereits ausgefüllt. Die productID könnte beispielsweise „Microsoft.VisualStudio.Product.Enterprise“ lauten.
--arch all	Optional: Standardmäßig werden Layouts nur mit x64-Produktbinärdateien erstellt. Zum Einbeziehen von ARM-Binärdateien für anwendbare Workloads neben den x64-Binärdateien in einem Layout verwenden Sie den Parameter --arch all oder --arch *. Verwenden Sie zum Erstellen eines Layouts nur aus ARM-Binärdateien --arch arm64.
--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. Unter Deaktivieren oder Verschieben des Paketcaches finden Sie weitere Informationen.
--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. Unter Deaktivieren oder Verschieben des Paketcaches finden Sie weitere Informationen.
--noUpdateInstaller	Optional: Hindert den Installer ggf. daran, sich bei Angabe von „quiet“ selbst zu aktualisieren. Der Befehl wird für den Installer einen Fehler auslösen, und der Installer gibt einen Exitcode ungleich 0 (null) zurück, falls „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 ersten Installation von Visual Studio festgelegt werden. Beispiel: --path cache="C:\VS\cache"
--path shared=<path>	Optional: Enthält freigegebene Dateien für parallele 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: Dieser Parameter kann nur einmal, und zwar bei der ersten Installation von Visual Studio, festgelegt werden.
--path install=<path>	Optional: Entspricht –-installPath. Besonders --installPath "C:\VS" und --path install="C:\VS" 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 Visual Studio programmgesteuert konfigurieren, indem Sie entweder den Installer oder den Bootstrapper auf dem Clientcomputer verwenden und den modifySettings-Befehl zusammen mit dem gewünschten Updatekanal übergeben.

Befehl	Beschreibung
modifySettings	Verb, das zum Ändern der Updateeinstellungen einer bestimmten Instanz von Visual Studio verwendet wird.

modifySettings-Parameter	Beschreibung
--installPath <dir>	Empfohlen, um anzugeben, mit welcher Instanz von Visual Studio agiert werden soll.
--newChannelUri	Erforderlich: Der URI des Kanalmanifests. Dieser Wert gibt an, wo sich der nächste Quellspeicherort von Updates befindet. Mögliche Werte finden Sie in den Syntaxbeispielen zu --channelUri. Wenn keine Updates erwünscht sind, kann --channelUri auf eine nicht vorhandene Datei zeigen (z. B. --channelUri C:\doesntExist.chman).
--channelUri	Der URI des alten Kanalmanifests. Kann verwendet werden, wenn --installPath nicht bekannt ist. Muss in Verbindung mit productID verwendet werden, um die richtige Instanz zu identifizieren, mit der agiert werden soll.
--productId <id>	Muss verwendet werden, wenn --channelUri angegeben ist und wird verwendet, um die richtige Instanz zu identifizieren, mitder agiert werden soll. Die productID könnte beispielsweise „Microsoft.VisualStudio.Product.Enterprise“ lauten.
--quiet, -q	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: Im Rahmen eines modifySettings-Befehls weist dieser Parameter (der unmittelbar danach das Wort true oder false aufweisen muss) das Visual Studio-Installationsprogramm an, alle installierten Komponenten endgültig zu entfernen (oder nicht zu entfernen), die in einen Zustand nach dem Supportende übergehen. 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\Visual Studio\2022\Enterprise" --newChannelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --removeOos true

 C:\>"C:\Program Files\Microsoft\Visual Studio\2022\Enterprise\vs_enterprise.exe" modifySettings --channelUri https://aka.ms/vs/17/release.LTSC.17.0/channel --productID Microsoft.VisualStudio.Product.Enterprise --newChannelUri \\layoutserver\share\path\channelmanifest.json --removeOos true --quiet

Rollbackbefehle und Befehlszeilenparameter

Sie können einen programmgesteuerten Rollback des Updates ausführen, indem Sie das Installationsprogramm auf dem Clientcomputer verwenden und den Rollbackbefehl zusammen mit der Installationspfadinstanz übergeben.

Befehl	Beschreibung
rollback	Befehl zum Rollback einer bestimmten Instanz von Visual Studio auf das zuvor installierte Update. Dieser Befehl funktioniert nicht, wenn DisableRollback aktiviert ist.

Rollbackparameter	Beschreibung
--installPath <dir>	Empfohlen, um anzugeben, mit welcher Instanz von Visual Studio agiert werden soll.

Syntaxbeispiele:

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" rollback -–installPath "C:\Program Files\Microsoft Visual Studio\2022\Enterprise"

Administratorupdatebefehl und zugehörige Befehlszeilenparameter

Sie können ein Administratorupdate aus dem Microsoft Update-Katalog herunterladen und verwenden, um entweder Ihre Clientinstallation oder Ihr Layout zu aktualisieren.

Aktualisieren eines Layouts

Wenn Sie ein Layout auf eine bestimmte Version von Visual Studio aktualisieren, laden Sie einfach das Administratorupdate auf den Computer herunter, auf dem das Layout gehostet wird. Öffnen Sie auf diesem Computer eine Eingabeaufforderung, und führen Sie einen Befehl wie den folgenden aus:

visualstudioupdate-17.0.0to17.1.5.exe layout --layoutPath c:\VSLayout

Aktualisieren eines Clients

Wenn Sie das Administratorupdate in das Installationsverzeichnis auf Ihrem Clientcomputer herunterladen, können Sie einfach auf die Datei doppelklicken, um das Update anzuwenden. Sie können auch ein Befehlsfenster öffnen und einige der folgenden Parameter übergeben, um das Standardverhalten zu ändern.

Konfigurieren des Administratorupdates in SCCM

Wenn Sie das Administratorupdate über Microsoft Endpoint Manager (SCCM) bereitstellen, können Sie das Paket ändern, um das Verhalten mit den unten angegebenen Parametern anzupassen. Sie können die Parameter auch über eine Konfigurationsdatei auf dem Clientcomputer verwalten. Weitere Informationen finden Sie unter Methoden zum Konfigurieren eines Administratorupdates.

Beachten Sie, dass alle Parameter für Administratorupdates standardmäßig im „Updatekontext“ ausgeführt werden, es sei denn, das Layoutverb wird angegeben.

Parameter für Administratorupdates	Beschreibung
--installerUpdateArgs [optional parameters]	Dieser Parameter dient als „Passthrough-Array“ bestimmter Parameter, die für Administratorupdateszenarios relevant sind. Folgende optionale Parameter können für diesen Zweck aktiviert werden: --quiet: Standardparameter für Administratorupdates (wird hier aus Gründen der Vollständigkeit aufgeführt). --passive: Überschreibt den Parameter --quiet. Bewirkt, dass die Benutzeroberfläche nicht interaktiv angezeigt wird. --norestart: Muss in Verbindung mit --quiet oder --passive verwendet werden und bewirkt, dass alle erforderlichen Neustarts verzögert werden. --noWeb: Verhindert, dass Visual Studio im Internet nach Updates für das Produkt sucht. --force: Erzwingt das Schließen von Visual Studio, selbst wenn Visual Studio gerade verwendet wird. Verwenden Sie diesen Parameter mit Vorsicht, da er zu Arbeitsverlusten führen kann. Dieser Parameter darf nur verwendet werden, wenn das Administratorupdate im Benutzerkontext ausgeführt wird. er wird ignoriert, wenn das Administratorupdate im Systemkontext ausgeführt wird. --installWhileDownloading: Ermöglicht, dass das Produkt von Visual Studio gleichzeitig heruntergeladen und installiert wird. Standardparameter für Administratorupdates (wird hier aus Gründen der Vollständigkeit aufgeführt). --keepWindowsUpdateOn: Dieser Parameter verhindert, dass das Installationsprogramm den Windows Update-Agent auf dem Client deaktiviert. Sie sollten diesen Parameter verwenden, wenn Sie ein Administratorupdate aus dem Katalog in SCCM importieren. Möglicherweise müssen Sie außerdem das Timeout des SCCM-Pakets auf einen längeren Zeitraum als die Standardzeit von 10 Minuten festlegen. Wenn Sie den SCCM-Bereitstellungstyp in „Erforderlich“ ändern, wird dieser Parameter nicht benötigt. --downloadThenInstall: Erzwingt, dass Visual Studio alle Dateien vor der Installation herunterlädt. Dieser Parameter und der Parameter --installWhileDownloading schließen sich gegenseitig aus.
--checkPendingReboot	Das Update wird abgebrochen, wenn ein Neustart auf dem Computer aussteht. Dies gilt unabhängig davon, welche Anwendung das Update verursacht hat. Standardmäßig wird nicht nach ausstehenden Neustarts gesucht.

Syntaxbeispiel für die Übergabe von Parametern an ein Administratorupdate:

visualstudioupdate-16.9.0to16.9.4.exe --installerUpdateArgs=--force,--noWeb,--keepWindowsUpdateOn --checkPendingReboot

Befehl zum Entfernen von Kanälen und Befehlszeilenparameter

Kanäle, die für Updates zur Verfügung stehen, werden auf dem Client zwischengespeichert und können mit der Zeit das System unübersichtlich machen. Sie können Update-Kanäle manuell entfernen, indem Sie den Visual Studio-Installer aufrufen, zur Registerkarte Verfügbar wechseln und in der oberen rechten Ecke der Produktkarte auf das X klicken. 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 ermitteln, 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"

Verwenden von winget zum Installieren oder Ändern von Visual Studio

Sie können das „winget“-Tool von des Windows-Paket-Managers verwenden, um Visual Studio programmgesteuert auf Ihren Computern zusammen mit anderen Paketen zu installieren, zu ändern oder zu aktualisieren, die von „winget“ verwaltet werden.

Standardmäßig installiert „winget“ einfach die Visual Studio-Kernworkload.

winget install --id Microsoft.VisualStudio.2022.Community

Wenn Sie jedoch die Installation anpassen und zusätzliche Workloads und Komponenten angeben möchten, die während der Erstinstallation abgerufen werden sollen, können Sie den --override-Switch von winget zusammen mit dem Winget-Befehl install verwenden und eine exportierte VSCONFIG-Datei übergeben, die die Workloads und Komponenten enthält, die hinzugefügt werden sollen:

winget install --id Microsoft.VisualStudio.2022.Community --override "--passive --config c:\my.vsconfig"

Natürlich können Sie Komponenten auch direkt während der Erstinstallation wie folgt einschließen:

 winget install --id Microsoft.VisualStudio.2022.Community --override "--quiet --add Microsoft.Visualstudio.Workload.Azure"

Wenn Sie Visual Studio bereits auf Ihrem Computer installiert haben, können Sie den configure-Befehl von winget zusammen mit dem Visual Studio PowerShell DSC-Anbieter, einer YAML-Datei und einer VSCONFIG-Datei verwenden, um einer vorhandenen Visual Studio-Installation Komponenten hinzuzufügen. Der configure-Befehl von winget fungiert im Wesentlichen als „Änderungsvorgang“ von Visual Studio.

Es ist nicht möglich, den --override-Switch oder den Visual Studio DSC-Anbieter zusammen mit dem upgrade-Befehl von winget zu verwenden, weil upgrade im Wesentlichen nur ein Visual Studio-Updatevorgang fungiert und die neueste Version der Komponenten installiert, die Sie bereits ausgewählt haben. Sie können keine Komponenten über ein Update/Upgrade hinzufügen. Sie müssen configure von winget verwenden, um Komponenten hinzuzufügen.

Beachten Sie, dass der Visual Studio-Installer derzeit Administratorrechte benötigt. winget wird Sie daher auffordern, Ihre Berechtigungen zu erhöhen, wenn dies notwendig sein sollte, um den Befehl auszuführen. Außerdem kann winget derzeit nicht verwendet werden, um mehrere Editionen (d. h. verschiedene SKUs) oder mehrere Instanzen derselben SKU gleichzeitig auf einem Clientcomputer zu installieren. Schließlich muss Visual Studio geschlossen werden, wenn Sie die Anwendung konfigurieren (ändern) möchten, um Komponenten hinzuzufügen oder ein Upgrade auf die neueste Version durchzuführen.

Liste der Arbeitsauslastungs-IDs und Komponenten-IDs

Eine Liste der Arbeitsauslastungs- und Komponenten-IDs, sortiert nach Visual Studio-Produkt, finden Sie auf der Seite Arbeitsauslastungs- und Komponenten-IDs in Visual Studio.

Liste der Gebietsschemas

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	Der Vorgang wurde blockiert – der Computer entspricht nicht den Anforderungen.
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. Verweis auf 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 dd_bootstrapper, dd_client und dd_setup beginnen.

Support oder Problembehandlung

Manchmal kann etwas schiefgehen. Wenn es bei der Installation von Visual Studio zu einem Fehler kommt, finden Sie ausführliche Informationen im Artikel Problembehandlung bei der Visual Studio-Installation und bei Upgradefehlern.

Hier sind einige weitere Supportoptionen:

• Für installationsbezogene Probleme wird eine Livechat-Supportoption angeboten (nur auf Englisch).
• Sie können uns über Produktprobleme mit dem Tool Problem melden informieren, das sowohl im Visual Studio-Installer als auch in der Visual Studio-IDE angezeigt wird. Wenn Sie IT-Administrator*in sind und noch kein Visual Studio haben, können Sie hier Feedback zu IT-Administratoren senden.
• Schlagen Sie ein Feature vor, verfolgen Sie Produktprobleme nach, und finden Sie Antworten in der Visual Studio-Entwicklercommunity.

Siehe auch

• Beispiele für Befehlszeilenparameter für die Installation von Visual Studio
• Erstellen einer Offlineinstallation von Visual Studio
• Automatisieren der Visual Studio-Installation mit einer Antwortdatei
• Arbeitsauslastung und Komponenten-IDs von Visual Studio